你的团队已经在 ChatWoot 里回复客户。这个做法让你从自己的代码触及同一个 ChatWoot — 它的收件箱、未结的对话、说过的话和你发出的回复 — 不需要第二个收件箱,也不需要搬动任何东西。
只需连接一次
在房间页面,登录后:填入你的 ChatWoot 控制台的地址和管理员的访问令牌。连接时会添加一个 webhook,好让团队的回复传回来;断开连接时它会被移除。API 从不接收这两样东西:POST /chatwoot/v1/connections/link 会返回 403,并附上该去填写的页面。
有哪些未结
curl "https://makehybrid.com/chatwoot/v1/connections" \ -H "X-API-KEY: $MAKEHYBRID_KEY" curl "https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations?status=open" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
每个对话都带着它的联系人、负责的客服人员、所属收件箱,以及最近一次变动的时间。它的消息按最早的在前排列,并各自标明方向:incoming 是客户发的,outgoing 是团队发的。
回复、备注、解决
curl -X POST https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"content":"It went out this morning — here is the tracking link."}'
curl -X PATCH https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"status":"resolved"}'
发送 private 为 true,就是客户永远看不到的备注。其他情况都是以已连接的用户身份写下的,客户看得到,所以代你书写的智能体,是在你的客户面前书写。
让它来通知你,而不是你去问
注册一个 webhook 端点,这个 ChatWoot 任何对话里的每条消息都会被发到它那里:客户的是 chatwoot.message_received,团队的是 chatwoot.message_sent。端点和签名都与 LinkedIn API 的相同。
curl -X POST https://makehybrid.com/chatwoot/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"url":"https://acme.com/hooks/chatwoot","events":["chatwoot.message_received"]}'
常见问题
我的客户会看到你们的任何东西吗?
不会。这是你自己地址上的你自己的 ChatWoot,所有内容都以令牌所属的用户身份写下。不会改品牌,我们的任何东西也不会安装进去。
ChatWoot 宕机时会怎样?
返回 502 errors/chatwoot_unavailable,不会在你背后排队或重试。令牌被拒绝时返回 409 errors/chatwoot_disconnected,意味着需要成员重新连接。
AI 智能体能在那里回复客户吗?
可以,通过 https://makehybrid.com/chatwoot/mcp/<你的 API 密钥>,或者在房间里。给它写好指令,说明什么时候回复,什么时候改留私人备注 — 凡不是私人备注的内容,客户都看得到。