Class ChatThreadManager

constructor

• new ChatThreadManager(): ChatThreadManager

  Returns ChatThreadManager

Static Readonlykey

Readonlycapabilities

bind

• bind(
      client: ChatClient,
      context?: ManagerEventContext<
          Partial<
              {
                  onConnecting: (payload: ConnectionEventPayload) => {};
                  onConnected: (payload: ConnectionEventPayload) => {};
                  onDisconnected: (payload: ConnectionEventPayload) => {};
                  onReconnectFailed: (payload: ConnectionEventPayload) => {};
                  onTokenWillExpire: (payload: undefined) => {};
                  onTokenExpired: (payload: undefined) => {};
                  onOfflineMessageSyncStart: (payload: undefined) => {};
                  onOfflineMessageSyncFinish: (payload: undefined) => {};
                  onMessage: (payload: Message) => {};
                  onStreamMessage: (payload: StreamMessage) => {};
                  onConversationListUpdate: (payload: ConversationListUpdatePayload) => {};
                  onMessageReadReceipts: (
                      payload: readonly MessageReceiptEventPayload[],
                  ) => {};
                  onMessageDelivered: (payload: MessageDeliveredEventPayload) => {};
                  onMessageRecalled: (payload: MessageRecalledEventPayload) => {};
                  onMessageUpdated: (payload: MessageUpdatedEventPayload) => {};
                  onReactionChanged: (payload: ReactionChangedEventPayload) => {};
                  onPinnedMessageChanged: (
                      payload: PinnedMessageChangedEventPayload,
                  ) => {};
                  onMultiDeviceContact: (payload: MultiDeviceContactEvent) => {};
                  onMultiDeviceGroup: (payload: MultiDeviceGroupEvent) => {};
                  onMultiDeviceThread: (payload: MultiDeviceThreadEvent) => {};
                  onMultiDeviceConversation: (payload: MultiDeviceConversationEvent) => {};
                  onMultiDeviceMessageRemoved: (
                      payload: MultiDeviceMessageRemovedEvent,
                  ) => {};
                  onSyncDataStart: (payload: SyncDataStartPayload) => {};
                  onSyncDataFinished: (payload: SyncDataFinishedPayload) => {};
                  onChatThreadCreated: (payload: ChatThreadCreatedEventPayload) => {};
                  onChatThreadDestroyed: (payload: ChatThreadBaseEventPayload) => {};
                  onChatThreadUpdated: (payload: ChatThreadUpdatedEventPayload) => {};
                  onChatThreadUserRemoved: (
                      payload: ChatThreadUserRemovedEventPayload,
                  ) => {};
                  onSendTimeout: (payload: SendTimeoutEventPayload) => {};
                  onGroupNotify: (payload: GroupRawNotifyEvent) => {};
                  onChatRoomNotify: (payload: ChatRoomRawNotifyEvent) => {};
                  onChatThreadNotify: (payload: ChatThreadRawNotifyEvent) => {};
                  onUserInfoNotify: (payload: UserInfoRawNotifyEvent) => {};
                  "__internal:onMessageSent": (payload: Message) => {};
                  onPresenceStatusChange: (payload: readonly PresenceState[]) => {};
                  onContactInvited: (payload: ContactRosterEventPayload) => {};
                  onContactDeleted: (payload: ContactRosterEventPayload) => {};
                  onContactAdded: (payload: ContactRosterEventPayload) => {};
                  onContactRefuse: (payload: ContactRosterEventPayload) => {};
                  onContactAgreed: (payload: ContactRosterEventPayload) => {};
                  onContactInfoUpdated: (payload: ContactInfoUpdatedEvent) => {};
                  onOwnInfoUpdated: (payload: UserInfo) => {};
                  onUserInfoUpdated: (payload: readonly UserInfo[]) => {};
                  onInvitationReceived: (
                      payload: GroupInvitationReceivedEventPayload,
                  ) => {};
                  onRequestToJoinReceived: (
                      payload: GroupRequestToJoinReceivedEventPayload,
                  ) => {};
                  onRequestToJoinAccepted: (
                      payload: GroupRequestToJoinAcceptedEventPayload,
                  ) => {};
                  onRequestToJoinDeclined: (
                      payload: GroupRequestToJoinDeclinedEventPayload,
                  ) => {};
                  onInvitationAccepted: (
                      payload: GroupInvitationAcceptedEventPayload,
                  ) => {};
                  onInvitationDeclined: (
                      payload: GroupInvitationDeclinedEventPayload,
                  ) => {};
                  onUserRemoved: (payload: GroupUserRemovedEventPayload) => {};
                  onGroupDestroyed: (payload: GroupDestroyedEventPayload) => {};
                  onAutoAcceptInvitationFromGroup: (
                      payload: GroupAutoAcceptInvitationEventPayload,
                  ) => {};
                  onMuteListAdded: (payload: GroupMuteListAddedEventPayload) => {};
                  onMuteListRemoved: (payload: GroupMuteListRemovedEventPayload) => {};
                  onAllowListAdded: (payload: GroupAllowListAddedEventPayload) => {};
                  onAllowListRemoved: (payload: GroupAllowListRemovedEventPayload) => {};
                  onAllMemberMuteStateChanged: (
                      payload: GroupAllMemberMuteStateChangedEventPayload,
                  ) => {};
                  onAdminAdded: (payload: GroupAdminAddedEventPayload) => {};
                  onAdminRemoved: (payload: GroupAdminRemovedEventPayload) => {};
                  onOwnerChanged: (payload: GroupOwnerChangedEventPayload) => {};
                  onMembersJoined: (payload: GroupMembersJoinedEventPayload) => {};
                  onMembersExited: (payload: GroupMembersExitedEventPayload) => {};
                  onAnnouncementChanged: (
                      payload: GroupAnnouncementChangedEventPayload,
                  ) => {};
                  onSharedFileAdded: (payload: GroupSharedFileAddedEventPayload) => {};
                  onSharedFileDeleted: (payload: GroupSharedFileDeletedEventPayload) => {};
                  onGroupInfoChanged: (payload: GroupInfoChangedEventPayload) => {};
                  onGroupDisabledChanged: (
                      payload: GroupDisabledChangedEventPayload,
                  ) => {};
                  onGroupMemberAttributeChanged: (
                      payload: GroupMemberAttributeChangedEventPayload,
                  ) => {};
                  onUserGroupNamecardUpdated: (
                      payload: GroupUserGroupNamecardUpdatedEventPayload,
                  ) => {};
                  "__chatroom:onChatRoomDestroyed": (
                      payload: ChatRoomDestroyedEventPayload,
                  ) => {};
                  "__chatroom:onMembersJoined": (
                      payload: ChatRoomMembersJoinedEventPayload,
                  ) => {};
                  "__chatroom:onMembersExited": (
                      payload: ChatRoomMembersExitedEventPayload,
                  ) => {};
                  "__chatroom:onRemovedFromChatRoom": (
                      payload: ChatRoomRemovedFromChatRoomEventPayload,
                  ) => {};
                  "__chatroom:onMuteListAdded": (
                      payload: ChatRoomMuteListAddedEventPayload,
                  ) => {};
                  "__chatroom:onMuteListRemoved": (
                      payload: ChatRoomMuteListRemovedEventPayload,
                  ) => {};
                  "__chatroom:onAllowListAdded": (
                      payload: ChatRoomAllowListAddedEventPayload,
                  ) => {};
                  "__chatroom:onAllowListRemoved": (
                      payload: ChatRoomAllowListRemovedEventPayload,
                  ) => {};
                  "__chatroom:onAllMemberMuteStateChanged": (
                      payload: ChatRoomAllMemberMuteStateChangedEventPayload,
                  ) => {};
                  "__chatroom:onAdminAdded": (
                      payload: ChatRoomAdminAddedEventPayload,
                  ) => {};
                  "__chatroom:onAdminRemoved": (
                      payload: ChatRoomAdminRemovedEventPayload,
                  ) => {};
                  "__chatroom:onOwnerChanged": (
                      payload: ChatRoomOwnerChangedEventPayload,
                  ) => {};
                  "__chatroom:onAnnouncementChanged": (
                      payload: ChatRoomAnnouncementChangedEventPayload,
                  ) => {};
                  "__chatroom:onChatRoomInfoChanged": (
                      payload: ChatRoomInfoChangedEventPayload,
                  ) => {};
                  "__chatroom:onAttributesUpdate": (
                      payload: ChatRoomAttributesUpdateEventPayload,
                  ) => {};
                  "__chatroom:onAttributesRemoved": (
                      payload: ChatRoomAttributesRemovedEventPayload,
                  ) => {};
              },
          >,
      >,
  ): void

  [zh-CN] 将管理器绑定到客户端。 [en-US] Binds the manager to a client.

  Parameters

  • client: ChatClient
  • Optionalcontext: ManagerEventContext<
        Partial<
            {
                onConnecting: (payload: ConnectionEventPayload) => {};
                onConnected: (payload: ConnectionEventPayload) => {};
                onDisconnected: (payload: ConnectionEventPayload) => {};
                onReconnectFailed: (payload: ConnectionEventPayload) => {};
                onTokenWillExpire: (payload: undefined) => {};
                onTokenExpired: (payload: undefined) => {};
                onOfflineMessageSyncStart: (payload: undefined) => {};
                onOfflineMessageSyncFinish: (payload: undefined) => {};
                onMessage: (payload: Message) => {};
                onStreamMessage: (payload: StreamMessage) => {};
                onConversationListUpdate: (payload: ConversationListUpdatePayload) => {};
                onMessageReadReceipts: (
                    payload: readonly MessageReceiptEventPayload[],
                ) => {};
                onMessageDelivered: (payload: MessageDeliveredEventPayload) => {};
                onMessageRecalled: (payload: MessageRecalledEventPayload) => {};
                onMessageUpdated: (payload: MessageUpdatedEventPayload) => {};
                onReactionChanged: (payload: ReactionChangedEventPayload) => {};
                onPinnedMessageChanged: (payload: PinnedMessageChangedEventPayload) => {};
                onMultiDeviceContact: (payload: MultiDeviceContactEvent) => {};
                onMultiDeviceGroup: (payload: MultiDeviceGroupEvent) => {};
                onMultiDeviceThread: (payload: MultiDeviceThreadEvent) => {};
                onMultiDeviceConversation: (payload: MultiDeviceConversationEvent) => {};
                onMultiDeviceMessageRemoved: (
                    payload: MultiDeviceMessageRemovedEvent,
                ) => {};
                onSyncDataStart: (payload: SyncDataStartPayload) => {};
                onSyncDataFinished: (payload: SyncDataFinishedPayload) => {};
                onChatThreadCreated: (payload: ChatThreadCreatedEventPayload) => {};
                onChatThreadDestroyed: (payload: ChatThreadBaseEventPayload) => {};
                onChatThreadUpdated: (payload: ChatThreadUpdatedEventPayload) => {};
                onChatThreadUserRemoved: (
                    payload: ChatThreadUserRemovedEventPayload,
                ) => {};
                onSendTimeout: (payload: SendTimeoutEventPayload) => {};
                onGroupNotify: (payload: GroupRawNotifyEvent) => {};
                onChatRoomNotify: (payload: ChatRoomRawNotifyEvent) => {};
                onChatThreadNotify: (payload: ChatThreadRawNotifyEvent) => {};
                onUserInfoNotify: (payload: UserInfoRawNotifyEvent) => {};
                "__internal:onMessageSent": (payload: Message) => {};
                onPresenceStatusChange: (payload: readonly PresenceState[]) => {};
                onContactInvited: (payload: ContactRosterEventPayload) => {};
                onContactDeleted: (payload: ContactRosterEventPayload) => {};
                onContactAdded: (payload: ContactRosterEventPayload) => {};
                onContactRefuse: (payload: ContactRosterEventPayload) => {};
                onContactAgreed: (payload: ContactRosterEventPayload) => {};
                onContactInfoUpdated: (payload: ContactInfoUpdatedEvent) => {};
                onOwnInfoUpdated: (payload: UserInfo) => {};
                onUserInfoUpdated: (payload: readonly UserInfo[]) => {};
                onInvitationReceived: (
                    payload: GroupInvitationReceivedEventPayload,
                ) => {};
                onRequestToJoinReceived: (
                    payload: GroupRequestToJoinReceivedEventPayload,
                ) => {};
                onRequestToJoinAccepted: (
                    payload: GroupRequestToJoinAcceptedEventPayload,
                ) => {};
                onRequestToJoinDeclined: (
                    payload: GroupRequestToJoinDeclinedEventPayload,
                ) => {};
                onInvitationAccepted: (
                    payload: GroupInvitationAcceptedEventPayload,
                ) => {};
                onInvitationDeclined: (
                    payload: GroupInvitationDeclinedEventPayload,
                ) => {};
                onUserRemoved: (payload: GroupUserRemovedEventPayload) => {};
                onGroupDestroyed: (payload: GroupDestroyedEventPayload) => {};
                onAutoAcceptInvitationFromGroup: (
                    payload: GroupAutoAcceptInvitationEventPayload,
                ) => {};
                onMuteListAdded: (payload: GroupMuteListAddedEventPayload) => {};
                onMuteListRemoved: (payload: GroupMuteListRemovedEventPayload) => {};
                onAllowListAdded: (payload: GroupAllowListAddedEventPayload) => {};
                onAllowListRemoved: (payload: GroupAllowListRemovedEventPayload) => {};
                onAllMemberMuteStateChanged: (
                    payload: GroupAllMemberMuteStateChangedEventPayload,
                ) => {};
                onAdminAdded: (payload: GroupAdminAddedEventPayload) => {};
                onAdminRemoved: (payload: GroupAdminRemovedEventPayload) => {};
                onOwnerChanged: (payload: GroupOwnerChangedEventPayload) => {};
                onMembersJoined: (payload: GroupMembersJoinedEventPayload) => {};
                onMembersExited: (payload: GroupMembersExitedEventPayload) => {};
                onAnnouncementChanged: (
                    payload: GroupAnnouncementChangedEventPayload,
                ) => {};
                onSharedFileAdded: (payload: GroupSharedFileAddedEventPayload) => {};
                onSharedFileDeleted: (payload: GroupSharedFileDeletedEventPayload) => {};
                onGroupInfoChanged: (payload: GroupInfoChangedEventPayload) => {};
                onGroupDisabledChanged: (payload: GroupDisabledChangedEventPayload) => {};
                onGroupMemberAttributeChanged: (
                    payload: GroupMemberAttributeChangedEventPayload,
                ) => {};
                onUserGroupNamecardUpdated: (
                    payload: GroupUserGroupNamecardUpdatedEventPayload,
                ) => {};
                "__chatroom:onChatRoomDestroyed": (
                    payload: ChatRoomDestroyedEventPayload,
                ) => {};
                "__chatroom:onMembersJoined": (
                    payload: ChatRoomMembersJoinedEventPayload,
                ) => {};
                "__chatroom:onMembersExited": (
                    payload: ChatRoomMembersExitedEventPayload,
                ) => {};
                "__chatroom:onRemovedFromChatRoom": (
                    payload: ChatRoomRemovedFromChatRoomEventPayload,
                ) => {};
                "__chatroom:onMuteListAdded": (
                    payload: ChatRoomMuteListAddedEventPayload,
                ) => {};
                "__chatroom:onMuteListRemoved": (
                    payload: ChatRoomMuteListRemovedEventPayload,
                ) => {};
                "__chatroom:onAllowListAdded": (
                    payload: ChatRoomAllowListAddedEventPayload,
                ) => {};
                "__chatroom:onAllowListRemoved": (
                    payload: ChatRoomAllowListRemovedEventPayload,
                ) => {};
                "__chatroom:onAllMemberMuteStateChanged": (
                    payload: ChatRoomAllMemberMuteStateChangedEventPayload,
                ) => {};
                "__chatroom:onAdminAdded": (
                    payload: ChatRoomAdminAddedEventPayload,
                ) => {};
                "__chatroom:onAdminRemoved": (
                    payload: ChatRoomAdminRemovedEventPayload,
                ) => {};
                "__chatroom:onOwnerChanged": (
                    payload: ChatRoomOwnerChangedEventPayload,
                ) => {};
                "__chatroom:onAnnouncementChanged": (
                    payload: ChatRoomAnnouncementChangedEventPayload,
                ) => {};
                "__chatroom:onChatRoomInfoChanged": (
                    payload: ChatRoomInfoChangedEventPayload,
                ) => {};
                "__chatroom:onAttributesUpdate": (
                    payload: ChatRoomAttributesUpdateEventPayload,
                ) => {};
                "__chatroom:onAttributesRemoved": (
                    payload: ChatRoomAttributesRemovedEventPayload,
                ) => {};
            },
        >,
    >

  Returns void

