连接 WhatsApp 号码

前台通过组织在 Meta WhatsApp Cloud API 中自己的 WhatsApp Business 账号接收和回复消息。在 Front desk channels 页面连接一次号码后，Kluvan 会逐步检查，完成后才启用号码。Meta 直接向您收取消息费用。

开始之前

• 您的方案或试用必须包含 Inbox 应用。
• 只有所有者可以连接或断开号码。经理可以查看页面。
• 在 Meta Business Manager 中，您需要：具有 WhatsApp 产品的 Business 类型 Meta 应用、已添加到其 WhatsApp Business 账号的号码、永久访问令牌（来自具有 WhatsApp 消息和管理权限的 System User），以及应用密钥。

操作步骤

1. 打开 Settings → Front desk channels：按 Ctrl+K，输入“channels”，选择 Front desk channels。
2. 在 Connect a WhatsApp number 下选择 Paste the Cloud API details from Meta，然后选择 Start。
3. 填写 Phone number ID、WhatsApp Business account ID、Access token、App secret，也可填写 Number customers see。
4. 选择 Save and check。Number reserved for your organisation 步骤会打勾。
5. 点击 Webhook URL 旁的 Copy，将其粘贴到 Meta 应用 WhatsApp → Configuration 的回调 URL。以同样方式填写 Verify token，并将 webhook 订阅到 messages。
6. 选择 Check with Meta。Meta 确认号码后，Meta confirmed the number 会打勾。
7. 从自己的手机向该号码发送任意消息。A message to the number reached Kluvan 会打勾。
8. 选择 Send the test reply。手机会收到简短送达测试，A test reply was delivered 会打勾。
9. 选择 Switch on。渠道卡片显示 Active。

启用之后

渠道卡片显示号码、Provider、Status、Connection（Working、Failing 或 Not checked yet），以及 WhatsApp templates 和各模板状态（Approved、Paused、Rejected 等）。

• Check the connection 再次向 Meta 检查，并显示确认结果。
• Sync templates 从 Meta 读取已批准的消息模板。前台仅在 WhatsApp 的 24 小时窗口之外使用，例如订单更新。
• Disconnect 会停止前台使用该号码。选择号码后续用途：Keep it ready to move to another provider 或 Keep using it with my own WhatsApp service，勾选确认了解服务商收费会继续，然后确认。对话及历史记录保留。

须知

• Sign in with Meta 即将推出。 通过 Meta 的一键连接（Embedded Signup）已构建，待 Kluvan 自己的 Meta 应用获批后会显示为 Sign in with Meta。在此之前，请按上述方式粘贴资料。
• 一个号码对应一个组织。 已连接其他组织的号码会被拒绝（fd_number_taken）。目前每个组织可连接一个 WhatsApp 号码。
• 尚未就绪。 所有步骤打勾之前，渠道显示 Not ready yet，前台除送达测试外不会通过该渠道发送任何内容（fd_channel_not_ready）。可随时使用 Cancel this connection 停止并重新开始。
• 从 WhatsApp Business 应用回复。 您从相同号码的 WhatsApp Business 应用回复时，Meta 尚不能可靠通知 Kluvan。请先在前台接管对话，再从应用回复。
• 凭据加密保存，仅供您的组织使用，之后不会再次显示。
• 每条 Meta 消息都经过验证，使用您的应用密钥检查。重复消息会丢弃，送达状态（Sent、Delivered、Read）不会倒退。
• 服务商。 目前仅可通过 Meta Cloud API 连接 WhatsApp；Providers 表将其他服务商列为 Not available。
• 旧表单。 Front desk settings 中的 Connect WhatsApp 仍可直接连接号码；号码随后会显示在渠道页，并注明为此前连接。
• 下一步：选择前台的回复方式。