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 步:购买电话号码
- 在左侧边栏中,点击底部的 Settings(设置)。
- 在“设置”左侧导航栏中,在 Channels(渠道)下方,点击 Channels(渠道)。
- 找到 WhatsApp Business API 卡片,点击绿色的 Connect WhatsApp(连接 WhatsApp)按钮。
- 选择 Get a new number from us(从我们这里获取新号码),然后选择 Managed by us(由我们管理)。

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

选择从我们这里获取新号码后,请选择由我们管理——这是推荐的连接方式。
- 将打开一个购买电话号码弹出窗口。选择一个国家/地区——号码和实时定价直接来自我们该国家/地区的运营商——并可选择通过包含数字进行筛选。

购买电话号码对话框 — 选择一个国家/地区以加载可用号码及其定价。
- 浏览出现的可用号码列表,每个号码旁边都会显示其一次性购买费用和月度费用。

选择国家/地区后,将列出可用号码及其购买成本和每月积分成本。
- 点击一个号码并填写其显示名称——即用户在 WhatsApp 上看到的商家名称。它必须包含字母;纯电话号码会被拒绝。然后确认显示的费用并完成购买。
在此处购买的号码仅用于 WhatsApp,不能用于短信 (SMS)。 通过平台购买的号码用于 WhatsApp Business。它们不是短信号码,也不是通话号码:呼入电话会转接至自动录音机(用于在设置过程中接听 WhatsApp 的验证电话),没有可供回听的语音信箱,也无法使用该号码拨出电话。短信功能需使用您自己的 Twilio 账户——请参阅 SMS。请勿告知客户购买的号码可以同时具备上述功能;它做不到。
购买时会从您的账户中扣除积分。此后,每个号码都有月租费以保持其活跃状态:每月至少 50 积分,高级号码的费用更高,具体取决于运营商的收费标准。号码在 设置 → 渠道 中的卡片始终显示其确切的月租价格,购买对话框也会在您确认前显示该价格。
该租金是该号码唯一的月度费用——它包含了 WhatsApp 连接费用,因此无需额外支付任何费用即可在 WhatsApp 上保留该号码。如果您已经在此处租用了号码,它们将在下一个计费周期转为该费率。请参阅 电话号码。
提示: 选择与您大多数客户所在国家/地区相同的号码。这有助于建立信任并可能降低消息发送成本。
墨西哥和阿根廷: 这些国家仅提供手机号码。WhatsApp 将这些号码视为手机号码,且只有手机号码才能接收 WhatsApp 的验证码——固定电话号码无法接收,因此未列出。这也意味着城市区号可能与您所在的城市不同;但这不会影响您的 WhatsApp 使用。
第 2 步:将号码连接到 Meta
购买的号码在能够发送和接收消息之前,仍需在 Meta 端进行激活:
- 在 Channels(渠道)页面上,WhatsApp Business API 卡片会在列表中显示您的新号码。
- 点击该号码对应的连接操作(Finish setup / 完成设置)— 系统会打开一个 Meta 弹窗,您需按照 Meta 的提示,使用拥有您 WhatsApp Business 账户的 Meta 账户完成连接。
- 当 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 555 123 4567)。 - (可选)输入显示名称——即您在 WhatsApp 上向他人发送消息时对方看到的名称。
- 点击继续前往 WhatsApp (Continue to WhatsApp),在 Meta 的窗口中完成连接。

连接 WhatsApp Business API 模态框 — 在输入号码前请阅读两条警告。
我们强烈建议不要连接您正在使用的个人 WhatsApp Business 号码——在此处连接它可能会干扰您现有的 WhatsApp 应用。请使用一个全新的号码。
在 Meta 的窗口中,添加并验证您自己的号码。 请勿选择 Meta 的免费测试号码(以 +1 555 开头)——它只能向您手动添加的少数几个测试联系人发送消息,因此无法触达真正的客户。如果您输入或选择了 Meta 的测试号码,连接将被拒绝。
迁移当前正在 WhatsApp 应用上使用的号码
当前在 WhatsApp 或 WhatsApp Business 应用中处于活跃注册状态的号码无法连接到 API —— 您必须先将其从应用中解除绑定。请按以下顺序操作:
- 请先保存应用中您需要的所有内容。 聊天记录不会迁移到 API,且删除账户的操作是永久性的 —— 在继续之前,请导出或备份重要的对话。
- 关闭应用中的双重验证(设置 → 账户 → 双重验证),以确保旧的 PIN 码不会干扰 API 注册。
- 删除应用中的账户:设置 → 账户 → 删除我的账户。这将释放该号码 —— 一个号码只能在应用或 API 上使用,不能同时存在。
- 等待几分钟让释放操作生效,然后按照上述连接步骤连接该号码。
警告: 删除账户会移除手机上该号码的所有聊天记录、群组和备份。请仅在确定该号码今后应在 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 窗口的电话号码步骤中:
- 选择添加新号码。
- 输入您的号码。
- 使用 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 个人资料是客户与您的业务互动时所看到的内容。
- 在渠道 (Channels) 页面上,找到您已激活 WhatsApp 的号码并打开其个人资料编辑器。
- 填写以下内容:
| 字段 | 描述 |
|---|---|
| 个人资料图片 | 您的企业徽标或照片(建议:正方形,至少 640x640px) |
| 类别 | 最能描述您业务的类别(例如:餐厅、零售、医疗保健)——必填 |
| 描述 | 对您业务的描述 |
| 关于 | 关于您业务的一行简短介绍 |
| 电子邮件 | 您的业务联系邮箱 |
| 网站 | 您的业务网站 URL |
| 地址 | 您的业务地址 |
- 保存以更新您的个人资料。
提示: 请填写所有个人资料字段。拥有专业且填写完整的个人资料的企业,更容易获得客户的互动。
每个号码对应一个智能助手
如果您的账户拥有多个 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 月的变更。
测试您的设置
在向客户正式发布之前,请验证一切是否正常工作:
- 发送测试消息。 打开分配给此号码的 AI 智能体或广播,使用其试用面板给自己发送一条测试消息,或者直接从聊天中发送。
- 测试传入消息。 从您的个人手机向您的企业号码发送一条 WhatsApp 消息,并确认它出现在聊天中。
- 测试 AI 回复。 确认智能体在预期时间内进行了回复,且其回答符合您的指令和知识库。
- 测试模板消息。 创建并批准一个简单的模板,将其发送到您的测试号码,并确认它已送达且所有变量均已填充。
故障排除
号码未显示为“活跃”
- 确保您已完成完整的激活流程,包括登录您的 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 智能体。