您现在可以将连接的 WhatsApp 360dialog 帐户迁移到 respond.io WhatsApp Business API，以享受更高的可靠性、更低的成本以及对新功能的访问。 了解有关 迁移流程 的更多信息。
要连接 WhatsApp Cloud API，需要启用 WhatsApp 产品的 Facebook 应用程序。 阅读此 指南 了解如何设置您的 Facebook 应用。
Facebook 于 5 月 20 日宣布发布 WhatsApp Cloud API，任何规模的企业都可以使用官方 WhatsApp API 与客户进行沟通。
由于 WhatsApp 规定，此频道的消息传递窗口仅限 24 小时。 在 此处 了解有关 WhatsApp 的企业政策。
连接 WhatsApp 云 API
观看下面的视频，了解如何将 WhatsApp Cloud API 连接到 respond.io 的分步指南。
要通过 WhatsApp Cloud API 与您的客户聊天，请连接 WhatsApp 商业资料和 Meta 商业账户。
需要 Facebook App 和 Meta Business Account，并且您必须是两者的管理员才能连接。
步骤 1： 前往 工作区设置 > 点击 添加频道
步骤 2： 找到 WhatsApp Cloud API 频道 > 单击 连接。
步骤 3： 单击连接 Facebook按钮。
步骤 4： 使用具有 Facebook App 和 Meta 商业帐户管理员访问权限的 Facebook 帐户登录。
步骤 5： 在下拉列表中，选择您想要连接的 WABA 名称和 WhatsApp 号码。
步骤 6：添加回调 URL。 返回 Facebook 开发者应用的 WhatsApp 部分。 导航到 配置 子部分并设置回调 URL。 将生成的回调 URL 和来自 respond.io 的令牌添加到 webhook 对话框中的相应字段。
第 7 步： 在 Facebook 应用程序上，验证并保存对应用程序的更改。
步骤 8：订阅 webhook 事件。 在您的 Facebook 应用中，在 Products 面板下选择 Webhooks 选项卡，然后在下拉列表中选择 WhatsApp Business Account。 点击订阅消息事件。
步骤 9：单击页面顶部的切换按钮以打开实时模式。
请记住填写您的隐私政策URL。 如果为空白，您将不被允许打开实时模式。
第 10 步：单击保存更改以完成设置。
一旦您完成设置，发送到您的 WhatsApp 号码的任何消息将会在您的工作区中接收。
通道配置
WhatsApp Cloud API 频道可以配置唯一的频道名称。
步骤 1： 前往 工作区设置 > 点击 频道。
步骤 2： 找到 WhatsApp Cloud API 频道 > 单击 管理。
步骤 3： 配置频道名称，该名称用于内部识别帐户。
步骤 4： 点击 保存更改 以更新频道配置。
频道接收的元数据
不同的渠道向 respond.io 平台提供不同的联系人元数据集。 以下是您可以从此渠道获取的联系人数据列表：
电话号码
电话号码
配置文件名称
Whatsapp ID
管理 WhatsApp Cloud API 配置文件
如果需要更改或检查您的 WhatsApp Cloud API 配置文件，可以在 respond.io 平台上进行。
步骤 1： 前往 工作区设置 > 点击 频道。
步骤 2： 找到 WhatsApp Cloud API 频道 > 单击 管理 > 个人资料。
步骤 3：单击同步个人资料以从 WhatsApp 获取最新的 WhatsApp 商业个人资料信息。
步骤 4：根据需要编辑以下信息。
字段 | 描述 |
|---|---|
个人资料照片 | 该图像显示为 WhatsApp 商业帐户的个人资料图片。建议图像尺寸为 640x640。 |
关于 | 该文本出现在企业的个人资料中，位于其个人资料图片、电话号码和联系按钮下方。 此文本出现在企业'的个人资料中，位于其个人资料图片、电话号码和联系按钮下方。 |
地址 | 企业地址。 最多 256 个字符。 |
描述 | 业务描述。 最多 512 个字符。 |
电子邮件 | 用于联系企业的电子邮件地址（有效的电子邮件格式）。 最多 128 个字符。 |
垂直的 | 企业所属行业。 必须是以下可接受值之一：汽车、美容、水疗和沙龙、服装和服饰、教育、娱乐、活动策划与服务、金融和银行、食品杂货、公共服务、酒店住宿、医疗卫生、非营利、专业服务、购物和零售、旅行与交通、餐厅、其他。业务垂直领域在创建后不能被设置为空值。 |
网站 | 与企业相关的 URL（包括 http:// 或 https://）（例如，网站、Facebook 页面、Instagram）。 最多 2 个网站，每个网站最多 256 个字符。 |
步骤 5：查看信息并单击“保存更改”。
管理 WhatsApp 消息模板
在向 respond.io 平台上的联系人发送消息模板之前，请确保您'已完成以下操作：
- 提交消息模板以供审批 - 通过同步消息模板将已批准的消息模板添加到工作区
提交消息模板
步骤 1： 前往 工作区设置 > 点击 频道。
步骤 2： 找到 WhatsApp Cloud API 频道 > 单击 管理。
步骤 3：单击模板 > 提交模板 提交消息模板以供审批。
步骤 4：填写创建模板所需的信息。
场地 | 描述 |
|---|---|
模板名称 | 名称只能包含小写字母数字字符和下划线（_） |
类别 | 消息模板所属的类别。 |
语言 | 编写模板的语言。 |
步骤 5：填写必要的组件来创建消息，然后在预览部分查看该消息。 您可以包含参数 {{1}}、 {{2}}等作为占位符，以填充个性化内容。
积木 | 描述 |
|---|---|
身体 | 正文包含模板中最重要的文本。 仅支持文本。您可以使用 markdown 来格式化此块的内容。 了解更多。 |
标题 | 页眉是可选的，可作为模板的标题或页眉。 它支持以下内容： |
页脚 | 页脚是可选的，并且仅支持文本。 它可用于在您的消息模板中提供补充信息。 |
按钮 | 该按钮是可选的，可以为您的模板添加交互性。 有两种类型可用： |
步骤 6：提供示例值
这仅适用于在消息模板内容中包含任何参数的情况。
为消息模板中的参数提供示例值将有助于 WhatsApp 审核人员理解您尝试发送给联系人的消息。
重要链接：WhatsApp 消息模板指南
同步消息模板
步骤 1： 前往 工作区设置 > 点击 频道。
步骤 2： 找到 WhatsApp Business Platform (API) 频道 > 单击 管理。
步骤 3：单击模板 > 同步模板 开始同步过程。
同步过程已完成。 这意味着：
- 消息模板将与其对应的状态一并列出。
- 最后同步的日期和时间将更新。
- 如果您的消息模板被拒绝，拒绝原因将显示在被拒绝的消息模板下方。
下表列出了消息模板的可能状态：
地位 | 描述 |
|---|---|
已提交 | 消息模板已提交并等待批准。 |
得到正式认可的 | 消息模板已批准并可以发送给联系人。 |
被拒绝 | 消息模板被拒绝，无法使用。 |
使用列表右上角的搜索和过滤器轻松找到您的模板！
支持的文件类型
WhatsApp 支持的文件类型及该类型的最大文件大小如下：
音频 & 视频 (16MB)
文档（100 MB）
图片 (5 MB)
贴纸 (100 KB)
不支持的消息将以不支持的消息或自定义有效负载文本和类型（如果可用）进行回退显示。 对于任何不受支持的文件类型或超过通过 WhatsApp Cloud API 发送的最大文件大小的文件，该文件将自动转换为 respond.io 平台上的 URL 链接。 对于自定义载荷，您可以点击 显示更多 查看此消息的 JSON 载荷。 WhatsApp Cloud API 不支持的消息示例包括：
- 表情反应
- 已删除消息
- 投票
- 临时消息
速率限制
速率限制是应用程序或用户在渠道定义的给定时间段内可以进行的 API 调用次数。 了解有关 此频道的速率限制。
常见问题和疑难解答
无法发送消息
确保您连接到平台的号码是一个 WhatsApp Cloud API 号码。
消息未到达
当消息 webhook 未订阅时，可能会发生这种情况。
步骤 1：导航到 Facebook App Webhook 页面
打开 Facebook App 并导航到 Webhooks 页面。
步骤2：验证订阅的事件
选择 WhatsApp 商业账户 并验证 消息 事件是否已订阅。
步骤 3：发送测试消息
向 WhatsApp 电话号码发送测试消息并检查是否到达。
无法接收已读回执
当连接到 WhatsApp Cloud API 的用户更改其 Facebook 密码时，权限将会过期并需要刷新。
步骤 1： 前往 工作区设置 > 点击 频道。
步骤 2： 找到 WhatsApp Business Platform (API) 频道 > 单击 管理。
步骤 3：单击疑难解答 >刷新权限 以刷新 WhatsApp 权限。
步骤 4： 向 WhatsApp 电话号码发送测试消息并检查是否到达。
无法发送出站消息：验证访问令牌错误
发生这种情况可能由于以下几个原因：
当验证访问令牌的会话已过期时。
Meta Business Manager 中用户'的管理员权限发生了变化。
Meta Business Manager 上的密码已更改。
要解决此错误，您必须 刷新您的 WhatsApp Cloud API 频道权限 并再次发送测试消息。
您必须是 Meta Business Manager 的管理员才能够刷新权限。
联系人未收到消息
当联系人不同意 WhatsApp 条款和隐私政策时，就会发生这种情况。
如果您的联系人无法接收来自您的 WhatsApp Cloud API 号码的消息，请确保他们已同意最新的 WhatsApp 条款和隐私政策。
用于注册 WhatsApp Cloud API 的电话号码有哪些要求？
用于 WhatsApp Cloud API 的电话号码不能在 WhatsApp 个人或商业应用中使用。 您必须删除在 WhatsApp 个人或商业应用中的帐户，然后才能使用该号码注册 WhatsApp Cloud API。
在 WhatsApp 商业平台上注册后，您仍然可以将该号码用于其他用途，例如拨打电话和接收短信。
一旦您将手机用于 WhatsApp Cloud API，您就无法再在 WhatsApp Business App 上使用该号码。
开始使用 Cloud API 是否需要业务验证？
无需完成 Facebook 商业验证即可开始在 WhatsApp 上发送消息。 即使没有企业验证，您的企业仍然可以：
响应无限的用户发起的对话。
在连续 24 小时内向 250 位唯一客户发送业务发起的对话（消息模板）。
最多注册 2 个电话号码。
企业只有在准备好扩大业务发起的对话或希望成为官方商业账户时，才能启动商业认证。
我可以查看我的 WhatsApp 商业帐户的对话见解吗？
是的，您可以在 Meta WhatsApp Manager 的 Insights 选项卡中实时监控您的 WhatsApp 商业帐户的消息和支出分析。 在 此处 阅读更多。
WhatsApp 消息传递限制有哪些？
消息限制规定了一个企业组合在24小时内可与之发起商业主动对话的唯一 WhatsApp 用户数量上限。 此限制在投资组合中的所有电话号码之间共享。
这些限制不适用于用户发起的对话。 商业发起的对话在第一条消息发送给客户时开始，并持续24小时。
一个常见的误解是每条消息都计入限制——实际上，在24小时内发送给同一用户的多条消息仍然计为一次对话。
在 此处 阅读更多。
如何向我的 WhatsApp 商业帐户添加付款方式？
您可以在 Business Manager 中向您的 WhatsApp Business 帐户添加付款方式。 了解如何在 此处向您的 WhatsApp 商业帐户添加付款方式。
为什么我的消息发送失败并显示“商业资格付款问题”错误？
这很可能是因为您在没有有效付款方式的情况下超出了每月免费套餐的门槛。 要解决此问题，请 添加有效的付款方式。
WhatsApp Cloud API 定价是多少？
从2025年7月1日起，WhatsApp Cloud API采用混合定价模型。 服务对话（当您在24小时内回复客户时）按对话计费。 模板消息——营销、实用程序和认证——按发送的消息数量计费。 如果在24小时内发送，实用程序模板是免费的，而认证和营销模板总是按消息收费。 高容量的实用程序和认证模板会自动获得分级折扣。 来自广告或页面CTA的免费入口点对话开启一个72小时的免费窗口，所有消息类型均为免费。
了解有关 WhatsApp 定价，请在 此处 了解更多。
如何从企业帐户中删除电话号码？
删除电话号码需要一些要求和步骤，更多信息请见 此处。
我可以使用 respond.io 发送带有 Meta 测试号码的 WhatsApp Cloud API 广播吗？
您可以使用 Meta 测试号码从平台发送测试广播。 但是，使用测试号码的广播最多只能有五个接收者。 您必须首先将这五个收件人添加到 Meta Developer 工具中的电话号码列表中。
如果您没有将收件人添加到此列表，或者您尝试向不在此列表中的收件人发送广播，您将收到此错误消息：
我可以从我连接的云 API 帐户中删除元测试号码吗？
不可以，此号码会自动提供给所有帐户用于发送测试消息，并且无法删除。 请注意，这是一个测试号码，不得用于其他目的。
为什么我会看到来自同一 WhatsApp 频道的重复联系人？
WhatsApp 提供的联系人的电话号码采用的格式与 respond.io 使用的 E.164 格式不同。 这种差异导致某些国家的联系人出现重复。 如果发生此情况，请通过 此处联系我们。
如何更改我的云 API 显示名称？
要 更改您的 Cloud API 显示名称，请按照以下步骤操作：
导航到您的 FBM > WhatsApp 帐户 > 电话号码。 此页面显示您的消息限制和质量。
将鼠标悬停在显示名称旁边的铅笔图标上即可进行编辑。
单击 下一步 将您的新显示名称提交给 Meta 以供批准。
等待 Meta 的批准确认。
我的云 API 的新显示名称获得批准后，我应该采取哪些步骤？
在收到 Meta 对您的新显示名称的批准后，请完成以下步骤：
使用新批准的显示名称重新注册您的电话号码。
执行一次 POST API 调用以 验证您的电话号码。
再次进行 POST API 调用以 重新注册已验证的电话号码。
一旦成功，您的 Cloud API'的显示名称更新就完成。
为什么在尝试发送消息时会遇到错误 “验证访问令牌时出错：会话已被注销，因为用户更改了密码或 Facebook 出于安全原因更改了会话”？
如果您最近更新了您的 Facebook 凭据，则会出现此错误，它可能会中断我们平台上的频道连接，导致发送消息时出现错误。
要解决此问题，您需要使用更新后的 Facebook 凭据刷新我们平台上的频道权限。 此过程需要管理员角色。 通过刷新权限，您将重新建立与新凭据的连接，确保您的出站消息能够成功发送而不遇到错误。
如何将 WhatsApp Cloud API 从 respond.io 下线？
要在 respond.io 停用 WhatsApp Cloud API，请按以下步骤操作：
步骤 1：在 respond.io 中删除频道
前往 工作区设置 > 频道。
选择您的 WhatsApp Cloud API 频道。
删除该频道。
步骤 2：从 WhatsApp Manager 删除电话号码
前往 Meta Business Manager。
导航至 WhatsApp Manager > 电话号码。
删除电话号码。
从 WhatsApp Cloud API 下线后会发生什么？
Respond.io 将停止接收和发送消息。
连接到 respond.io 的 Webhooks 将停止工作。
重要：
在 respond.io 中删除频道并不会自动从您的 Meta Business Account 中删除该号码。
如果您想在 WhatsApp Business App 中再次使用该号码，必须先从 Cloud API 删除它（这是 Meta 的要求）。
如果该号码通过其他集成继续发送消息，可能会适用标准的 Meta 对话定价。
