一、功能描述
注意：置顶会话数上限 50，不支持增加。
二、置顶与取消置顶会话
接口
chat.pinConversation(options);
参数 options 为 Object 类型，包含的属性值如下：
参数
| 参数 | 类型 | 说明 |
| conversationID | String | 会话 ID。会话 ID 组成方式：C2C${userID}（单聊）GROUP{groupID}（群聊） |
| isPinned | Boolean | true 表示置顶会话，false 表示取消置顶会话 |
返回值
Promise
示例
let promise = chat.pinConversation({ conversationID: 'C2CExample', isPinned: true });promise.then(function(imResponse) { // 置顶会话成功 const { conversationID } = imResponse.data; // 被置顶的会话 ID}).catch(function(imError) { const { code } = imError; // code – 50002 会话 ID 无效 console.warn('pinConversation error:', imError); // 置顶会话失败的相关信息});
let promise = chat.pinConversation({ conversationID: 'C2CExample', isPinned: false });promise.then(function(imResponse) { // 取消置顶会话成功 const { conversationID } = imResponse.data; // 被取消置顶的会话 ID}).catch(function(imError) { console.warn('pinConversation error:', imError); // 取消置顶会话失败的相关信息});