# WhatsApp Business API 通过官方 WhatsApp Business API 将您的业务连接到 WhatsApp。对于需要可靠、大批量 WhatsApp 消息发送，且需要预先批准的消息模板和送达跟踪功能的业务，此渠道是推荐选择。 > **无需单独的 Twilio 账户。** Twilio 是在后台为您发送 WhatsApp 消息的电话和消息服务。该平台会在后台为您创建一个托管的 Twilio 账户，因此您无需自行注册 Twilio 或手动将其连接到 Meta。购买号码或连接现有号码的操作完全在应用内完成。如果您特别需要使用自己的 Twilio 账户（例如，您已经在那里拥有预热过的号码和已批准的模板），请打开“渠道”页面上的 **Twilio 账户**卡片并切换到您自己的账户，然后关联您现有的发送方——这两个步骤都在 [SMS 提供商（自带 Twilio 账户）](../settings/sms-provider.md) 中有说明。大多数用户应使用托管设置。 --- ## 前置条件 在开始之前，请确保您具备以下条件： - 一个 **Meta 商务管理平台帐户** (business.facebook.com) —— 商务**验证是可选的**：未验证的商家也可以激活号码、获取模板批准并发送广播，起始限制为每 24 小时 250 个唯一联系人（请参阅下方的[消息发送限制](#understanding-messaging-limits)） - 一个拥有足够额度的帐户 - 一个**尚未**在 WhatsApp（个人版或商业版 App）上注册，且不是其他帐户下的 Twilio 号码的电话号码 > **请先添加您的企业名称和地址。** 在购买第一个号码之前，请在 **设置 → 企业**（工作区组）下填写您的**企业名称和地址**。运营商会验证此地址，因此请确保其准确且完整——在设置完成前，购买操作将无法进行。 ::: note **注意：** 您用于 WhatsApp Business API 的电话号码不能同时用于常规 WhatsApp 应用程序。如果您想继续使用个人 WhatsApp，请通过平台购买一个新号码，或者使用 **WhatsApp Web**，它允许您通过配对手机连接现有号码，而无需将其从常规应用程序中移除。这是两条独立的路径：您在此处购买的号码是一个没有关联手机的虚拟号码，因此它只能用于 Business API —— 它永远无法与 WhatsApp Web 配对。 ::: --- ## 第 1 步：购买电话号码 1. 在左侧边栏中，点击底部的 **Settings**（设置）。 2. 在“设置”左侧导航栏中，在 **Channels**（渠道）下方，点击 **Channels**（渠道）。 3. 找到 **WhatsApp Business API** 卡片，点击绿色的 **Connect WhatsApp**（连接 WhatsApp）按钮。 4. 选择 **Get a new number from us**（从我们这里获取新号码），然后选择 **Managed by us**（由我们管理）。 4. 将打开一个**购买电话号码**弹出窗口。选择一个**国家/地区**——号码和实时定价直接来自我们该国家/地区的运营商——并可选择通过**包含数字**进行筛选。 5. 浏览出现的**可用号码**列表，每个号码旁边都会显示其一次性购买费用和月度费用。 6. 点击一个号码并填写其**显示名称**——即用户在 WhatsApp 上看到的商家名称。它必须包含字母；纯电话号码会被拒绝。然后确认显示的费用并完成购买。 > **在此处购买的号码仅用于 WhatsApp，不能用于短信 (SMS)。** 通过平台购买的号码用于 WhatsApp Business。它们**不是**短信号码，也**不是**通话号码：呼入电话会转接至自动录音机（用于在设置过程中接听 WhatsApp 的验证电话），没有可供回听的语音信箱，也无法使用该号码拨出电话。短信功能需使用**您自己**的 Twilio 账户——请参阅 [SMS](sms.md)。请勿告知客户购买的号码可以同时具备上述功能；它做不到。 购买时会从您的账户中扣除积分。此后，每个号码都有**月租费**以保持其活跃状态：**每月至少 50 积分**，高级号码的费用更高，具体取决于运营商的收费标准。号码在 **设置 → 渠道** 中的卡片始终显示其确切的月租价格，购买对话框也会在您确认前显示该价格。 该租金是该号码唯一的月度费用——它包含了 WhatsApp 连接费用，因此无需额外支付任何费用即可在 WhatsApp 上保留该号码。如果您已经在此处租用了号码，它们将在下一个计费周期转为该费率。请参阅 [电话号码](../settings/phone-numbers.md#monthly-phone-number-billing)。 ::: tip **提示：** 选择与您大多数客户所在国家/地区相同的号码。这有助于建立信任并可能降低消息发送成本。 ::: > **墨西哥和阿根廷：** 这些国家仅提供手机号码。WhatsApp 将这些号码视为手机号码，且只有手机号码才能接收 WhatsApp 的验证码——固定电话号码无法接收，因此未列出。这也意味着城市区号可能与您所在的城市不同；但这不会影响您的 WhatsApp 使用。 --- ## 第 2 步：将号码连接到 Meta 购买的号码在能够发送和接收消息之前，仍需在 Meta 端进行激活： 1. 在 **Channels**（渠道）页面上，WhatsApp Business API 卡片会在列表中显示您的新号码。 2. 点击该号码对应的连接操作（**Finish setup** / 完成设置）— 系统会打开一个 Meta 弹窗，您需按照 Meta 的提示，使用拥有您 WhatsApp Business 账户的 Meta 账户完成连接。 3. 当 Meta 确认连接后，该号码会自动上线 — 无需单独的“发布”步骤。一旦连接在线，其状态会自动切换为 **Active**（活跃）。 系统将要求您登录 Meta Business 账户，并授予平台代表您发送和接收 WhatsApp 消息的权限。 > **激活通常是自动完成的。** 这需要几分钟时间，在大多数情况下，您不需要接听验证电话或输入验证码。有时 Meta 会将号码保持在“待处理 (Pending)”状态；如果发生这种情况，请按照屏幕上的提示通过电话进行验证。如果号码多次注册失败，可能是 WhatsApp 暂时对其进行了速率限制——请等待 24 小时后再试，或联系支持团队。 ### 已经拥有自己的 Meta Cloud API 号码？ 您不必通过本平台购买。在 WhatsApp Business API 卡片上，点击 **Connect WhatsApp**（连接 WhatsApp），选择 **Use a number you already have**（使用您现有的号码），然后选择 **Managed by us**（由我们管理）以打开 **Connect WhatsApp Business API**（连接 WhatsApp Business API）模态框： 1. 输入该号码的**电话号码**，使用国际格式（例如 `+1 555 123 4567`）。 2. （可选）输入**显示名称**——即您在 WhatsApp 上向他人发送消息时对方看到的名称。 3. 点击**继续前往 WhatsApp (Continue to WhatsApp)**，在 Meta 的窗口中完成连接。 > **我们强烈建议不要连接您正在使用的个人 WhatsApp Business 号码**——在此处连接它可能会干扰您现有的 WhatsApp 应用。请使用一个全新的号码。 > **在 Meta 的窗口中，添加并验证您自己的号码。** 请勿选择 Meta 的免费测试号码（以 +1 555 开头）——它只能向您手动添加的少数几个测试联系人发送消息，因此无法触达真正的客户。如果您输入或选择了 Meta 的测试号码，连接将被拒绝。 ### 迁移当前正在 WhatsApp 应用上使用的号码 当前在 WhatsApp 或 WhatsApp Business 应用中处于活跃注册状态的号码无法连接到 API —— 您必须先将其从应用中解除绑定。请按以下顺序操作： 1. **请先保存应用中您需要的所有内容。** 聊天记录**不会**迁移到 API，且删除账户的操作是永久性的 —— 在继续之前，请导出或备份重要的对话。 2. **关闭应用中的双重验证**（**设置 → 账户 → 双重验证**），以确保旧的 PIN 码不会干扰 API 注册。 3. **删除应用中的账户**：**设置 → 账户 → 删除我的账户**。这将释放该号码 —— 一个号码只能在应用或 API 上使用，不能同时存在。 4. **等待几分钟**让释放操作生效，然后按照[上述连接步骤](#already-have-your-own-meta-cloud-api-number)连接该号码。 ::: warning **警告：** 删除账户会移除手机上该号码的所有聊天记录、群组和备份。请仅在确定该号码今后应在 API 上使用时才执行此操作。如果您希望继续在应用中使用该号码，请改用 [WhatsApp Web](whatsapp-web.md) 连接，或为 API 购买一个新号码。 ::: ### 想要拥有自己的 WhatsApp Business 账户而无需进行开发者设置？ **Through our Meta app**（通过我们的 Meta 应用）是同一个 **Connect WhatsApp**（连接 WhatsApp）按钮第二个问题的另一个选项。您保留自己的 WhatsApp Business 账户，但无需在 Meta 开发者网站上创建任何内容 — 您只需使用我们的 Meta 应用。**Meta 会直接向您的 WhatsApp Business 账户收取对话费用**。**如果您自带号码：** 我们每月提供 50 个积分用于连接。**如果您在此处租用号码：** 无需额外费用，因为号码租金已包含连接费用。请参阅 [通过我们的 Meta 应用连接](connect-through-our-meta-app.md)。 ### 是否倾向于在您自己的 Meta 应用上运行 WhatsApp？ 对于技术用户和代理机构，还有另一种选择：在 Meta 的开发者网站上创建您自己的应用并直接连接。Meta 会按其费率向您收费，我们不收取任何每条消息的费用，且您的客户只会看到您的企业名称。完整指南请参阅 [连接您自己的 Meta 应用](connect-your-own-meta-app.md)。 > **对于任何使用您自己的 WhatsApp Business 账户的连接，Meta 会直接收取消息费用，而不是我们。** 这包括上述 **Managed by us**（由我们管理）、**Through our Meta app**（通过我们的 Meta 应用）以及您自己的 Meta 应用连接。Meta 会向绑定到该 WhatsApp Business 账户的支付方式扣款；如果没有有效的支付方式，Meta 将会阻止广播、营销活动和模板消息，直到您添加为止。在首次发送前，请阅读 [WhatsApp 费用与 2026 年 10 月的变更](whatsapp-pricing.md) — 其中也涵盖了 2026 年 10 月 1 日即将生效的定价变更。 --- ## 连接注意事项 大多数新用户在 Meta 连接流程中都会遇到一些问题。请在开始激活前阅读这些内容。 ### 选择您自己的号码，而不是 Meta 的测试号码 在 Meta 连接流程中，Meta 会为您提供一个**测试电话号码**（+1 555 范围内的示例号码），同时提供使用您自己号码的选项。**请务必使用您自己的号码。** Meta 的测试号码可以接收消息，但只能发送给您在 Meta 内部手动添加的少数几个号码，因此它永远无法向真实客户发送消息——每一条回复都会静默发送失败。应用程序会阻止此操作：如果您输入或选择了 Meta 的测试号码，连接将被拒绝，并要求您改用真实号码。 ### 您的号码必须最终出现在 WhatsApp Business 帐户中 这是连接在最后一步失败的最常见原因。选择 Meta 的测试号码，或者跳过电话号码步骤，会导致您选择的 WhatsApp Business 帐户中**没有您的号码**——这样我们就没有任何东西可以连接了。 在 Meta 窗口的电话号码步骤中： 1. 选择**添加新号码**。 2. 输入您的号码。 3. 使用 Meta 通过短信或电话发送给您的验证码**进行验证**。 操作正确后，您的号码会出现在 [WhatsApp 管理器](https://business.facebook.com/) 中该帐户的**电话号码**下方，并标记为已验证。如果连接失败，应用程序会明确告知您发生了哪种情况。 ### 如果失败，请勿删除并重新创建内容 当连接失败时，人们很容易想到删除 WhatsApp Business 帐户并重新开始。**请不要这样做。** 删除绑定了您号码的帐户通常会使问题更难解决，并且重复的连接尝试可能会导致号码被 WhatsApp 暂时封禁——这可能会变成永久封禁。请阅读错误消息：它指出了具体问题和下一步操作。如果仍然无法连接，请提供电话号码和错误信息联系支持团队。 ### 每个帐户都需要其专属的 WhatsApp Business 帐户 一个 WhatsApp Business 帐户一次只能链接到**一个**消息帐户，因此您不能在此处通过同一个 WhatsApp Business 帐户连接第二个号码——这种情况最常发生在代理机构及其子帐户之一，或者两个子帐户都指向同一个 Business 帐户时。Meta 仍然会显示连接成功，因为该号码确实已在那个 Business 帐户中通过验证并处于活动状态，但激活过程会在此处停止，并显示一条消息，指出已经在使用该号码的帐户。 有两种解决方法： - **在已经使用该 WhatsApp Business 帐户的帐户上连接该号码。** 在那里添加更多号码可以正常工作。 - **为该帐户提供其专属的 WhatsApp Business 帐户。** 重新开始连接，并选择**创建新的 WhatsApp Business 帐户**，而不是选择现有的帐户。首先在 [Meta 企业管理平台](https://business.facebook.com/) 中从旧的 Business 帐户中删除该号码，因为一个号码只能属于其中一个帐户。 请勿删除现有的 WhatsApp Business 账户以释放它——该账户上正在运行的号码将停止工作。 ### 不要重复使用已关联到其他 BSP 的 WhatsApp Business 账户 如果您的 WhatsApp Business 账户 (WABA) 已经关联到另一个 **BSP**（业务服务提供商——即之前连接过的其他平台），则此处的连接将失败，且无法通过重试来修复；激活过程会停止，并显示一条消息，提示该业务账户已在其他地方关联。为避免这种情况，请**在 Meta Business Manager 中创建一个全新的 WhatsApp Business 账户**用于此连接，而不是重复使用已在其他地方配置过的账户。 --- ## 第 3 步：设置您的 WhatsApp Business 个人资料 您的 WhatsApp Business 个人资料是客户与您的业务互动时所看到的内容。 1. 在**渠道 (Channels)** 页面上，找到您已激活 WhatsApp 的号码并打开其个人资料编辑器。 2. 填写以下内容： | 字段 | 描述 | |---|---| | **个人资料图片** | 您的企业徽标或照片（建议：正方形，至少 640x640px） | | **类别** | 最能描述您业务的类别（例如：餐厅、零售、医疗保健）——必填 | | **描述** | 对您业务的描述 | | **关于** | 关于您业务的一行简短介绍 | | **电子邮件** | 您的业务联系邮箱 | | **网站** | 您的业务网站 URL | | **地址** | 您的业务地址 | 3. 保存以更新您的个人资料。 ::: tip **提示：** 请填写所有个人资料字段。拥有专业且填写完整的个人资料的企业，更容易获得客户的互动。 ::: --- ## 每个号码对应一个智能助手 如果您的账户拥有多个 WhatsApp Business API 号码，每个号码都可以由不同的 AI 智能助手来回复。AI 智能助手页面上的**谁来回复新对话**面板显示了一个 WhatsApp 的**按号码**设置区块，其中包含每个已连接号码的选择器：**与 WhatsApp 相同**将沿用该渠道的智能助手；选择其他智能助手（或**无人回复**）则仅适用于该号码。回复始终通过客户发送消息的号码发出。详情请参阅：[入口点 → 每个 WhatsApp 号码对应一个智能助手](../ai-agents/entry-points.md#one-agent-per-whatsapp-number)。 ## 了解消息发送限制 WhatsApp 实施消息发送限制以保护用户免受垃圾信息骚扰。这些限制决定了您在 24 小时滚动窗口内可以向多少个唯一联系人发送消息。 ::: note **注意：** 自 2025 年 10 月起，消息发送限制适用于**业务组合 (business portfolio) 级别**，而非按电话号码计算。您组合中的所有电话号码共享相同的限制。 ::: ### 层级系统 | 层级 | 24 小时内唯一联系人数量 | 如何达成 | |---|---|---| | **未验证** | 250 | 新的、未验证企业的默认值 | | **已验证** | 2,000 | 完成企业验证 | | **第 2 层级** | 10,000 | 保持高质量的消息发送 | | **第 3 层级** | 100,000 | 持续保持大规模的高质量发送 | | **无限制** | 无限制 | 卓越的质量记录 | ### 如何提高您的限制 - **验证您的企业**：在 Meta Business Manager 上验证您的企业，以将初始的 250 个联系人上限提升至 2,000 个。 - **保持高质量的消息**：避免被收件人举报或屏蔽。 - **持续发送消息**：当您达到当前上限的一半左右且保持良好的质量评分时，WhatsApp 会自动提升您的层级，通常在满足条件后的 6 小时内完成。 ::: warning **重要提示：** 这些限制仅适用于**企业发起**的对话（模板消息）。客户主动发起的对话（即客户先给您发送消息）不计入您的限制。 ::: --- ## 消息类型 ### 会话消息（自由格式） 您可以在活跃的对话窗口内发送的常规文本、图片、视频、文档和其他媒体。 - 可以包含任何内容 - 只能在 **24 小时消息窗口**内发送（见下文） - 无需预先批准 ### 模板消息 预先批准的消息格式，允许您在 24 小时窗口之外与客户发起对话。 - 使用前必须提交给 Meta 审批 - 支持用于个性化的变量（例如：客户姓名、订单号） - 发起新对话或在 24 小时后重新互动时必须使用 - 提供多种语言版本 模板现在位于其专属页面 — 请参阅 [WhatsApp 消息模板](../templates/whatsapp-templates.md) 获取完整指南。 ::: note **注意：** 模板审批通常需要几分钟到几小时，但在某些情况下可能需要长达 24 小时。 ::: --- ## 24 小时消息窗口 为了保护用户，WhatsApp 强制执行 24 小时对话窗口： - **当客户给您发送消息时**，会开启一个 24 小时窗口。在此窗口期间，您可以自由发送任何类型的消息（会话消息）。 - **在 24 小时无活动后**（客户未发送消息），窗口关闭。您只能使用已批准的**模板消息**重新发起互动。 - **当您发送模板消息时**，一旦客户回复，就会开启一个新的 24 小时窗口。 | 场景 | 您可以发送的内容 | |---|---| | 客户刚给您发送了消息（24 小时内） | 任何消息类型 — 文本、图片、文档等 | | 距离客户最后一条消息已超过 24 小时 | 仅限已批准的模板消息 | | 客户回复了您的模板消息 | 任何消息类型（已开启新的 24 小时窗口） | ::: tip **提示：** 处理此渠道的 AI 智能体会在 24 小时窗口内自动回复。若要在窗口关闭后重新发起互动，请在您的广播或智能体设置中配置跟进模板 — 请参阅 [AI 智能体](../ai-agents/ai-agents.md)。 ::: > **在此窗口内的回复将于 2026 年 10 月 1 日起不再免费。** Meta 已宣布，自该日期起，企业在 24 小时窗口内发送的自由格式回复将按每条消息收费，费率与各市场的费率一致——即与目前工具类和身份验证类模板的费用相同。自 2024 年 11 月起，这些回复一直是免费的。每个电话号码每月首先享有 1,000 条免费服务消息额度，仅从第 1,001 条消息开始收费；费率即为 Meta 费率卡中已有的各市场工具类消息费率。这对您意味着什么，以及在此之前需要检查哪些内容，请参阅 [WhatsApp 成本与 2026 年 10 月的变更](whatsapp-pricing.md)。 --- ## 测试您的设置 在向客户正式发布之前，请验证一切是否正常工作： 1. **发送测试消息。** 打开分配给此号码的 AI 智能体或广播，使用其**试用**面板给自己发送一条测试消息，或者直接从**聊天**中发送。 2. **测试传入消息。** 从您的个人手机向您的企业号码发送一条 WhatsApp 消息，并确认它出现在**聊天**中。 3. **测试 AI 回复。** 确认智能体在预期时间内进行了回复，且其回答符合您的指令和知识库。 4. **测试模板消息。** 创建并批准一个简单的模板，将其发送到您的测试号码，并确认它已送达且所有变量均已填充。 --- ## 故障排除 ### 号码未显示为“活跃” - 确保您已完成完整的激活流程，包括登录您的 Meta Business 账户并授予权限。 - 检查您的 Meta Business 账户状态是否良好。 - 等待几分钟并刷新页面 — 激活可能需要一些时间。 ### 消息无法发送 - 验证您的账户中是否有足够的额度。 - 检查您是否已达到消息发送限额等级。 - 确保收件人的电话号码采用正确的国际格式（例如 +1234567890）。 - 如果在 24 小时窗口外发送，请确保您使用的是已批准的模板。 ### 广播和模板被阻止，但回复功能仍然有效 这种模式（即您可以回复主动联系您的人，但您发起的任何消息都无法发出）几乎总是意味着该号码背后的 WhatsApp Business Account 没有有效的支付方式，且仅适用于使用**您自己**的 WhatsApp Business Account 运行的连接。Meta 会阻止企业发起的对话（广播、营销活动、任何模板），直到账户中绑定有效的支付方式，并在 [WhatsApp 管理工具](https://business.facebook.com/)中报告该错误。 在这种情况下，应用现在会在发送前停止广播或营销活动，并提示您添加支付方式，而不是任由每条消息发送失败。请在 WhatsApp 管理工具中添加或修复支付方式后再重新发送 —— 在此处重新连接号码无法解决此问题。请参阅 [WhatsApp 费用与 2026 年 10 月的变更](whatsapp-pricing.md#if-you-use-your-own-whatsapp-business-account-check-your-payment-method)。 ### 模板被拒绝 - 查看 Meta 的模板指南 — 某些类别的模板不能包含促销内容。 - 检查是否存在格式问题，例如占位符不匹配。 - 阅读 Meta 提供的拒绝原因，修改后重新提交 — 请参阅 [WhatsApp 消息模板](../templates/whatsapp-templates.md)。 ### 消息质量评分较低 - 检查您的消息内容，确保其对收件人具有相关性和价值。 - 避免向未选择加入的联系人发送消息。 - 如果收件人正在举报或屏蔽您，请降低消息发送频率。 ### “未找到电话号码”错误 - 该电话号码可能未正确关联到您的 Meta Business 账户。 - 尝试通过 WhatsApp 连接流程重新激活该电话号码。 - 如果问题仍然存在，请联系支持团队。 --- ## 最佳实践 - **务必获得同意**后再向 WhatsApp 上的客户发送消息。 - **快速响应**客户消息，以充分利用 24 小时窗口。 - **保持模板简洁且有价值** — 高质量的模板审批速度更快，表现也更好。 - **监控您的质量评分**（在 Meta Business Manager 中），以避免评级降级。 - **让 AI 智能体处理回复**，以确保在消息窗口内实现 24/7 全天候响应 — 请参阅 [AI 智能体](../ai-agents/ai-agents.md)。