💡 即将推出：WhatsApp 将于 2026 年 7 月推出用户名功能
当联系人采纳用户名后，其电话号码将不再与您的企业共享，因此 WhatsApp 引入了新的联系人标识符，业务范围用户 ID (BSUID)。 Respond.io 将自动处理此事——对话将照常进行，联系人记录不受影响。
即将推出的内容：
- 当没有电话号码可用时，Respond.io 将支持新的联系人标识符 BSUID。
- 如果存在电话号码，则电话号码仍将作为主要标识符，通过电话号码发送消息将照常工作。
- 新的 请求电话号码 按钮将可用于营销和实用型消息模板——允许联系人在对话中直接共享其电话号码。
- 对于已集成 CRM 的企业，BSUID 将出现在 webhook 事件和 Developer API 中，准备与您的第三方集成同步。 这适用于 2026 年 4 月之后创建的新联系人。
需要帮助吗？ 联系支持 或参阅 Meta 的文档.
将 WhatsApp Business Platform (API) 渠道连接到 respond.io 后，使用渠道配置设置来管理渠道名称、企业资料、支持的文件类型、消息速率限制，以及保持您的 WhatsApp Business Account (WABA) 与 Meta 要求一致的最佳做法。
配置 WhatsApp 渠道名称
设置唯一的内部渠道名称以在 respond.io 内识别此帐户。
导航到 工作区设置 并点击 渠道。
找到 WhatsApp Business Platform (API) 渠道 并点击 管理。
配置 渠道名称，该名称用于在内部识别该帐户。
点击 保存更改 以更新渠道配置。
管理 WhatsApp Business 配置文件
您可以在 respond.io 平台上直接更新或查看您的 WhatsApp Business 配置文件。
导航到 工作区设置 并点击 渠道。
找到 WhatsApp Business Platform (API) 渠道 并点击 管理 > 配置文件。
点击 同步配置文件 从 WhatsApp 拉取最新的 WhatsApp Business 配置文件信息。
编辑 以下字段（根据需要）。
字段 | 说明 |
|---|---|
个人资料照片 | 该图像显示为 WhatsApp Business 帐户的个人资料图片。 建议图像尺寸为 640x640。 |
关于 | 企业的“关于”文本。 显示在头像、电话号码和联系按钮下方。 最多 139 个字符。 |
地址 | 企业地址。 最多 256 个字符。 |
业务描述。 | 业务描述。 最多 512 个字符。 |
电子邮件 | 用于联系企业的电子邮件地址（有效的电子邮件格式）。 最多 128 个字符。 |
行业 | 企业所属行业。 可接受的值：汽车、美容、水疗和沙龙、服装和服饰、教育、娱乐、活动策划与服务、金融和银行、食品与杂货、公共服务、酒店和住宿、医疗与卫生、非营利、专业服务、购物与零售、旅行与交通、餐厅、其他。 业务垂直领域在创建后不能被设置为空值。 |
网站 | 与企业关联的 URL（包括 |
查看 信息并点击 保存配置文件。
通过渠道接收到的元数据
不同的渠道向 respond.io 平台提供不同的联系人元数据集合。 此渠道可提供以下联系人数据：
电话号码
电话号码 ID
个人资料名称
WhatsApp 帐号
业务范围用户 ID (BSUID)
用户名
对于已在 WhatsApp 上使用用户名的联系人，现可获得 BSUID 和用户名字段：
- 在 Channel Meta 对象的channel数组中，位于New Incoming Message和New Outgoing Messagewebhook 事件中。
- List Contact Channels 端点现在返回 BSUID 和用户名字段。 请参阅 API 文档 以获取更新的字段定义。
这适用于 2026 年 4 月之后创建的新联系人。
支持的文件类型
类型 | 最大大小 |
|---|---|
音频和视频 | 16 MB |
文件 | 100 MB |
图像 | 5 MB |
贴图 | 100 KB |
不受支持的文件类型或超出大小限制的文件会在 respond.io 平台上自动转换为 URL 链接。 不受支持的消息将显示为“Unsupported Message”或“Custom Payload”，并显示类型（如适用）。 点击 显示更多 以查看自定义有效载荷消息的 JSON 有效载荷。 以下是 WhatsApp Business Platform (API) 不支持的消息类型示例：表情反应、已删除的消息、投票、临时消息
在发送之前确认文件格式受支持。 即使在大小限制范围内，未正确转换的文件仍可能发送失败。 了解更多有关 支持的媒体类型。
文本格式
在消息中使用文本或 markdown 格式。 了解有关 如何在 WhatsApp 中格式化文本 的更多信息。
速率限制
速率限制是指在特定时间段内，应用或用户可发出的 API 调用次数。 了解有关 此渠道的速率限制。
渠道限制
WhatsApp 群组
Meta 在 WhatsApp Business Platform (API) 上支持群组消息，但尚未在 respond.io 上提供。 如果此功能对您的用例很重要，请为 功能请求 投票。
不支持的号码类型
WhatsApp 不允许使用 VoIP 或免费电话（toll-free）号码。 这包括 Google Voice 号码（VoIP）。
WhatsApp 状态
WhatsApp Status 不受 WhatsApp Business Platform (API) 支持。 发布、发送、接收或管理 WhatsApp Status 的功能不可用。 如果您对该功能感兴趣，请为 功能请求 投票。
最佳做法
为维护稳定的 WhatsApp Business Platform (API) 设置并避免意外禁用或中断，请遵循以下最佳做法。
避免 WABA 被禁用
遵循以下最佳做法以避免 WABA 被禁用。
使用经过验证且独一无二的 Meta Business Manager (MBM)
每家企业仅使用 一个 MBM。 使用相同的企业名称、地址或网站创建多个 MBM 可能会被 Meta 标记。
如果先前的 MBM 已被封禁，避免使用相同的企业信息创建新的 MBM——Meta 可能会立即封禁。
验证您的 MBM，方法是提交官方企业文件（例如营业执照、匹配的网站）。
谨慎控制访问权限：仅向具有稳定活动（发帖、好友等）的真实 Facebook 个人资料授予管理员权限。
为所有管理员启用两步验证 (2FA)。
负责任地管理 WhatsApp Business Accounts (WABA)
如果 WABA 被封禁，通过 Meta 支持提出申诉。 在上诉期间不要创建新的 WABA——这可能被视为规避政策。
使用清晰准确的 显示名称。 例如，“Acme Co – California” 比单独使用 “Acme” 更好。
不要频繁删除并重新创建电话号码（“烧号”）。 改为通过 Meta 解决已报告的问题。
正确处理 Facebook 用户
管理员必须使用具有真实历史的 真实 Facebook 帐户。
避免仅为访问目的而使用新创建或重复的帐户。
将访问权限限制 给必要的团队成员，并定期审核 MBM 用户。
强制启用 2FA 以降低未经授权访问的风险。
确保各平台之间的企业信息一致
确保您的 企业名称、地址、网站及其他信息在 MBM、WABA 和广告账户之间保持一致。
这种一致性会增强 Meta 的信任并提高验证通过的可能性。
如果您的 WABA 被禁用
不要创建新的 WABA。
通过 Meta Business Support 提交申诉。
收集并提供必要的文件（例如营业执照、域名所有权证明）。
审查并纠正任何违反 Meta 的 Business Messaging Policy 的行为。
遵循这些最佳做法有助于保持您的 WhatsApp 设置安全、稳定，并符合 Meta 的政策。
CRM 或自定义集成
如果您正在将联系人从 respond.io 同步到 CRM 或自定义集成，请准备：
在您的 CRM 中添加一个专用的 BSUID 字段。 将 BSUID 与现有标识符（电话号码或电子邮件）一起存储，以便在电话号码不可用时正确映射对话并关联历史记录。
构建逻辑以同时处理电话号码和 BSUID 作为标识符。 当电话号码不可用时，您的系统应回退使用 BSUID 以将联系人匹配到正确的记录。
WhatsApp 联系人簿
Meta 的 WhatsApp Business Manager 包含一个用于 WhatsApp 的 联系人簿，用于存储用户联系信息以支持消息线程连续性。 默认启用。
如果此功能被关闭，当在 30 天内没有交互时，respond.io 将无法将使用 WhatsApp 用户名的联系人与其现有联系人记录匹配。 这将导致创建重复的联系人条目。
为避免重复的联系人条目：
前往 Meta Business Suite > Business settings > Business info
确认 WhatsApp 联系人簿 已启用。
设置 WhatsApp 企业用户名
Meta 正在逐步向部分地区推出 企业用户名。 与此同时，您可以通过 Meta Business Suite 立即预留用户名——Meta 会将其与您的 WhatsApp 电话号码关联，其他企业无法申领。 您预留的企业用户名（经 Meta 批准）将在该功能在您所在地区正式推出后生效。
WhatsApp 企业用户名是一个可选功能，为企业提供唯一标识符 — 例如 @YourBusinessName。 联系人可以使用该用户名找到并向您的企业发送消息，而无需电话号码。
企业用户名不同于 显示名称：
您的显示名称不必是唯一的。
每个电话号码必须有唯一的用户名。 如果您有多个电话号码，每个号码都需要独立的用户名。
以下是预留用户名的步骤：
前往 Meta Business Suite > Settings。
在左侧菜单中点击 WhatsApp Accounts。
点击您想为其创建用户名的电话号码。
点击 Phone numbers，然后点击铅笔图标。
前往 Username，然后点击 Create。
输入您想要的用户名。 您也可以从 Suggested 中选择用户名。
点击 保存。
设置企业用户名后，用户名和电话号码都会在您的企业资料中显示。
在 Meta 文档 中了解更多关于 WhatsApp 企业用户名 的信息。
常见问题与故障排除
用于注册 WhatsApp Business Platform (API) 的电话号码需要满足哪些要求？
只要号码能通过短信或电话接收 OTP 验证码，移动号码、虚拟号码和固话均可使用。
该号码不能已在 WhatsApp Personal 或 Business 应用上注册 — 如已注册，请先删除该账户。
注册后，该号码仍可用于其他用途，例如拨打电话和发送 SMS。
我可以查看我的 WhatsApp Business Account 的会话洞察吗？
可以。 在 Meta WhatsApp Manager 的 Insights 选项卡中实时监控您的消息和支出分析。 了解有关 WhatsApp Business 账户洞察 的更多信息。
为什么我会在同一 WhatsApp 频道看到重复的联系人？
WhatsApp 以与 respond.io 使用的 E.164 格式不同 的格式传递联系人的电话号码。 此差异会导致来自某些国家/地区的联系人重复。 如果发生此情况，请 联系支持。
如何让我的企业名称在 WhatsApp 上显示给联系人，而不是显示我的企业号码？
标准的 WhatsApp Business Platform (API) 帐户会显示企业号码而不是名称。 要在联系人未将您的企业添加到其地址簿的情况下仍显示您的企业名称，您需要一个 WhatsApp 官方企业账户。
官方企业账户的企业名称旁会有绿色勾选标记，通常只有大型知名企业会获得此状态。 了解有关 如何申请 WhatsApp 官方企业账户。
什么是 Meta Product Catalog，以及我如何使用它？
Meta Product Catalog 是一个允许您创建产品目录并与客户共享的功能。 了解有关在 respond.io 中使用 Meta Product Catalog 的更多信息。
子公司或代理机构可以代表另一家公司注册 WhatsApp Business Account 吗？
可以。 但是，用于注册 WhatsApp Business Account 的 Meta Business Account 和企业信息必须属于能够通过相关法律文件进行验证的实体。 了解有关 Meta 企业验证 的更多信息。
企业在注册 WhatsApp Business Platform (API) 帐户时可以注册多少电话号码，以及如何提高该限制？
当企业注册 WhatsApp Business Platform (API) 且未通过验证时，仅可注册最多 2 个电话号码。 已验证的企业可以注册更多电话号码。 单个 Business Manager 最多可注册 20 个电话号码。
如果您受限于较低的数量（例如 5 个号码）且无法注册更多号码，请直接向 Meta 提交工单以申请提高电话号码上限。
步骤：
点击此处 获取直接支持。
前往 Ask a Question > WABiz: Account & WABA > Request type > Increase Phone Number Limits
说明您为何要提高电话号码上限。
提交您的请求。
如何查看我的 WhatsApp 会话使用量？
要查看 WhatsApp 会话使用量，请按以下步骤操作：
进入您的 Meta Business Manager。
点击 Settings > Business Settings > WhatsApp Accounts
选择您的 WABA，然后点击 Settings > WhatsApp Manager。
在 Account tools 下，点击 Insight。
为什么消息以不支持的消息形式进入并显示错误代码：131051？
其中一个可能的原因是 WhatsApp API 帐户并非设计用于与其他 WhatsApp API 帐户对话。 这是 Meta 的限制。 注意，错误代码：131051 用于多种与不支持的消息类型相关的错误。 如果您不确定此错误，请 联系支持。
当尝试发送消息时，为什么会收到错误信息 “Undefined: Receiver is incapable of receiving this message”？
该错误信息由 Meta 返回。 以下是 Meta 建议的排查步骤：
确保接收消息的联系人满足以下条件：
拥有有效的 WhatsApp 帐户。
使用最新版本的 WhatsApp。
已接受最新的服务条款和隐私政策。
未被 WhatsApp 封禁，且不处于被 WhatsApp 禁止的国家/地区。
我已丢失 Meta Business Manager 帐户的凭据 我应该怎么办？
要重新获得对 Meta Business Manager 帐户的访问权限，请参阅 Meta 关于重设密码并找回电子邮件或电话号码的指南。
为什么我的 WhatsApp Business 账户被禁用？
您的 WhatsApp Business API (WABA) 帐户可能因多种原因被禁用。 常见问题包括不符合 Meta 的商务政策以及列出无效的网站。 要上诉该决定，您应采取以下步骤：
确保遵守 Meta 的商务政策：审查并将您的业务做法与 Meta 的指南保持一致。 这是成功上诉的关键。
确保您有一个有效的网站：在 Meta Business Manager (MBM) 中更新您的企业信息，添加一个能清晰展示企业性质和详细信息的有效网站。
准备申诉：在申诉对话中说明贵公司如何使用 WhatsApp 进行沟通。 强调以下几点：
消息仅发送给已选择接收的客户。
所有通信均与您的业务相关并遵循 WhatsApp 的政策。
了解如何向 Meta 请求复核，请参见 此处。
如果我的 WABA 被禁用，我应如何准备申诉？
请按以下步骤并审核关键信息，以确保您的申诉准备充分。 如果您是通过我们的客服团队 提出申诉，请确保同时与他们共享这些截图。
检查您的企业账户质量：前往 Account overview -> 点击 View my accounts
验证企业详细信息：前往 Business portfolio info
获取您的 MBM ID、WABA ID 和电话号码质量评分以提交申诉：
在您的 Business info 中检索 MBM ID。
前往 WhatsApp accounts 并获取您的 WABA ID。 选择正确的 WhatsApp 帐户并点击以复制 WABA ID。
向下滚动并进入您的 WhatsApp Manager 查看电话号码质量评分。
在发送消息时，为什么会收到错误 “Business eligibility payment issue”？
当您最近删除了某个频道并尝试使用不同的 WhatsApp Business 号码发送模板消息或开启新对话时，可能会发生此错误。 这是由于信用额度从已删除渠道的电话号码释放并重新分配到剩余电话号码所致。 此过程可能需要最多 5 分钟。 等待 5 分钟后再尝试发送消息。
仅当您在同一 Business Manager 下拥有多个号码且这些号码均已连接到该平台时，才会出现此错误。
在 Business Suite 注册并连接到 WhatsApp Business Account (WABA) 的 WhatsApp API 号码能否直接连接到 respond.io？
不可以，从 Business Suite 注册并连接到 WhatsApp Business Account (WABA) 的 WhatsApp API 号码无法直接连接到 respond.io。
为什么我的联系人的头像未显示？
由于 WhatsApp 渠道的限制，respond.io 无法显示联系人的个人资料图片。 WhatsApp 未提供用于获取此信息的 API。
删除 WhatsApp 频道会发生什么？
删除 WhatsApp 频道不会移除关联的联系人或聊天记录。
聊天记录与联系人关联，除非您在联系人模块中手动删除某个联系人，否则该联系人及其对话记录将保留在工作区。
当您重新连接相同的 WhatsApp 频道并收到来自相同号码的消息时，该联系人将与现有联系人合并。
为什么我在 WhatsApp 上看到 “Meta Error (#131057)：Account in maintenance mode”？
当您的 WhatsApp Business Account 暂时处于维护模式（通常在吞吐量升级期间），会出现此情况。 此状态大约持续一分钟，升级完成后您的号码会自动恢复正常。
发送模板时为什么会看到“Media Upload Error”或“Media Download Error”？
当附加到模板的媒体文件不符合 Meta 的要求时，会出现这些错误。 常见原因包括：
文件格式不受支持。
文件类型不正确。
媒体超过 Meta 的大小限制。
这些问题源自 Meta 端，超出了 respond.io 的控制范围。 您也可以参考 Meta 的 错误代码文档 了解特定错误响应的更多详情。
为什么我的联系人在 WhatsApp 上看不到我回复的是哪条消息？
这是因为超过 30 天的 WhatsApp 消息会被 Meta 移到长期存储，因此原始消息的上下文不再可用。 因此，当您回复这些较旧的消息时，不会显示“回复”气泡。
这是一个已知限制，暂无可行的解决方法。 反之亦然——如果联系人回复了您 30 天以前的消息，您也无法看到被引用的消息。
WhatsApp Business Platform (API) 支持群聊吗？
不支持管理或向群聊发送消息。 Meta 已停止对该功能的开发。
在您为业务开启洞察，或在完成频道连接前允许 Meta 自动识别订单和潜在客户事件后，会发生什么？
启用这些选项后，Meta 将自动向合作伙伴通知转化情况。 但是，Meta 尚未完全优化此功能，因此启用这些选项不会影响您的频道连接。 在 Meta 文档 中了解更多。
为什么会看到“该联系人的消息窗口已关闭”错误？
当在 WhatsApp 的 24 小时消息窗口过期后发送自由格式消息时，会出现此错误。 在窗口关闭后，只能发送已批准的消息模板以重新开启对话。
要解决此问题：
通过 工作流中的“发送消息”步骤，使用 WhatsApp 消息模板 发送。
在工作流中使用 消息失败分支 来处理失败。
手动接管对话，并从 Inbox 中 发送 WhatsApp 消息模板。
了解有关 消息窗口如何工作 的更多信息。
在我与联系人积极交谈时，为什么外发的 WhatsApp 消息会突然失败并出现错误？
通过工作流、AI 代理或集成（例如 Developer API、Zapier、Make.com 或 n8n）发送的出站消息，有时可能会因 Meta 的临时中断而发送失败，即使您正在与联系人积极沟通。
可能由以下原因导致：
WhatsApp Cloud API 流量的短暂中断
消息过载：同时发送多条消息可能导致部分消息超时或失败
消息处理或验证期间发生的意外系统错误
在 15 分钟后重试发送该消息。
如果在多次重试后问题仍然存在，请 联系支持团队。
为什么我会看到错误“您已达到 WhatsApp Business Platform (API) 渠道的限制”？ 删除现有的 WhatsApp Business Platform (API) 渠道以添加新渠道。 请联系支持团队以获取更多信息。
当您尝试连接额外的 WhatsApp Business Platform (API) 渠道但无法连接时，会出现此错误。
可能由以下原因之一导致：
已达到渠道上限：您的组织已达到最多 5 个 WhatsApp Business Platform (API) 渠道的限制。
WABA 被 Meta 标记：如果 WhatsApp Business Account (WABA) 被禁用超过两（2）次，Meta 可能会标记该账户。 发生这种情况时，您可能会被阻止将新的 WhatsApp 渠道连接到平台。
您可以这样做
如果您已达到渠道上限：
请求提高 WABA 限额以允许更多 WhatsApp 渠道连接。
如果您的 WABA 被 Meta 标记：
请求白名单审核以解除封锁。
在 respond.io 查看对话会在 WhatsApp 中将其标记为已读吗？
是的。 在 Inbox 中查看 WhatsApp 对话会在 WhatsApp 应用中将其标记为已读。 无需回复即可将对话标记为已读。
为什么我的支付方式缺失？
如果您选择了之前绑定到不同 BSP 的现有 WhatsApp Business Account (WABA)，而不是创建新的 WABA，就可能发生这种情况。 信用额度未与 respond.io ("rocketbots.io") 关联，因此支付方式缺失。
无论您是以下哪种情况：
您可以这样做
改为创建新的 WABA，并确保您的电话号码成功注册。
如果您已正确完成整个流程但支付仍然缺失，请为您的 WABA 充值余额。
这些 "Unavailable"、"Pending" 和 "Offline" 状态是什么意思？
当您 连接 WhatsApp Business Platform (API) 渠道 或 将号码迁移到 respond.io 时，您可能会看到以下状态：
Unavailable / Pending：该电话号码尚未在 Meta 成功注册。
Offline：该电话号码之前已注册，但现在不再在线，消息停止工作。
您可以这样做
对于 Unavailable / Pending 状态：完成嵌入式注册流程，包括 OTP 验证，以注册该号码。
对于 Offline 状态：请通过 联系支持 寻求帮助。 如果需要进一步操作，您可能会被要求重新完成嵌入式注册流程，获取新的 PIN，并使用 OTP 验证电话号码。
