purser文档

WhatsApp 和 Instagram

用你自己的 Meta 应用把 WhatsApp 和 Instagram 私信接进收件箱,AI 和客服的回复发回同一个聊天。

purser 用「自带 Meta 应用」的方式接入:你在 Meta 开发者后台有一个自己的应用,把它的凭证填进 purser,再把 purser 给你的 webhook 地址填回 Meta。目前没有「用 Facebook 账号一键连接」。

  • WhatsApp 走 WhatsApp Cloud API。
  • Instagram 走 Instagram API(Instagram 登录方式)。

1. 在 purser 里连接

打开「设置 → 渠道」,在「WhatsApp 和 Instagram」卡片里点「连接 WhatsApp」或「连接 Instagram」,填写:

字段填什么
Phone number ID(WhatsApp)Meta 开发者后台 → WhatsApp → API Setup 里的 Phone number ID,不是电话号码本身
Instagram 账号 ID(Instagram)Meta 开发者后台 → Instagram → API setup 里的账号 ID,一串数字
显示名称在这张卡片里标识这个连接,例如 +1 555 000 1111 或 @your_shop
访问令牌(永久令牌 / System User token)用来代表你的账号发消息
应用密钥(App secret)32 位十六进制,用来确认 webhook 真的来自你的 Meta 应用

点「保存」。令牌和密钥加密保存,之后不会再显示。同一个号码或账号在一个工作区里只能连接一次。

2. 在 Meta 里填 webhook

保存后,卡片里会出现两项:

项内容
Callback URLhttps://askpurser.com/api/channels/meta/<连接 ID>
Verify token一串随机字符

在 Meta 开发者后台的 Webhooks 里填入这两项,并订阅 messages 字段。

卡片上的状态:

  • 「等待 Meta 验证 webhook」:还没收到 Meta 的签名推送。
  • 「已收到 Meta 的消息」:Meta 已经把事件推过来了,连接可用。

每次推送都必须用你的应用密钥签名,签名不对的一律拒收;发给其他号码或账号的消息会被忽略。

收进来的消息

  • 每位顾客(每个 WhatsApp 号码或 Instagram 用户)在每个连接下有一段对话,之后的消息都进这段对话。
  • 文字、图片、WhatsApp 的按钮回复会收进来;贴纸和表情回应会被忽略。
  • 手机号或 Instagram 账号不能证明是你店里的哪位顾客,所以这些对话都按匿名处理:AI 不会透露任何订单信息。

Meta 的 24 小时回复窗口

Meta 只允许在顾客最后一条消息后 24 小时内自由回复。超过 24 小时,回复不会发出,对话里会留一条说明,例如「没有发出:WhatsApp 只允许在顾客最后一条消息后 24 小时内回复。等顾客再发消息,或在 WhatsApp 里用模板消息联系。」purser 不发模板消息。

其他发送限制:

  • WhatsApp 单条回复最多 4096 个字符,Instagram 最多 1000 个字符,超出部分会被截掉。
  • 访问令牌失效时,对话里会留一条「没有发出:……的访问令牌失效了」,卡片上会显示「最近一次发送失败」。要换令牌,删除这个连接再重新连接;新连接的 Callback URL 和 Verify token 都会变,记得在 Meta 里一起更新。

转人工

这两个渠道不是实时聊天:转人工时不排实时队列,而是变成等待回复的对话,顾客收到一条确认消息,说明什么时候会有人回复。每次等待只发一次。

AI 身份告知

每段对话里 AI 发出的第一条回复前面会加一行说明,按顾客的语言,例如「(这是 Blind Box Tokyo 的 AI 助手,需要人工客服随时说。)」。客服发的回复不加。

套餐

套餐WhatsApp 和 Instagram
Free可以连接,消息照样进收件箱,由人回复;AI 不自动回复
Starter、Growth、ScaleAI 按「AI 自主程度」的设置处理:默认先起草,由人审过再发
测试工作区和付费套餐一样

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

本页内容