Your AI Connector Docs

连接您自己的 Meta 应用

通过您自己的 Meta 应用运行 WhatsApp，并直接按 Meta 的费率向其支付费用。Your AI Connector 不会对该连接收取任何每条消息的费用，中间也不涉及 Twilio 账户。由于 WhatsApp 账户归您所有，您的客户看到的始终是您的企业名称。

这是 WhatsApp 连接选项中技术要求最高的一种——您需要在 Meta 的开发者网站中创建一个应用，并将四个值复制回 Your AI Connector。请预留约 20 分钟的时间。如果这听起来超出了您的处理能力，托管式 WhatsApp Business 连接仍然是入门最简单的方式。

您需要准备什么

  • 访问您的 Meta Business Manager 账户的权限。
  • 一个尚未在 WhatsApp 应用上使用的电话号码。
  • 大约 20 分钟时间。

第 1 部分 — 在 Meta 中设置您的应用

请先在 Meta 端执行这些步骤。在此过程中，您将收集四个值：应用 ID (App ID)、应用密钥 (App secret)、访问令牌 (Access token) 和 WhatsApp 账户 ID (WhatsApp account ID)。

1. 创建应用

前往 developers.facebook.com，打开 我的应用 (My Apps) 并点击 创建应用 (Create App)。选择 企业 (Business) 类型并为其命名——该名称仅对您可见。

2. 将 WhatsApp 添加到应用

在应用控制面板上，在产品列表中找到 WhatsApp 并点击 设置 (Set up)。Meta 会创建一个带有免费测试号码的测试 WhatsApp 账户，以便您在连接真实号码之前进行试用。

3. 开启 WhatsApp 权限

这是大多数指南都会跳过的步骤，而跳过它也是导致后续连接失败的最常见原因。

在您的应用中，打开 应用审核 (App Review)，然后进入 权限和功能 (Permissions and Features)。搜索 whatsapp_business_management。如果显示 无访问权限 (No access)，请点击 获取标准访问权限 (Get standard access)——Meta 会要求您重新输入密码并立即授予权限。此过程无需等待期，也无需应用审核；只需点击一个按钮即可。

whatsapp_business_messaging 通常已经拥有标准访问权限。在进行下一步之前，两个权限都需要显示为 标准访问权限 (Standard access)，否则您生成的令牌将缺少其中之一。

4. 创建系统用户

在 Meta 商务设置 中，打开 用户，然后选择 系统用户。添加一个系统用户，并授予其对您的应用和 WhatsApp 账户的管理员访问权限。

5. 为该用户生成令牌

选择该系统用户并点击 生成新口令。选择您的应用，选择一个永不过期的令牌，并勾选 whatsapp_business_messaging 和 whatsapp_business_management。Meta 只会显示该令牌一次，请务必立即复制。

6. 查找您的 WhatsApp 账户 ID

在商务设置中，打开 账户，然后选择 WhatsApp 账户，并选中您的账户。其名称下方的长数字即为 ID。

您的 应用编号 (App ID) 和 应用密钥 (App secret) 位于应用的 应用设置 中的 基本信息 选项卡下。点击应用密钥旁边的 显示 即可查看。

第 2 部分 — 在 Your AI Connector 中进行连接

打开 设置，然后进入 渠道，找到 WhatsApp Business API 卡片并点击 连接 WhatsApp。选择 使用您现有的号码，然后选择 您自己的 Meta 应用。向导将打开一个简短的概览页面 —— 点击 开始设置。

  1. 您的详细信息。 此步骤将重复第 1 部分中 Meta 端的五个步骤，并在旁边提供一个用于填写四个值的表单。请准确粘贴 Meta 显示的应用 ID (App ID)、应用密钥 (App secret)、访问令牌 (Access token) 和 WhatsApp 账户 ID，不要包含多余的空格，然后点击 Check my details。在验证通过之前，不会保存任何内容——Your AI Connector 会先与 Meta 进行核对。
  1. 选择要连接的号码。 向导会列出您 WhatsApp 账户下的所有号码，每个号码都带有 Meta 自身的质量评级。选择此工作区用于发送和接收消息的号码，然后点击 连接此号码。
  1. 激活与交付。 Your AI Connector 会自动为 Cloud API 激活该号码，并将其 Webhook 注册到 Meta，以便收到的消息能够送达您的收件箱——在大多数情况下，您会直接进入显示“号码已连接”确认信息的连接卡片。如果自动步骤无法完成，向导会显示回调 URL 和验证令牌（带有复制按钮），并引导您自行在 Meta 中添加它们；这些值会保留在连接卡片上，以防 Meta 之后要求您重新输入。
  2. 向导会自动检查连接。 在最后一步，它会自动验证设置——无需您等待。一旦卡片显示已连接，请从另一部手机向自己发送一条 WhatsApp 消息，并观察它是否出现在您的聊天列表中：该号码上的对话现在会像其他任何渠道一样流入，您的 AI 代理也可以对其进行回复。如果检查发现 Meta 仍需要某些内容（例如号码验证），卡片会明确告知您，在您修复后，点击 验证连接 即可再次运行检查。

