MakeHybrid
预约通话
简体中文

用一个收件箱回复所有渠道

创建共享收件箱,添加网站聊天和 Telegram,用 webhook 接收新消息,在客户所用的渠道里回复,并关闭对话。

任务:一个地方接住每一条客户消息,无论他们从哪个应用发来,再用一个调用在那里回复。共五步,每步一个请求。

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,然后请它起草;任何内容发出之前,都要房间里有人说一声“发送”。

让它自己运转起来

说说你的业务是做什么的,它就成了你自己的服务和产品合二为一:工作自己运转,用的是你的名字、你的账号和你的 AI 密钥。前 30 天免费,这里的一切都不需要工程师。

开始试用