diff --git a/docs/.vuepress/public/images/product/enable_and_configure/message_rest_conversation.png b/docs/.vuepress/public/images/product/enable_and_configure/message_rest_conversation.png new file mode 100644 index 000000000..1d6ebd0cf Binary files /dev/null and b/docs/.vuepress/public/images/product/enable_and_configure/message_rest_conversation.png differ diff --git a/docs/document/android/conversation_list.md b/docs/document/android/conversation_list.md index bf8118333..394541ef8 100644 --- a/docs/document/android/conversation_list.md +++ b/docs/document/android/conversation_list.md @@ -31,7 +31,7 @@ :::tip 1. **若使用该功能，需在环信控制台开通，并将 SDK 升级至 4.0.3。而且，只有开通该功能，你才能使用置顶会话和会话标记功能。** 2. 建议你在首次下载、卸载后重装应用等本地数据库无数据情况下拉取服务端会话列表。其他情况下，调用 `asyncFilterConversationsFromDB`、`getAllConversationsBySort` 或 `getAllConversations` 方法获取本地所有会话即可。 -3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需联系商务。 +3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。 ::: 示例代码如下： diff --git a/docs/document/flutter/conversation_list.md b/docs/document/flutter/conversation_list.md index 8e3c698b6..e3f1d5dfb 100644 --- a/docs/document/flutter/conversation_list.md +++ b/docs/document/flutter/conversation_list.md @@ -29,7 +29,7 @@ :::tip 1. **若使用该功能，需在环信控制台开通该功能，并将 SDK 升级至 V4.5.0 或以上版本。只有开通该功能，你才能使用置顶会话功能。** 2. 建议在 app 安装时或本地没有会话时调用该方法，否则调用 `loadAllConversations` 获取本地会话即可。 -3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需联系商务。 +3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。 ::: 示例代码如下： diff --git a/docs/document/harmonyos/conversation_list.md b/docs/document/harmonyos/conversation_list.md index c808228ea..578c3eab6 100644 --- a/docs/document/harmonyos/conversation_list.md +++ b/docs/document/harmonyos/conversation_list.md @@ -29,7 +29,7 @@ :::tip 1. **若使用该功能，需在环信控制台开通。** 2. 建议你在首次下载、卸载后重装应用等本地数据库无数据情况下拉取服务端会话列表。其他情况下，调用 `getAllConversationsBySort`、`getConversations` 方法获取本地所有会话即可。 -3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需联系商务。 +3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。 ::: 示例代码如下： diff --git a/docs/document/ios/conversation_list.md b/docs/document/ios/conversation_list.md index d8110c644..8c72c7934 100644 --- a/docs/document/ios/conversation_list.md +++ b/docs/document/ios/conversation_list.md @@ -31,7 +31,7 @@ :::tip 1. **若使用该功能，需在环信控制台开通该功能，并将 SDK 升级至 4.0.3。只有开通该功能，你才能使用置顶会话和会话标记功能。** 2. 建议你在首次下载、卸载后重装应用等本地数据库无数据情况下拉取服务端会话列表。其他情况下，调用 `filterConversationsFromDB`、`getAllConversations:` 或 `getAllConversations` 方法获取本地所有会话即可。 -3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需联系商务。 +3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。 ::: 示例代码如下： diff --git a/docs/document/react-native/conversation_list.md b/docs/document/react-native/conversation_list.md index d53e7daae..f3ffdec45 100644 --- a/docs/document/react-native/conversation_list.md +++ b/docs/document/react-native/conversation_list.md @@ -29,7 +29,7 @@ :::tip 1. **若使用该功能，需在环信控制台开通，并将 SDK 升级至 1.2.0 或以上版本。而且，只有开通该功能，你才能使用置顶会话功能。** 2. 建议你在首次下载、卸载后重装应用等本地数据库无数据情况下拉取服务端会话列表。其他情况下，调用 `getAllConversations` 方法获取本地所有会话即可。 -3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需联系商务。 +3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。 ::: 示例代码如下： diff --git a/docs/document/unity/conversation_list.md b/docs/document/unity/conversation_list.md index 350db3873..be2b1f02c 100644 --- a/docs/document/unity/conversation_list.md +++ b/docs/document/unity/conversation_list.md @@ -32,7 +32,7 @@ :::tip 1. 若使用该方法，需将 SDK 升级至 V1.2.0 或以上版本。 2. 建议你在首次下载、卸载后重装应用等本地数据库无数据情况下拉取服务端会话列表。其他情况下，调用 `LoadAllConversations` 方法获取本地所有会话即可。 -3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需联系商务。 +3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。 ::: ```csharp diff --git a/docs/document/web/conversation_list.md b/docs/document/web/conversation_list.md index abdd2eb33..b9d29210c 100644 --- a/docs/document/web/conversation_list.md +++ b/docs/document/web/conversation_list.md @@ -29,7 +29,7 @@ 1. **若使用该功能，需在环信控制台开通，并将 SDK 升级至 4.1.7 或以上版本。而且，只有开通该功能，你才能使用置顶会话和会话标记功能。** 2. 登录用户的 ID 大小写混用会导致拉取会话列表时提示会话列表为空，因此建议用户 ID 使用小写字母。 3. 服务端会话列表的更新存在延时，建议你仅在登录时调用该方法。 -4. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需联系商务。 +4. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。 ::: 示例代码如下： diff --git a/docs/document/windows/conversation_list.md b/docs/document/windows/conversation_list.md index d29d21bcb..8fcc6c763 100644 --- a/docs/document/windows/conversation_list.md +++ b/docs/document/windows/conversation_list.md @@ -32,7 +32,7 @@ :::tip 1. 若使用该方法，需将 SDK 升级至 1.2.0 或以上版本。 2. 建议你在首次下载、卸载后重装应用等本地数据库无数据情况下拉取服务端会话列表。其他情况下，调用 `LoadAllConversations` 方法获取本地所有会话即可。 -3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需联系商务。 +3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。 ::: ```csharp diff --git a/docs/product/enable_and_configure_IM.md b/docs/product/enable_and_configure_IM.md index 65429894c..6b8bbeb07 100644 --- a/docs/product/enable_and_configure_IM.md +++ b/docs/product/enable_and_configure_IM.md @@ -109,6 +109,14 @@ ![img](/images/product/message/message_receipt.png) +## 设置通过 RESTful API 发送的消息写入会话列表 + +通过 RESTful 接口发送的消息默认不写入会话列表，若需要此类消息写入会话列表，需要开通。 + +在环信即时通讯云的左侧导航栏中，选择 **即时通讯** > **功能配置** > **功能配置总览**。在 **功能配置总览** 页面的 **基础功能** 页签下，搜索找到**rest发消息写会话列表**，然后点击**设置**。 + +![img](/images/product/enable_and_configure/message_rest_conversation.png) + ## 配置推送证书 使用离线推送通知之前，需完成各平台的证书配置。当前支持以下平台：苹果 APNs、谷歌 FCM、华为、小米、OPPO、VIVO 和魅族。