purser文档

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 URLhttps://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、ScaleAI 按「AI 自主程度」的设置处理:默认先起草,由人审过再发
测试工作区不能接,要在正式工作区里接

见 AI 自主程度 和 套餐与账单。

本页内容