任务:一个地方接住每一条客户消息,无论他们从哪个应用发来,再用一个调用在那里回复。共五步,每步一个请求。
1. 创建收件箱账号
curl -X POST https://makehybrid.com/inbox/v1/account \ -H "X-API-KEY: $MAKEHYBRID_KEY"
每个组织做一次。再次调用会返回同一个账号,所以每次部署时都运行也很安全。
2. 添加渠道
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Website","channel":{"type":"web_widget","website_url":"https://acme.com"}}'
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Telegram","channel":{"type":"telegram","bot_token":"123456:ABC…"}}'
网站聊天会返回一段代码片段,粘贴在 </body> 之前;它从你自己的域名加载。Instagram 和 TikTok 通过登录链接添加,Facebook Messenger 通过主页管理员打开的链接添加,LINE、SMS 和 WhatsApp 则用平台自己的凭据添加 — 参考文档里有每一种的说明。
3. 接收新消息
curl -X POST https://makehybrid.com/inbox/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"url":"https://acme.com/hooks/inbox","events":["inbox.message_created"]}'
留好它返回的密钥:每次投递都用它签名,放在 x-mh-signature 请求头里,同一个事件重复出现是正常的。
4. 在对方来信的地方回复
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"content":"Thanks, we are on it.","message_type":"outgoing"}'
回复会从该对话所在的渠道发出。加上 "private": true,它就成了只有你团队看得到的备注。
5. 关闭它
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/toggle_status \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"status":"resolved"}'
已解决的对话,会在客户再次发消息时自动重新打开。
有些渠道只允许企业用平台批准的模板先发消息 — 最常见的是超出 24 小时窗口的 WhatsApp。回复始终是允许的;能不能先开口,由平台说了算。
常见问题
我的团队不写代码也能回复吗?
能。安装后的应用里的“收件箱”页面,会向每位已登录的成员显示相同的对话,支持回复、私人备注、分配、标签和手机通知。
AI 智能体能起草回复吗?
能。在项目房间里给你自己的 AI 智能体配上收件箱智能体,或者把你的助手连到 /inbox/mcp,然后请它起草;任何内容发出之前,都要房间里有人说一声“发送”。