addEventHandler

• addEventHandler(id: string, handlers: ChatThreadEventHandlerMap): void

  注册 ChatThread 事件处理器。只包含移动端对齐的 4 个公开事件，不包含 onChatThreadChange。

  Parameters

  • id: string

    事件处理器 ID。使用相同 ID 重复注册时，会覆盖此前的处理器。
  • handlers: ChatThreadEventHandlerMap

    消息话题事件处理器映射。

  Returns void

  无返回值。

  Example: 调用示例（监听消息话题创建）

  client.chatThreadManager.addEventHandler('thread-ui', {
    onChatThreadCreated: event => {
      console.log(event.chatThreadId);
    },
  });
  Copy

removeEventHandler

• removeEventHandler(id: string): void

  移除指定的消息话题事件处理器。

  Parameters

  • id: string

    要移除的事件处理器 ID。

  Returns void

  无返回值。

  Example: 调用示例（取消监听）

  client.chatThreadManager.removeEventHandler('thread-ui');
  Copy

getChatThread

• getChatThread(chatThreadId: string): ChatThread

  获取绑定指定 chatThreadId 的 ChatThread 实体对象。

  Parameters

  • chatThreadId: string

    消息话题 ID。

  Returns ChatThread

  返回可复用的 ChatThread 实体对象。

  Example: 调用示例（获取实体对象）

  const thread = client.chatThreadManager.getChatThread('thread-1');
  const detail = await thread.getInfo();
  Copy

