接口说明 / 到口自动回复 App 对接

到口自动回复 · App 对接说明（2026-10-20）

给 App 合码用。到口是 AI 平台，可以做所有事情（无业务范围限制）；对接自动回复走自有 IM 私聊，不单独开「回复接口」。

---

1. 一句话

用户私聊门铃号 1000（到口） 发文本 → 服务端异步自动回 → App 拉消息拿到回复。
到口 = AI，面向所有用户、解决所有问题、可做所有事；App 主对接这个号即可。

2. Base（必对）

项	值
IM Base	https://api.menling.com
鉴权	Header：Authorization: Bearer <JWT>（与现网门铃/到门口登录 JWT 一致；也可用现网 Cookie）

不要把 IM 指到 api.menkou.com（那是业务 API，不是发信路径）。

3. 坐席门铃号

门铃号	角色	能力
1000	到口	全能：可做所有事情，不限平台、不限问题类型
9999	到门口客服	只答到门口平台
10000	门铃客服	只答门铃平台；出口链接用 www.menling.com
1	对接客服	只谈研发对接；平台问题推名片

App 自动回复主对接：destId / peerId = 1000。

4. 发消息（触发自动回复）

POST https://api.menling.com/message/send_private
Content-Type: application/json
Authorization: Bearer <JWT>

Body 示例：

{
  "destId": "1000",
  "content": "用户说的话",
  "contentType": 1
}

说明：

• destId：对方门铃号，字符串；也可用门铃号 N3d 密文（与现网一致）。
• contentType: 1：文本。当前自动回复只挂文本；图片/语音后续另开。
• 成功：HTTP 200，code=200，消息入库 source=menling_im。
• 发信接口立刻返回，不挡自动回复。

5. 拉消息（拿到自动回复）

GET https://api.menling.com/message/pull_private?peerId=1000&limit=50&lastId=
Authorization: Bearer <JWT>

说明：

• peerId：与发信同一坐席（到口用 1000）。
• lastId：增量拉取游标；首拉可空。
• 自动回复入库 source=kefu_ownim，一般可拉到：词库/短句约 1–3 秒，冷知识约 7 秒（热修后；以现网为准）。

也可继续用现网推送通道；推送未到时以 pull_private 为准。

6. App 联调步骤（建议）

1. 登录拿 JWT。
2. POST send_private → destId=1000，发一句任意业务问题（开店、订单、解封等均可，到口全能）。
3. 轮询或等推送后 GET pull_private?peerId=1000。
4. 期望：出现坐席 1000 → 用户 的回复，source=kefu_ownim。

（若另验到门口/门铃：同样链路，坐席改 9999 / 10000，口径只限各自平台。）

7. 不要调的接口

接口	说明
/muser/menlingnew/kefuLexiconReply	服务端内部桥（Node→PHP），App 不要调
旧第三方 IM webhook	现网不走

8. 常见坑

1. IM Base 写错成 api.menkou.com → 发信不通、无自动回。
2. contentType 非 1 → 当前不触发客服桥。
3. 坐席号写错 → 无自动回；到口必须是 1000。
4. 只等推送不拉 → 网络差时以为没回；务必可 pull_private。
5. 勿把 9999/10000 当全能：只有 1000 到口 可做所有事情。

---

说明：到口是 AI，可以做所有的事情。有字段/鉴权与现网不一致，以现网 api.menling.com 联调为准。