派单回调

回调接口id

101（service_id = 101）

说明

1. 此接口由接入方提供，众趣方在用户发起带看会议时通过开放平台回调此接口，通知客户服务器进行派单操作。
2. 客户接到回调后，可结合自身业务（如经纪人在线状态、接单规则等）自行决定将本次带看推送给哪些经纪人，并通过 IM/推送等方式拨打给指定经纪人。
3. 接口验证规则请参考 回调接口规则说明。
4. 派单仅在「呼叫模式」下触发；「分享模式」不会调用本接口。

触发时机

业务侧调用众趣 POST .../takelook/tencent/dispatch/ 或 POST .../takelook/tencent/start/ 并指明需要派单时，开放平台会异步向客户推送本回调（与单次 HTTP 响应分离）。

接口提供

接入方需要提供此接口地址，参照如下规则给到众趣方：

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

入参示例：

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

URL 上拼接校验参数：

https://customer_host.com/api/dispatch/?app_id=1345&timestamp=1532059200000&sign=edb7a6c92c4284fb7e825d63e7258b95&callback_id=877602611346546688

请求体：

{
    "packageId": "ID00001",
    "userId": "1448291745301000000",
    "roomId": "10000123",
    "ext": "{\"responseUserId\":\"1448176777690000000\"}"
}

入参参数说明：

参数名	数据类型	是否必传	参数说明
packageId	string	是	数据包 id（即众趣项目/房源 id，对应 project_id）
userId	string	是	发起带看的用户 ID
roomId	string	是	会议室 ID（众趣自动生成，后续 SDK 接受带看需要的房间号）
ext	string	否	客户自定义扩展字段，JSON 字符串，业务侧自行反序列化。例如客户在发起带看时指定接收方 userId，可约定 {"responseUserId":"someUserId"}

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

返回参数示例：

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

返回参数说明：

字段名	数据类型	是否必传	参数说明
code	int	是	1 表示接收派单成功；其余值视为失败
msg	string	否	描述信息

接入方也可以使用 Content-Type: text/plain;charset=utf-8 直接返回字符串 success（忽略大小写）表示成功，详见 回调接口规则说明。

备注

• 若客户响应失败，开放平台会按 30s、4m、30m、1h 间隔重试。
• 派单接口应做幂等处理（同一 callback_id 视为同一次回调）。