createChatThread

• createChatThread(
      params: CreateChatThreadParams,
  ): Promise<CreateChatThreadResult>

  创建消息话题。

  Parameters

  • params: CreateChatThreadParams

    创建参数，包含父群组 ID、消息话题名称和父消息 ID。

  Returns Promise<CreateChatThreadResult>

  返回新建消息话题 ID。

  Example: 调用示例（创建消息话题）

  const result = await client.chatThreadManager.createChatThread({
    parentId: 'group-1',
    name: 'Topic',
    messageId: 'msg-1',
  });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的父群组 ID、子区名称和父消息 ID	否
  201	用户未登录	401	重新登录后再创建子区	否
  210	无权限创建子区	403	确认当前用户已加入父群组，并检查控制台 Thread 能力开通状态	否
  606	群组或父消息不存在	404	确认父群组和父消息仍存在后重试	否
  4	超过服务限制	400	减少创建频率，清理不需要的子区，或联系服务端提升配额	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

getChatThreadList

• getChatThreadList(
      params: GetChatThreadListParams,
  ): Promise<ChatThreadListResult>

  查询指定群组下的消息话题列表。

  Parameters

  • params: GetChatThreadListParams

    查询参数，包含父群组 ID、分页大小和游标。

  Returns Promise<ChatThreadListResult>

  返回消息话题列表和下一页游标。

  Example: 调用示例（查询群内消息话题）

  const page = await client.chatThreadManager.getChatThreadList({
    parentId: 'group-1',
    pageSize: 20,
  });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的父群组 ID、分页大小和游标	否
  201	用户未登录	401	重新登录后再查询子区列表	否
  210	无权限查询子区列表	403	确认当前用户已加入父群组	否
  606	群组不存在	404	确认父群组 ID 正确且群组仍存在	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

