WhatsApp、Instagram 和 Messenger
用你自己的 Meta 应用把 WhatsApp、Instagram 和 Facebook Messenger 私信接进收件箱,AI 和客服的回复发回同一个聊天。
purser 用「自带 Meta 应用」的方式接入:你在 Meta 开发者后台有一个自己的应用,把它的凭证填进 purser,再把 purser 给你的 webhook 地址填回 Meta。目前没有「用 Facebook 账号一键连接」。
- WhatsApp 走 WhatsApp Cloud API。
- Instagram 走 Instagram API(Instagram 登录方式)。
- Messenger 走 Messenger Platform,连接一个 Facebook 主页。
1. 在 purser 里连接
打开「设置 → 渠道」,在「WhatsApp、Instagram 和 Messenger」卡片里点「连接 WhatsApp」「连接 Instagram」或「连接 Messenger」,填写:
| 字段 | 填什么 |
|---|---|
| Phone number ID(WhatsApp) | Meta 开发者后台 → WhatsApp → API Setup 里的 Phone number ID,不是电话号码本身 |
| Instagram 账号 ID(Instagram) | Meta 开发者后台 → Instagram → API setup 里的账号 ID,一串数字 |
| Facebook 主页 ID(Messenger) | Meta 开发者后台 → Messenger → Messenger API 设置里列出的主页 ID,一串数字 |
| 显示名称 | 在这张卡片里标识这个连接,例如 +1 555 000 1111 或 @your_shop |
| 访问令牌(永久令牌 / System User token) | 用来代表你的账号发消息;Messenger 填这个主页的访问令牌 |
| 应用密钥(App secret) | 32 位十六进制,用来确认 webhook 真的来自你的 Meta 应用 |
点「保存」。令牌和密钥加密保存,之后不会再显示。同一个号码或账号在一个工作区里只能连接一次。
2. 在 Meta 里填 webhook
保存后,卡片里会出现两项:
| 项 | 内容 |
|---|---|
| Callback URL | https://askpurser.com/api/channels/meta/<连接 ID> |
| Verify token | 一串随机字符 |
在 Meta 开发者后台的 Webhooks 里填入这两项,并订阅 messages 字段。Messenger 要给这个主页订阅 messages 和 messaging_postbacks 两个字段。
卡片上的状态:
- 「等待 Meta 验证 webhook」:还没收到 Meta 的签名推送。
- 「已收到 Meta 的消息」:Meta 已经把事件推过来了,连接可用。
每次推送都必须用你的应用密钥签名,签名不对的一律拒收;发给其他号码或账号的消息会被忽略。
收进来的消息
- 每位顾客(每个 WhatsApp 号码、Instagram 用户或 Messenger 用户)在每个连接下有一段对话,之后的消息都进这段对话。
- 文字、图片、语音、按钮回复(WhatsApp 按钮、Messenger 按钮和「开始使用」)会收进来;贴纸和表情回应会被忽略。语音会转成文字,客服也可以用语音回复,见 语音消息。
- Messenger 顾客第一次发消息时,purser 会向你的主页查询顾客的名字,收件箱里会显示。
- 手机号、Instagram 账号或 Messenger 用户都不能证明是你店里的哪位顾客,所以这些对话都按匿名处理:AI 不会透露任何订单信息。
Meta 的 24 小时回复窗口
Meta 只允许在顾客最后一条消息后 24 小时内自由回复。超过 24 小时,回复不会发出,对话里会留一条说明,例如「没有发出:WhatsApp 只允许在顾客最后一条消息后 24 小时内回复。等顾客再发消息,或在 WhatsApp 里用模板消息联系。」purser 不发模板消息。
Messenger 上,客服本人在顾客最后一条消息后 7 天内仍然可以回复:超过 24 小时的回复,purser 会带上 Meta 的 Human Agent 标签发送。AI 在 24 小时之外永远不会回复。这个标签要求你的 Meta 应用有 Human Agent 权限(在 Meta 的 App Review 里申请);没有权限时 Meta 会拒收,对话里会留一条说明,提示应用可能还没有这个权限。超过 7 天则不会发出。
其他发送限制:
- WhatsApp 单条回复最多 4096 个字符,Messenger 最多 2000 个字符,Instagram 最多 1000 个字符,超出部分会被截掉。
- 访问令牌失效时,对话里会留一条「没有发出:……的访问令牌失效了」,卡片上会显示「最近一次发送失败」。要换令牌,删除这个连接再重新连接;新连接的 Callback URL 和 Verify token 都会变,记得在 Meta 里一起更新。
转人工
这些渠道不是实时聊天:转人工时不排实时队列,而是变成等待回复的对话,顾客收到一条确认消息,说明什么时候会有人回复。每次等待只发一次。
AI 身份告知
每段对话里 AI 发出的第一条回复前面会加一行说明,按顾客的语言,例如「(这是 Blind Box Tokyo 的 AI 助手,需要人工客服随时说。)」。客服发的回复不加。
套餐
| 套餐 | WhatsApp、Instagram 和 Messenger |
|---|---|
| Free | 可以连接,消息照样进收件箱,由人回复;AI 不自动回复 |
| Starter、Growth、Scale | AI 按「AI 自主程度」的设置处理:默认先起草,由人审过再发 |
| 测试工作区 | 不能接,要在正式工作区里接 |