DM Champ Docs

WhatsApp Business API

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

Prefer to see it? Click through the whole flow:

无需单独的 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(由我们管理)。
“渠道”页面,显示了 WhatsApp Business API 卡片及其“连接 WhatsApp”按钮,已连接的号码以行形式列在卡片上

WhatsApp Business API 卡片有一个连接 WhatsApp 按钮——它会询问您要使用哪个号码,然后询问如何连接它。您的号码会以行形式显示在卡片上。

“连接 WhatsApp”对话框询问您希望如何连接,包含“由我们管理”(标记为“推荐”)和“通过我们的 Meta 应用”选项

选择从我们这里获取新号码后,请选择由我们管理——这是推荐的连接方式。

  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 API 模态框,包含关于不要使用活跃个人号码或 Meta 测试号码的警告,以及“电话号码”和“显示名称”字段

连接 WhatsApp Business API 模态框 — 在输入号码前请阅读两条警告。

我们强烈建议不要连接您正在使用的个人 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 账户状态是否良好。
  • 等待几分钟并刷新页面 — 激活可能需要一些时间。

号码显示为离线

设置 → 渠道 下,号码旁边的 离线 徽章表示 WhatsApp 本身已停止该号码发送消息。将鼠标悬停在徽章上即可查看原因。最常见的原因是 Meta 禁用了该号码背后的 WhatsApp Business 账户,通常是因为政策问题;此时徽章会显示相关说明,并引导您前往 Meta Business Manager,您可以在那里查看通知并进行申诉。

当号码处于离线状态时,来自该号码的广播消息会在发送前被拦截,而不是逐条发送失败,且来自该号码的自动回复也无法发出。我们每天会针对通过此设置连接的每个号码向 WhatsApp 进行一次核查,并在某个号码离线时通过电子邮件通知您;一旦 WhatsApp 报告该号码恢复在线,徽章会自动变回绿色。如果您已经在 Meta 端解决了问题且不想等待,请打开该号码并重新连接以立即进行检查。因号码离线而无法发送的消息不会被扣费。

消息无法发送

  • 验证您的账户中是否有足够的额度。
  • 检查您是否已达到消息发送限额等级。
  • 确保收件人的电话号码采用正确的国际格式(例如 +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 智能体