连接 API 收件箱

为来自你自己的应用或系统的消息创建 API 收件箱,获取它的标识符和入站 webhook 地址,并把请求格式交给你的开发者。

最后更新

API 收件箱背后没有任何即时通讯应用。会话和消息由你自己的系统创建,比如你自建的应用内聊天、自助终端,或者 Mampu AI 没有原生接入的渠道,而你的团队像在其他收件箱一样从后台回复。

1. 添加 API 收件箱

前往 Settings → Inboxes → Add Inbox,选择 API。

API 渠道表单

  • Channel Name:收件箱在侧边栏中的名称。
  • Webhook URL:可选。你的系统接收事件(例如团队的新回复)的地址。如果你的系统只发送不接收,留空即可。

点击 Create API Channel,选择负责回复的客服并 Add agents。

2. 收集开发者需要的信息

打开收件箱的设置页面:

  • Settings 显示 Webhook URL 和用于给发给你的事件签名的 Webhook Secret,旁边有 Copy 和 Reset。
  • Configuration 显示 Inbox Identifier、你的系统推送联系人和消息数据的 Inbound Webhook URL、Payload Format,以及用于签名请求的 Enforce User Identity Validation。

请求和响应格式的开发者文档在 developers.sapot.ai。

适合表单线索的更简单做法

如果你只是想把表单提交或其他系统的事件变成一个会话,WhatsApp 或其他收件箱上的 Inbound Webhook 可能就够了,而且不需要写代码。参见 Inbound Webhooks。

相关文章