Your AI Connector Docs

WhatsApp Business API

通过官方 WhatsApp Business API 将您的业务连接到 WhatsApp。对于需要可靠、大批量 WhatsApp 消息发送,且需要预先批准的消息模板和送达跟踪功能的业务,此渠道是推荐选择。

无需单独的 Twilio 账户。 Twilio 是在后台为您发送 WhatsApp 消息的电话和消息服务。该平台会在后台为您创建一个托管的 Twilio 账户,因此您无需自行注册 Twilio 或手动将其连接到 Meta。购买号码或连接现有号码的操作完全在应用内完成。如果您特别需要使用自己的 Twilio 账户(例如,您已经在那里拥有预热过的号码和已批准的模板),请打开“渠道”页面上的 Twilio 账户卡片并切换到您自己的账户,然后关联您现有的发送方——这两个步骤都在 SMS 提供商(自带 Twilio 账户) 中有说明。大多数用户应使用托管设置。


前置条件

在开始之前,请确保您具备以下条件:

  • 一个 Meta 商务管理平台帐户 (business.facebook.com) —— 商务验证是可选的:未验证的商家也可以激活号码、获取模板批准并发送广播,起始限制为每 24 小时 250 个唯一联系人(请参阅下方的消息发送限制
  • 一个拥有足够额度的帐户
  • 一个尚未在 WhatsApp(个人版或商业版 App)上注册,且不是其他帐户下的 Twilio 号码的电话号码

请先添加您的企业名称和地址。 在购买第一个号码之前,请在 设置 → 企业(工作区组)下填写您的企业名称和地址。运营商会验证此地址,因此请确保其准确且完整——在设置完成前,购买操作将无法进行。

注意: 您用于 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(由我们管理)。
  1. 将打开一个购买电话号码弹出窗口。选择一个国家/地区——号码和实时定价直接来自我们该国家/地区的运营商——并可选择通过包含数字进行筛选。
  1. 浏览出现的可用号码列表,每个号码旁边都会显示其一次性购买费用和月度费用。
  1. 点击一个号码并填写其显示名称——即用户在 WhatsApp 上看到的商家名称。它必须包含字母;纯电话号码会被拒绝。然后确认显示的费用并完成购买。

在此处购买的号码仅用于 WhatsApp,不能用于短信 (SMS)。 通过平台购买的号码用于 WhatsApp Business。它们不是短信号码,也不是通话号码:呼入电话会转接至自动录音机(用于在设置过程中接听 WhatsApp 的验证电话),没有可供回听的语音信箱,也无法使用该号码拨出电话。短信功能需使用您自己的 Twilio 账户——请参阅 SMS。请勿告知客户购买的号码可以同时具备上述功能;它做不到。

购买时会从您的账户中扣除积分。此后,每个号码都有月租费以保持其活跃状态:每月至少 50 积分,高级号码的费用更高,具体取决于运营商的收费标准。号码在 设置 → 渠道 中的卡片始终显示其确切的月租价格,购买对话框也会在您确认前显示该价格。

该租金是该号码唯一的月度费用——它包含了 WhatsApp 连接费用,因此无需额外支付任何费用即可在 WhatsApp 上保留该号码。如果您已经在此处租用了号码,它们将在下一个计费周期转为该费率。请参阅 电话号码

提示: 选择与您大多数客户所在国家/地区相同的号码。这有助于建立信任并可能降低消息发送成本。

墨西哥和阿根廷: 这些国家仅提供手机号码。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. 等待几分钟让释放操作生效,然后按照上述连接步骤连接该号码。

警告: 删除账户会移除手机上该号码的所有聊天记录、群组和备份。请仅在确定该号码今后应在 API 上使用时才执行此操作。如果您希望继续在应用中使用该号码,请改用 WhatsApp Web 连接,或为 API 购买一个新号码。

想要拥有自己的 WhatsApp Business 账户而无需进行开发者设置?

Through our Meta app(通过我们的 Meta 应用)是同一个 Connect WhatsApp(连接 WhatsApp)按钮第二个问题的另一个选项。您保留自己的 WhatsApp Business 账户,但无需在 Meta 开发者网站上创建任何内容 — 您只需使用我们的 Meta 应用。Meta 会直接向您的 WhatsApp Business 账户收取对话费用如果您自带号码: 我们每月提供 50 个积分用于连接。如果您在此处租用号码: 无需额外费用,因为号码租金已包含连接费用。请参阅 通过我们的 Meta 应用连接

是否倾向于在您自己的 Meta 应用上运行 WhatsApp?

对于技术用户和代理机构,还有另一种选择:在 Meta 的开发者网站上创建您自己的应用并直接连接。Meta 会按其费率向您收费,我们不收取任何每条消息的费用,且您的客户只会看到您的企业名称。完整指南请参阅 连接您自己的 Meta 应用

对于任何使用您自己的 WhatsApp Business 账户的连接,Meta 会直接收取消息费用,而不是我们。 这包括上述 Managed by us(由我们管理)、Through our Meta app(通过我们的 Meta 应用)以及您自己的 Meta 应用连接。Meta 会向绑定到该 WhatsApp Business 账户的支付方式扣款;如果没有有效的支付方式,Meta 将会阻止广播、营销活动和模板消息,直到您添加为止。在首次发送前,请阅读 WhatsApp 费用与 2026 年 10 月的变更 — 其中也涵盖了 2026 年 10 月 1 日即将生效的定价变更。


连接注意事项

大多数新用户在 Meta 连接流程中都会遇到一些问题。请在开始激活前阅读这些内容。

选择您自己的号码,而不是 Meta 的测试号码

在 Meta 连接流程中,Meta 会为您提供一个测试电话号码(+1 555 范围内的示例号码),同时提供使用您自己号码的选项。请务必使用您自己的号码。 Meta 的测试号码可以接收消息,但只能发送给您在 Meta 内部手动添加的少数几个号码,因此它永远无法向真实客户发送消息——每一条回复都会静默发送失败。应用程序会阻止此操作:如果您输入或选择了 Meta 的测试号码,连接将被拒绝,并要求您改用真实号码。

您的号码必须最终出现在 WhatsApp Business 帐户中

这是连接在最后一步失败的最常见原因。选择 Meta 的测试号码,或者跳过电话号码步骤,会导致您选择的 WhatsApp Business 帐户中没有您的号码——这样我们就没有任何东西可以连接了。

在 Meta 窗口的电话号码步骤中:

  1. 选择添加新号码
  2. 输入您的号码。
  3. 使用 Meta 通过短信或电话发送给您的验证码进行验证

操作正确后,您的号码会出现在 WhatsApp 管理器 中该帐户的电话号码下方,并标记为已验证。如果连接失败,应用程序会明确告知您发生了哪种情况。

如果失败,请勿删除并重新创建内容

当连接失败时,人们很容易想到删除 WhatsApp Business 帐户并重新开始。请不要这样做。 删除绑定了您号码的帐户通常会使问题更难解决,并且重复的连接尝试可能会导致号码被 WhatsApp 暂时封禁——这可能会变成永久封禁。请阅读错误消息:它指出了具体问题和下一步操作。如果仍然无法连接,请提供电话号码和错误信息联系支持团队。

每个帐户都需要其专属的 WhatsApp Business 帐户

一个 WhatsApp Business 帐户一次只能链接到一个消息帐户,因此您不能在此处通过同一个 WhatsApp Business 帐户连接第二个号码——这种情况最常发生在代理机构及其子帐户之一,或者两个子帐户都指向同一个 Business 帐户时。Meta 仍然会显示连接成功,因为该号码确实已在那个 Business 帐户中通过验证并处于活动状态,但激活过程会在此处停止,并显示一条消息,指出已经在使用该号码的帐户。

有两种解决方法:

  • 在已经使用该 WhatsApp Business 帐户的帐户上连接该号码。 在那里添加更多号码可以正常工作。
  • 为该帐户提供其专属的 WhatsApp Business 帐户。 重新开始连接,并选择创建新的 WhatsApp Business 帐户,而不是选择现有的帐户。首先在 Meta 企业管理平台 中从旧的 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
地址 您的业务地址
  1. 保存以更新您的个人资料。

提示: 请填写所有个人资料字段。拥有专业且填写完整的个人资料的企业,更容易获得客户的互动。


每个号码对应一个智能助手

如果您的账户拥有多个 WhatsApp Business API 号码,每个号码都可以由不同的 AI 智能助手来回复。AI 智能助手页面上的谁来回复新对话面板显示了一个 WhatsApp 的按号码设置区块,其中包含每个已连接号码的选择器:与 WhatsApp 相同将沿用该渠道的智能助手;选择其他智能助手(或无人回复)则仅适用于该号码。回复始终通过客户发送消息的号码发出。详情请参阅:入口点 → 每个 WhatsApp 号码对应一个智能助手

了解消息发送限制

WhatsApp 实施消息发送限制以保护用户免受垃圾信息骚扰。这些限制决定了您在 24 小时滚动窗口内可以向多少个唯一联系人发送消息。

注意: 自 2025 年 10 月起,消息发送限制适用于业务组合 (business portfolio) 级别,而非按电话号码计算。您组合中的所有电话号码共享相同的限制。

层级系统

层级 24 小时内唯一联系人数量 如何达成
未验证 250 新的、未验证企业的默认值
已验证 2,000 完成企业验证
第 2 层级 10,000 保持高质量的消息发送
第 3 层级 100,000 持续保持大规模的高质量发送
无限制 无限制 卓越的质量记录

如何提高您的限制

  • 验证您的企业:在 Meta Business Manager 上验证您的企业,以将初始的 250 个联系人上限提升至 2,000 个。
  • 保持高质量的消息:避免被收件人举报或屏蔽。
  • 持续发送消息:当您达到当前上限的一半左右且保持良好的质量评分时,WhatsApp 会自动提升您的层级,通常在满足条件后的 6 小时内完成。

重要提示: 这些限制仅适用于企业发起的对话(模板消息)。客户主动发起的对话(即客户先给您发送消息)不计入您的限制。


消息类型

会话消息(自由格式)

您可以在活跃的对话窗口内发送的常规文本、图片、视频、文档和其他媒体。

  • 可以包含任何内容
  • 只能在 24 小时消息窗口内发送(见下文)
  • 无需预先批准

模板消息

预先批准的消息格式,允许您在 24 小时窗口之外与客户发起对话。

  • 使用前必须提交给 Meta 审批
  • 支持用于个性化的变量(例如:客户姓名、订单号)
  • 发起新对话或在 24 小时后重新互动时必须使用
  • 提供多种语言版本

模板现在位于其专属页面 — 请参阅 WhatsApp 消息模板 获取完整指南。

注意: 模板审批通常需要几分钟到几小时,但在某些情况下可能需要长达 24 小时。


24 小时消息窗口

为了保护用户,WhatsApp 强制执行 24 小时对话窗口:

  • 当客户给您发送消息时,会开启一个 24 小时窗口。在此窗口期间,您可以自由发送任何类型的消息(会话消息)。
  • 在 24 小时无活动后(客户未发送消息),窗口关闭。您只能使用已批准的模板消息重新发起互动。
  • 当您发送模板消息时,一旦客户回复,就会开启一个新的 24 小时窗口。
场景 您可以发送的内容
客户刚给您发送了消息(24 小时内) 任何消息类型 — 文本、图片、文档等
距离客户最后一条消息已超过 24 小时 仅限已批准的模板消息
客户回复了您的模板消息 任何消息类型(已开启新的 24 小时窗口)

提示: 处理此渠道的 AI 智能体会在 24 小时窗口内自动回复。若要在窗口关闭后重新发起互动,请在您的广播或智能体设置中配置跟进模板 — 请参阅 AI 智能体

在此窗口内的回复将于 2026 年 10 月 1 日起不再免费。 Meta 已宣布,自该日期起,企业在 24 小时窗口内发送的自由格式回复将按每条消息收费,费率与各市场的费率一致——即与目前工具类和身份验证类模板的费用相同。自 2024 年 11 月起,这些回复一直是免费的。每个电话号码每月首先享有 1,000 条免费服务消息额度,仅从第 1,001 条消息开始收费;费率即为 Meta 费率卡中已有的各市场工具类消息费率。这对您意味着什么,以及在此之前需要检查哪些内容,请参阅 WhatsApp 成本与 2026 年 10 月的变更


测试您的设置

在向客户正式发布之前,请验证一切是否正常工作:

  1. 发送测试消息。 打开分配给此号码的 AI 智能体或广播,使用其试用面板给自己发送一条测试消息,或者直接从聊天中发送。
  2. 测试传入消息。 从您的个人手机向您的企业号码发送一条 WhatsApp 消息,并确认它出现在聊天中。
  3. 测试 AI 回复。 确认智能体在预期时间内进行了回复,且其回答符合您的指令和知识库。
  4. 测试模板消息。 创建并批准一个简单的模板,将其发送到您的测试号码,并确认它已送达且所有变量均已填充。

故障排除

号码未显示为“活跃”

  • 确保您已完成完整的激活流程,包括登录您的 Meta Business 账户并授予权限。
  • 检查您的 Meta Business 账户状态是否良好。
  • 等待几分钟并刷新页面 — 激活可能需要一些时间。

消息无法发送

  • 验证您的账户中是否有足够的额度。
  • 检查您是否已达到消息发送限额等级。
  • 确保收件人的电话号码采用正确的国际格式(例如 +1234567890)。
  • 如果在 24 小时窗口外发送,请确保您使用的是已批准的模板。

广播和模板被阻止,但回复功能仍然有效

这种模式(即您可以回复主动联系您的人,但您发起的任何消息都无法发出)几乎总是意味着该号码背后的 WhatsApp Business Account 没有有效的支付方式,且仅适用于使用您自己的 WhatsApp Business Account 运行的连接。Meta 会阻止企业发起的对话(广播、营销活动、任何模板),直到账户中绑定有效的支付方式,并在 WhatsApp 管理工具中报告该错误。

在这种情况下,应用现在会在发送前停止广播或营销活动,并提示您添加支付方式,而不是任由每条消息发送失败。请在 WhatsApp 管理工具中添加或修复支付方式后再重新发送 —— 在此处重新连接号码无法解决此问题。请参阅 WhatsApp 费用与 2026 年 10 月的变更

模板被拒绝

  • 查看 Meta 的模板指南 — 某些类别的模板不能包含促销内容。
  • 检查是否存在格式问题,例如占位符不匹配。
  • 阅读 Meta 提供的拒绝原因,修改后重新提交 — 请参阅 WhatsApp 消息模板

消息质量评分较低

  • 检查您的消息内容,确保其对收件人具有相关性和价值。
  • 避免向未选择加入的联系人发送消息。
  • 如果收件人正在举报或屏蔽您,请降低消息发送频率。

“未找到电话号码”错误

  • 该电话号码可能未正确关联到您的 Meta Business 账户。
  • 尝试通过 WhatsApp 连接流程重新激活该电话号码。
  • 如果问题仍然存在,请联系支持团队。

最佳实践

  • 务必获得同意后再向 WhatsApp 上的客户发送消息。
  • 快速响应客户消息,以充分利用 24 小时窗口。
  • 保持模板简洁且有价值 — 高质量的模板审批速度更快,表现也更好。
  • 监控您的质量评分(在 Meta Business Manager 中),以避免评级降级。
  • 让 AI 智能体处理回复,以确保在消息窗口内实现 24/7 全天候响应 — 请参阅 AI 智能体