本指南介绍如何将你的 Quickchat AI Agent 与 WhatsApp 集成。流程分为 2 个简单步骤：
- 步骤 0 - 前提条件
- 步骤 1 - 连接 WhatsApp
如果集成遇到问题或需要帮助，请转到 故障排查与常见问题部分，或联系我们。
观看视频
步骤 0 - 前提条件
A. 商业电话号码
确定你要用于 WhatsApp 的电话号码。你可以在 WhatsApp 文档中阅读更多信息，也可以参考下面的常见问题：
WhatsApp Cloud API 可以使用哪个号码？
- 你需要使用一个专用商业电话号码，该号码可以接收 SMS 或语音电话用于验证。
- 该号码必须有效、归你所有，并且包含国家/地区代码和区号。
我可以使用已经用于 WhatsApp Messenger 的号码吗？
- 不可以。你可以继续将该号码用于通话和短信，但不能用于 WhatsApp Messenger。
- 如果该号码已经用于 WhatsApp Messenger，请先将其删除。不要忘记备份你的 WhatsApp 聊天记录。
- 被封禁的号码必须先解除封禁，然后才能注册。
我可以使用已经由 WhatsApp Business App 使用的号码吗？
- 可以。如果你的号码当前用于 WhatsApp Business App，你可能可以在不删除应用账号的情况下将其接入 Cloud API。请在 Meta 文档中阅读有关 Coexistence 接入的更多信息。
我可以使用新的电话号码吗？
- 可以，如果你不想使用当前号码，请获取一个新号码（实体 SIM 卡或虚拟号码）。你可以从 Hushed 等服务购买虚拟电话号码。
B. 商业信息
准备好以下信息（你将在 Meta 集成流程中输入）：
- 商业名称
- 商业网站
- 商业类别
- 商业描述
即使某些字段看起来是可选的，也请准确填写。缺失或不准确的信息可能会延迟审批，或导致账号受到限制。
步骤 1 - 连接 WhatsApp
自最新更新后，连接只需要单击一次。现在不再有单独的第二步：Meta 自己的 Embedded Signup 向导会引导你创建新的 WhatsApp Business Account 和号码，或选择已有的账号和号码，Quickchat AI 会完成其余步骤。
打开 Quickchat AI App → External Apps → WhatsApp → 单击 Connect WhatsApp 按钮，并按照 Meta 弹窗操作：
- 登录你的 Meta (Facebook) 账号。
- 查看你将与 Quickchat AI 共享的权限（WhatsApp Business 账号访问权限和 Business portfolio 访问权限），然后继续。
- 提供准确的商业详细信息（Business Portfolio、Business Name、Business Website、Country 等）。
- 创建或选择你的 WhatsApp Business Account。
- 选择 WhatsApp Business 显示名称和类别。
- 添加你的商业电话号码，并按提示通过短信/语音进行验证。
- 单击 Confirm，授予 Quickchat AI 所需的访问权限。
- 当 Meta 确认设置完成后，单击 Finish。弹窗会显示 Quickchat AI 确认信息，说明你的 WhatsApp 账号已连接，然后自动关闭。
回到 Quickchat AI App，WhatsApp 面板会显示 Connecting your WhatsApp account，并在大约 30 秒内更新为 Connected。如果没有更新，请单击面板中的 Refresh Status。否则，请重新查看上面的前提条件，确保你已正确提供商业电话号码和信息。
Connected 表示 Quickchat AI 可以访问你的 WhatsApp Business Account。在其正下方，面板会显示在客户获得回复之前仍需完成的事项：
Connected 面板列出了剩余事项：这里是第一条消息
- Waiting for your first message：用另一部手机向显示的号码发送一条 WhatsApp 消息，然后单击 Refresh。收到消息后，面板会在 Webhook Active 和 Admin Assigned 旁显示 Messages Received。
- Display name：面板下方列出的每个号码都会显示其来自 Meta 的显示名称状态（Approved、Pending review、Declined、Expired 或 No display name）。正在审核时你无需操作，通常会在几天内完成。被拒绝、已过期或缺失的显示名称需要你在 WhatsApp Manager 中提交。
- Meta test number：如果活动号码是 Meta 提供的 +1 555 号码，面板会说明这一点。这些号码用于试用，不能迁移到其他账号。请在 WhatsApp Manager 中添加你自己的号码以正式上线。
当面板显示 Messages Received 后，你就已上线！ 🎉 客户可以向你的 WhatsApp 号码发送消息，你的 AI Agent 会自动回复。
作为集成的最终验证，请向你刚连接的 WhatsApp 号码发送一条短信，然后在面板中单击 Refresh。Waiting for your first message 会变为 Messages Received，你应当会收到来自 AI Agent 的回复，并且该对话应当出现在 Quickchat AI App Inbox 中。如果你未完成 Meta 的任何设置步骤，Quickchat AI 也会向账号所有者发送电子邮件，提醒剩余步骤。
故障排查与常见问题
WhatsApp Business API 计费如何运作？
- 对用户发起的（入站）客户咨询的回复，会被 WhatsApp 视为 Service messages。这些消息让企业能够管理传入的客户咨询，无论是由人工客服还是由对话式 AI 机器人处理。
- 当用户向企业发送消息时，会打开一个 24 小时客户服务窗口，在此期间企业可以用服务消息回复，无需付费。该窗口会随每条用户消息重置。
- 24 小时之外，你必须使用已获批的 Message Templates（Marketing、Utility、Authentication 等），并按照 WhatsApp Business Platform Message Rates 按消息付费。
- 对话由 Meta 分类并计费。请确保你的 WhatsApp Business Account 对于企业发起/模板消息有有效的付款方式。
Connect WhatsApp 按钮不起作用。我看不到 Meta 弹窗。
- 如果你的浏览器阻止弹窗，应用会显示一条消息，要求你允许弹窗。在浏览器中禁用弹窗和跟踪器拦截器，刷新网站后重试。如果仍无效，请尝试其他浏览器。
号码验证失败。
- 确保该号码可以接收短信/语音电话，并且没有被 Meta 不允许共存的有效注册路径阻止。如果该号码用于 Business App，请尝试通过 Coexistence 接入。
Meta 提示我的设置尚未完成，或面板显示警告。
- 先阅读 Connected 下方的卡片：它会列出你的 AI Agent 用来回复的号码，并说明 Meta 是否仍在审核其显示名称、该号码是否为 Meta 测试号码，或第一条消息是否尚未到达。每张卡片都会链接到 WhatsApp Manager 中的相应位置。
- 如果警告与连接本身有关，请在面板中单击 Reconnect WhatsApp。这可以解决大多数情况。
- 如果仍未解决，你的号码可能已连接到另一个提供商（Meta 每次只允许一个合作伙伴连接一个 WhatsApp 账号）。按照屏幕上的说明，在 Meta Business 设置中将 Quickchat AI 添加为合作伙伴，然后单击 Refresh Status。
我连接了错误的账号。
- Reconnect 会保留已连接的账号。要切换账号，请在 WhatsApp 面板中单击 Disconnect，然后再次单击 Connect WhatsApp，并在 Meta 窗口中选择正确的 Meta Business 账号和 WhatsApp Account。
消息没有出现在 Quickchat AI Inbox 中。
- 确认弹窗显示了最终确认信息，说明你的 WhatsApp 账号已连接。
- 再次检查你链接的是目标 WhatsApp Account，并且选择了正确的 AI Agent。
- Waiting for your first message 卡片会列出你的 AI Agent 用来回复的号码。请确保你已向该确切号码发送消息，并且该号码在面板中已开启，然后单击 Refresh。
- 如果你在没有用户消息的情况下于 24 小时后发送消息，请使用已获批的模板，并确保在 WhatsApp Manager 中设置了付款方式。
我的 AI 的 WhatsApp 回复发送失败。
- Quickchat AI 会在 WhatsApp 面板上显示 “WhatsApp replies are failing” 警报，并在你的仪表盘上显示通知。常见修复方式：在 WhatsApp Manager 中完成显示名称审批；如果连接已过期或被撤销，单击 Reconnect；如果 Meta 因质量或政策问题限制了你的号码，请在 WhatsApp Manager 中检查其状态。一旦回复再次成功发送，警报就会清除。
模板消息或企业发起的消息失败。
- 验证你的 Message Templates 已获批，并且你的付款方式在 WhatsApp Manager 中处于活动状态。
- 新发送方会从消息发送限制开始，这些限制会根据质量和验证情况扩展。如果你触及了企业发起消息的限制，请查看 Meta 的 Messaging Limits 指南。
- 如果投递受到限流，请在 WhatsApp Manager 中检查消息发送限制和质量评级。
如何创建我自己的 WhatsApp 链接和“Chat on WhatsApp”按钮？
- 按照这篇 WhatsApp 教程操作。
如何创建我自己的 WhatsApp 二维码？
- 访问 WhatsApp Manager → Phone numbers → 选择你的商业电话号码 → Message links → Create Message Link。
- 或者，你也可以在 WhatsApp Business 移动应用中找到它。按照这篇 WhatsApp 教程操作。
需要帮助？
在 WhatsApp 上与 Quickchat 的 Support AI 聊天：
📱 +1 302-405-9992：开始聊天
或扫描二维码：