getJoinedChatThreadList

• getJoinedChatThreadList(
      params?: GetJoinedChatThreadListParams,
  ): Promise<ChatThreadListResult>

  查询当前用户已加入的消息话题列表。

  Parameters

  • params: GetJoinedChatThreadListParams = {}

    查询参数；parentId 可选。

  Returns Promise<ChatThreadListResult>

  返回已加入消息话题列表和下一页游标。

  Example: 调用示例（查询已加入消息话题）

  const page = await client.chatThreadManager.getJoinedChatThreadList({
    parentId: 'group-1',
  });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的分页参数；如指定 parentId，应传入非空字符串	否
  201	用户未登录	401	重新登录后再查询已加入子区	否
  210	无权限查询已加入子区	403	确认当前用户已加入目标群组	否
  606	群组不存在	404	确认父群组 ID 正确且群组仍存在	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

getChatThreadInfo

• getChatThreadInfo(params: GetChatThreadInfoParams): Promise<ChatThreadSummary>

  查询消息话题详情。

  Parameters

  • params: GetChatThreadInfoParams

    查询参数，包含消息话题 ID。

  Returns Promise<ChatThreadSummary>

  返回消息话题详情。

  Example: 调用示例（查询详情）

  const detail = await client.chatThreadManager.getChatThreadInfo({
    chatThreadId: 'thread-1',s
  });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的子区 ID	否
  201	用户未登录	401	重新登录后再查询子区详情	否
  210	无权限查询子区详情	403	确认当前用户已加入父群组或目标子区	否
  606	子区不存在	404	确认子区 ID 正确且子区仍存在	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