您可以随时回到此页面查看连接状态、使用新详情重新连接，或点击断开连接 — 您的号码、Meta 账户和账单信息始终归您所有。

温馨提示

  • 与所有 WhatsApp Business 连接一样，24 小时窗口期适用。 您可以随时自由回复在过去 24 小时内给您发送过消息的用户。在该窗口期之外，WhatsApp 只允许企业使用已批准的 消息模板 发起对话——纯文本消息会被 Meta 接收，但不会被送达。
  • Meta 直接向您收取对话费用，费用按其公布的国家/地区费率计算，并从您在 Meta 的 WhatsApp 账户绑定的支付方式中扣除。Your AI Connector 不会在此连接上按消息收费；AI 使用量照常按积分计费。
  • 请在该 WhatsApp 账户上保留有效的支付方式。 如果没有支付方式，Meta 将阻止您的企业发起的每一场对话（包括广播、营销活动和任何模板消息），并在 WhatsApp 管理器中显示错误。在此连接下，如果出现这种情况，广播或营销活动将无法启动，系统会提示您添加支付方式，而不是逐条消息地报错。目前，对于主动联系您的用户的回复仍可发送，但从 2026 年 10 月 1 日起，Meta 也将对这些回复收费，因此届时没有有效支付方式的账户将完全静默。完整说明请参阅 WhatsApp 成本与 2026 年 10 月的变更。
  • 您的成本估算在此处显示不同。 由于这些费用不涉及您的积分，广播的审核步骤（以及营销活动的启动步骤）中的估算将显示联系人数量和国家/地区分布，并注明费用由 Meta 向您的 WhatsApp Business 账户收取，而不是显示积分总额。
  • 测试号码是免费的。 Meta 为每个新应用提供的测试号码可以免费向最多五个已验证的收件人发送消息——这是在将真实号码接入之前测试完整设置的便捷方式。

模板

消息模板适用于此连接，它们存在于您自己的 WhatsApp Business 账户中。在模板页面创建一个模板，它即会在该账户中创建并由 Meta 进行审核，审核结果（已批准、待处理或已拒绝）会在此处显示给您。您在 WhatsApp 管理工具中已有的模板会自动出现在列表中，点击从 Meta 同步按钮即可拉取您在那里所做的任何更改。发送方式与其他所有 WhatsApp 连接一样——选择一个已批准的模板来发起对话，或在 24 小时窗口之外重新开启对话。详细信息请参阅 在您自己的 Meta WhatsApp 账户中使用模板。

如果出现问题

  • “我们无法使用这些详细信息进行连接” — 请重新复制每个值；多余的空格通常是导致此问题的原因。该消息包含 Meta 的回复，通常会指出哪个值有误。
  • 错误提示缺少令牌 whatsapp_business_management — 您的应用尚未被授予该权限。返回第 1 部分第 3 步，点击 获取标准访问权限，然后勾选两个权限并生成一个新的令牌，再次检查您的详细信息。在不执行该步骤的情况下重新生成令牌将持续产生相同的错误。
  • 您的令牌消失了 — Meta 只会显示一次令牌。请从同一个系统用户处生成一个新令牌；旧令牌在撤销前依然有效，但只有新令牌可见。
  • 您发起的对话消息未送达 — 请查看上方的 24 小时窗口说明：在窗口期之外，仅能发送模板消息。
  • 完全没有消息送达 — 该号码可能尚未激活 Cloud API。一个号码同一时间只能在一个地方使用，因此如果它仍登录在手机上的 WhatsApp Business 应用中，请先将其移除，然后点击连接卡片上的 验证连接。Your AI Connector 会为您激活它，并当场告知您 Meta 是否仍缺少某些内容。
  • “此号码已有两步验证 PIN 码” — 该号码之前在其他地方设置过并保留了 PIN 码。请在 WhatsApp 管理器中关闭其两步验证，然后点击 重新连接。
  • “Meta 尚未验证此号码” — 请在 WhatsApp 管理器中完成号码验证（Meta 会向其发送验证码），然后点击 重新连接。
  • “此号码托管在本地部署 API (On-Premises API) 上” — 它正在运行 WhatsApp 较旧的自托管产品，该产品无法与 Cloud API 共享号码。请先在 WhatsApp 管理器中将其迁移到 Cloud API。