连接您自己的 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 部分中 Meta 端的五个步骤，并在旁边提供一个用于填写四个值的表单。请准确粘贴 Meta 显示的应用 ID (App ID)、应用密钥 (App secret)、访问令牌 (Access token) 和 WhatsApp 账户 ID，不要包含多余的空格，然后点击 Check my details。在验证通过之前，不会保存任何内容——Your AI Connector 会先与 Meta 进行核对。
- 选择要连接的号码。 向导会列出您 WhatsApp 账户下的所有号码，每个号码都带有 Meta 自身的质量评级。选择此工作区用于发送和接收消息的号码，然后点击 连接此号码。
- 激活与交付。 Your AI Connector 会自动为 Cloud API 激活该号码，并将其 Webhook 注册到 Meta，以便收到的消息能够送达您的收件箱——在大多数情况下，您会直接进入显示“号码已连接”确认信息的连接卡片。如果自动步骤无法完成，向导会显示回调 URL 和验证令牌（带有复制按钮），并引导您自行在 Meta 中添加它们；这些值会保留在连接卡片上，以防 Meta 之后要求您重新输入。
- 向导会自动检查连接。 在最后一步，它会自动验证设置——无需您等待。一旦卡片显示已连接，请从另一部手机向自己发送一条 WhatsApp 消息，并观察它是否出现在您的聊天列表中：该号码上的对话现在会像其他任何渠道一样流入，您的 AI 代理也可以对其进行回复。如果检查发现 Meta 仍需要某些内容（例如号码验证），卡片会明确告知您，在您修复后，点击 验证连接 即可再次运行检查。
您可以随时回到此页面查看连接状态、使用新详情重新连接，或点击断开连接 — 您的号码、Meta 账户和账单信息始终归您所有。
从托管连接切换
您可以先使用托管的 WhatsApp Business 连接，稍后再迁移至您自己的 Meta 应用。两者都存在于同一个账户中，因此无需重新构建任何内容。
- 您的联系人和聊天记录将保留。 联系人、对话、标签、坐席和知识库都属于您的账户，而非连接。删除或更换号码不会删除任何内容，当之前联系过您的人再次向该号码发送消息时，消息仍会进入同一个对话中。
- 号码必须先在 Meta 端进行迁移。 WhatsApp 规定一个号码同一时间只能存在于一个地方。请联系支持团队将号码从托管设置中释放，将其添加到您在 WhatsApp 管理工具 (WhatsApp Manager) 中的 WhatsApp Business 账户，然后按照本页面的步骤操作。请注意，迁移期间号码可能会短暂离线。
- 如果您计划切换，请使用您拥有的号码。 在 Your AI Connector 中租用的号码是属于托管设置的虚拟线路，无法直接迁移到您自己的 Meta 应用中，因此切换意味着需要使用一个新的 WhatsApp 号码。
- 模板需要重新审核。 Meta 是按 WhatsApp Business 账户来审核模板的，因此您需要在自己的账户下重新创建所使用的模板（请参阅下方的 模板）。
- 代理机构： 每个子账户都连接其自己的 Meta 应用，因此客户可以逐个进行切换。
温馨提示
- 24 小时窗口期同样适用，与所有 WhatsApp Business 连接一致。 您始终可以自由回复在过去 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 步，点击 获取标准访问权限 (Get standard access)，然后勾选两个权限并生成一个新的令牌，再次检查您的详细信息。如果不执行该步骤直接重新生成令牌，仍会产生相同的错误。 - 您的令牌消失了 — Meta 只会显示一次令牌。请从同一个系统用户处生成一个新令牌；旧令牌在撤销前仍然有效，但只有新令牌可见。
- 回复失败，提示“此对话是通过 WhatsApp Business 号码……发送的，该号码未连接” — 您的 Meta 应用关联了多个号码，而用户发送消息的号码并非此处连接的号码。他们的消息仍然会显示，因为 Meta 会发送应用中所有号码的消息，但回复只能通过已连接的号码发出，因此 AI 无法回复这些消息。渠道 (Channels) 页面上的 WhatsApp 卡片会显示一个警告，指出该号码，同时其消息会持续送达。该卡片上该号码的行没有“重新连接”按钮（只有 设为主要 (Set as primary) 和删除）：请再次打开您的 Meta 应用连接页面（在 WhatsApp Business API 卡片上点击 连接 WhatsApp (Connect WhatsApp)，然后选择 使用您已有的号码 (Use a number you already have)，再选择 您自己的 Meta 应用 (Your own Meta app)），点击连接卡片上的 重新连接 (Reconnect)，并选择您的客户实际发送消息的号码。系统用户的令牌需要访问该 WhatsApp 账户。如果该号码根本不应该连接到 Your AI Connector，请将其（或其 WhatsApp 账户）从您的 Meta 应用中移除。
- 您主动发起的对话消息未送达 — 请查看上方的 24 小时窗口说明：在窗口期之外，仅能发送模板消息。
- 没有任何消息送达 — 该号码可能尚未激活 Cloud API。一个号码一次只能在一个地方使用，因此如果它仍登录在手机上的 WhatsApp Business 应用中，请先将其移除，然后点击连接卡片上的 验证连接 (Verify connection)。Your AI Connector 会为您激活它，并当场告知您 Meta 是否仍缺少某些信息。
- “此号码已设置两步验证 PIN 码” — 该号码之前在其他地方设置过并保留了 PIN 码。请在 WhatsApp 管理器 (WhatsApp Manager) 中关闭其两步验证，然后点击 重新连接 (Reconnect)。
- “Meta 尚未验证此号码” — 请在 WhatsApp 管理器中完成该号码的验证（Meta 会向其发送验证码），然后点击 重新连接 (Reconnect)。
- “此号码托管在本地部署 API (On-Premises API) 上” — 它正在运行 WhatsApp 较旧的自托管产品，该产品无法与 Cloud API 共享号码。请先在 WhatsApp 管理器中将其迁移到 Cloud API。