joinChatThread

• joinChatThread(params: ChatThreadMutationTarget): Promise<void>

  加入消息话题。

  Parameters

  • params: ChatThreadMutationTarget

    操作目标，包含消息话题 ID。

  Returns Promise<void>

  成功时无返回业务数据。

  Example: 调用示例（加入消息话题）

  await client.chatThreadManager.joinChatThread({ chatThreadId: 'thread-1' });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的子区 ID	否
  201	用户未登录	401	重新登录后再加入子区	否
  210	无权限加入子区	403	确认当前用户已加入父群组且目标子区可加入	否
  606	子区不存在	404	确认子区 ID 正确且子区仍存在	否
  4	超过服务限制	400	减少操作频率或联系服务端提升配额	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

leaveChatThread

• leaveChatThread(params: ChatThreadMutationTarget): Promise<void>

  退出消息话题。

  Parameters

  • params: ChatThreadMutationTarget

    操作目标，包含消息话题 ID。

  Returns Promise<void>

  成功时无返回业务数据。

  Example: 调用示例（退出消息话题）

  await client.chatThreadManager.leaveChatThread({ chatThreadId: 'thread-1' });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的子区 ID	否
  201	用户未登录	401	重新登录后再退出子区	否
  210	无权限退出子区	403	确认当前用户已加入目标子区且允许退出	否
  606	子区不存在	404	确认子区 ID 正确且子区仍存在	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

