用户加入会议回调

回调接口id

104（service_id = 104）

说明

1. 此接口由接入方提供，众趣方通过开放平台调用。
2. 当用户成功加入 TIM 群组且会议室内存在进行中的会议时，众趣带看服务通过开放平台向客户推送该用户的加入事件。
3. 接口验证规则请参考 回调接口规则说明。

触发时机

腾讯 TIM 服务端回调通知用户入群成功，且对应会议室内存在「进行中」的会议时，触发本回调。

接口提供

https://customer.com/test/api/user_joined/?app_id=xxx&app_secret=yyy

入参示例：

请求方法：POST，Content-Type: application/json;charset=utf-8

{
    "project_id": "ID00001",
    "roomId": 10000123,
    "meetingId": 20000456,
    "joinTime": "2026-05-12T12:34:56+08:00",
    "user": "1448291745301000000",
    "isFirstOne": true,
    "meetingStatus": 1
}

入参参数说明：

参数名	数据类型	是否必传	参数说明
project_id	string	是	项目 id（房源 id）。无项目上下文时可能为空字符串
roomId	int	是	会议室 ID
meetingId	int	是	会议 ID
joinTime	string	是	用户加入时间，ISO8601 格式
user	string	是	加入会议的用户 ID
isFirstOne	bool	是	该用户是否为本场会议的首位加入者
meetingStatus	int	是	会议状态：0=未开始、1=进行中、2=已结束（以众趣枚举为准）

URL 上的 app_id、timestamp、sign、callback_id 含义见 回调接口规则说明。

返回参数示例：

{
    "code": 1,
    "msg": "success"
}

备注

• 同一场会议内可能多次触发本回调（每位用户加入各推送一次）。
• 同一场会议在「未离开人数首次大于 1」时会额外触发 带看会议开始回调（service_id=106），每场会议仅推送一次。
• 客户侧需对 callback_id 做幂等处理。