destroyChatThread

• destroyChatThread(params: ChatThreadMutationTarget): Promise<void>

  解散消息话题。

  Parameters

  • params: ChatThreadMutationTarget

    操作目标，包含消息话题 ID。

  Returns Promise<void>

  成功时无返回业务数据。

  Example: 调用示例（解散消息话题）

  await client.chatThreadManager.destroyChatThread({ chatThreadId: 'thread-1' });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的子区 ID	否
  201	用户未登录	401	重新登录后再解散子区	否
  210	无权限解散子区	403	使用有管理权限的账号重试	否
  606	子区不存在	404	确认子区 ID 正确且子区仍存在	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

updateChatThreadName

• updateChatThreadName(params: UpdateChatThreadNameParams): Promise<void>

  更新消息话题名称。

  Parameters

  • params: UpdateChatThreadNameParams

    更新参数，包含消息话题 ID 和新名称。

  Returns Promise<void>

  成功时无返回业务数据。

  Example: 调用示例（更新名称）

  await client.chatThreadManager.updateChatThreadName({
    chatThreadId: 'thread-1',
    name: 'New topic',
  });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的子区 ID 和新名称	否
  201	用户未登录	401	重新登录后再更新子区名称	否
  210	无权限更新子区名称	403	使用群主、管理员或有权限的账号重试	否
  606	子区不存在	404	确认子区 ID 正确且子区仍存在	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

getChatThreadMemberList

• getChatThreadMemberList(
      params: GetChatThreadMemberListParams,
  ): Promise<ChatThreadMemberListResult>

  查询消息话题成员列表。

  Parameters

  • params: GetChatThreadMemberListParams

    查询参数，包含消息话题 ID、分页大小和游标。

  Returns Promise<ChatThreadMemberListResult>

  返回成员列表和下一页游标。

  Example: 调用示例（查询成员）

  const page = await client.chatThreadManager.getChatThreadMemberList({
    chatThreadId: 'thread-1',
    pageSize: 20,
  });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的子区 ID、分页大小和游标	否
  201	用户未登录	401	重新登录后再查询子区成员	否
  210	无权限查询子区成员	403	确认当前用户已加入父群组或目标子区	否
  606	子区不存在	404	确认子区 ID 正确且子区仍存在	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

removeChatThreadMember

• removeChatThreadMember(params: RemoveChatThreadMemberParams): Promise<void>

  从消息话题移除成员。

  Parameters

  • params: RemoveChatThreadMemberParams

    移除参数，包含消息话题 ID 和成员 ID。

  Returns Promise<void>

  成功时无返回业务数据。

  Example: 调用示例（移除成员）

  await client.chatThreadManager.removeChatThreadMember({
    chatThreadId: 'thread-1',
    memberId: 'user-1',
  });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入有效的子区 ID 和成员 ID	否
  201	用户未登录	401	重新登录后再移除子区成员	否
  210	无权限移除子区成员	403	使用群主、管理员或有权限的账号重试	否
  606	子区或成员不存在	404	确认子区和目标成员关系仍存在	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是

getChatThreadLastMessageList

• getChatThreadLastMessageList(
      params: GetChatThreadLastMessageListParams,
  ): Promise<ChatThreadLastMessageListResult>

  批量查询消息话题最后一条消息。

  Parameters

  • params: GetChatThreadLastMessageListParams

    查询参数，包含最多 20 个消息话题 ID。

  Returns Promise<ChatThreadLastMessageListResult>

  返回各消息话题的最后一条消息摘要。

  Example: 调用示例（查询最后消息）

  const result = await client.chatThreadManager.getChatThreadLastMessageList({
    chatThreadIds: ['thread-1', 'thread-2'],
  });
  Copy

  可能出现的错误码

  Code	含义	HTTP	处理建议	可重试
  110	参数无效	-	传入 1 到 20 个有效的子区 ID	否
  201	用户未登录	401	重新登录后再查询子区最后消息	否
  210	无权限查询子区最后消息	403	确认当前用户有权限访问传入的所有子区	否
  606	子区不存在	404	确认子区 ID 正确且子区仍存在	否
  301	请求服务超时	504	稍后重试	是
  303	服务请求通用错误	500	稍后重试或联系服务端排查	是