登录开始免费试用
easyCoexistence 官方 API

为客户接入 WhatsApp 的 Embedded Signup:自有 Tech Provider 应用还是托管页面

SaaS 可通过 Meta 的 Embedded Signup,以两种方式将客户的 WhatsApp Business 应用号码接入 Cloud API。一种是 SaaS 自己成为 Meta Tech Provider,需完成企业验证、提交两段录屏接受 App Review,并构建自己的 Embedded Signup。另一种是将客户引导至由已是 Tech Provider 的服务商运营的托管 Embedded Signup 页面,并接收已完成的连接结果。

easyCoexistence 在带有您名称的托管页面上运行 Meta 配合 Coexistence 的 Embedded Signup,因此您的客户无需您成为 Tech Provider 即可连接号码。

10 to 200

Tech Provider 每滚动 7 天可接入的新企业客户数:默认 10 个,通过验证和审核后提升至 200 个。

2 videos

App Review 要求 Tech Provider 提供的录屏:一条消息的发送与接收,以及一个消息模板的创建。

About 24 hours

Meta 公布的 WhatsApp 应用 App Review 平均处理时长。

2.24.17

客户可通过 Coexistence 连接的最旧 WhatsApp Business 应用版本。

30 seconds

Embedded Signup 返回的代码有效期:服务器须在此期间将其兑换为客户的商业访问令牌。

为客户号码接入的两种方式是什么?

两者都使用 Meta 的 Embedded Signup 配合 Coexistence,最终结果相同:客户号码接入 Cloud API,同时仍可在 WhatsApp Business 应用中使用,并且您的后端持有客户自己的商业访问令牌。区别在于由谁承担 Meta 的要求,以及弹窗周围的代码由谁负责。

Your own Tech Provider appeasyCoexistence's hosted page
Before the first customerBusiness verification, App Review and your own Embedded Signup buildAn API key and a card on the account
Name in Meta's popupYour appeasyCoexistence, with your name on the page around it
Code you maintainThe popup, the token exchange, webhook subscriptions and the history syncA session request and a return page
The 14-day ruleA PARTNER_REMOVED webhook for your app to handleconnection.disconnected with PRIMARY_INACTIVITY
Meta's message chargesOn the customer's WhatsApp Business AccountOn the customer's WhatsApp Business Account

成为 Tech Provider 需要满足 Meta 的哪些要求?

Meta 在《成为 Tech Provider》指南中列出了相关步骤。在应用控制台中,WhatsApp 用例下的 Tech Provider 接入入口会打开该指南:

  • 一个带有 WhatsApp 用例的 Meta 应用,并已关联到您的 Business Portfolio。
  • 企业验证,且须优先完成:只有经过验证的企业,Meta 才会开始 App Review。
  • 应用设置,例如图标、隐私政策和类别。
  • whatsapp_business_messaging 与 whatsapp_business_management 的高级访问权限,需通过 App Review 获批,并为每项权限提交书面说明和一段录屏。
  • 共需两段录屏:从您的应用发送消息并在 WhatsApp 中接收,以及您的应用创建消息模板。

获批后需要构建什么?

即入职流程本身,Meta 的 Embedded Signup 指南逐步说明了以下内容:

  • 您网站上的流程,通过 Facebook Login for Business 与 Meta 的 JavaScript SDK 实现,并运行在您在应用中允许的 HTTPS 域名上。
  • 在流程配置中启用 Coexistence,并开启会话日志记录,这是 Meta 对 Coexistence 的要求。
  • 一个服务器端调用,在 30 秒内将返回的代码换取为客户的商业访问令牌。
  • Webhook:您的应用订阅每个客户的账户,并包含 account_update、history、smb_app_state_sync 和 smb_message_echoes 字段。
  • 在入职后 24 小时内完成联系人与历史记录同步;此后,客户必须先解除接入,再重新运行流程。

托管页面承担什么?

弹窗相关的全部环节。easyCoexistence 以 Tech Provider 身份,通过自有 Meta 应用运行配合 Coexistence 的 Embedded Signup,页面位于 easycoexistence.com,并显示您的名称。令牌交换、Webhook 订阅和历史记录请求均在该页面完成,您的后端则接收一个连接 ID。若会话中设置了 webhook_url,Meta 会将号码的消息直接投递到您的服务器,同时包括一次性的联系人导入,以及客户同意分享时最多 180 天的聊天记录。随后,您的代码可直接使用客户的令牌调用 Meta 的 Graph API,而 easyCoexistence 会持续监控号码,并在其状态变化时发送带签名的事件。

您的客户会看到什么?

一个带有您名称的页面和一个「Connect」按钮。在 Meta 弹窗打开之前,清单会请客户确认五件事:WhatsApp Business 应用为最新版本;号码已实际使用至少 7 天;号码上没有其他 API 服务商或自动化工具;没有非官方应用;手机在手边,并可使用 Facebook 账户登录。无需客户提供任何 easyCoexistence 账户、电子邮件或银行卡信息。

1Your pageYour name, the checklist and one Connect button
2Meta's popupFacebook sign-in, the number, then the business portfolio
3QR codeScanned from inside the WhatsApp Business app
4In the appConnect, then Confirm: share chat history or not
5Back to youConnected, then your redirect_url

Meta 弹窗内部发生什么?

Meta 流程会让客户通过 Facebook 登录,授权应用,输入号码,并显示该号码的 WhatsApp Business 应用资料供其确认。客户随后选择或创建 Business Portfolio,再从 WhatsApp Business 应用内扫描二维码;Meta 还会向该号码发送一条 WhatsApp 消息,其中包含二维码链接。在应用中,客户点击 Connect,并选择是否分享聊天记录。最后是账户名称、时区,以及 Meta 的条款。在 Meta 推出以号码优先的流程期间,步骤顺序可能有所不同。

Meta 弹窗显示的是谁的名称?

是请求访问权限的应用名称。在托管页面上,该名称为 easyCoexistence,且无法更改;而弹窗周围的页面则显示来自 partner_name 的您的名称。若使用您自己的 Tech Provider 应用,弹窗会显示您应用的名称,但代价是需要完成上述的验证、审核与构建工作。

14 天规则是什么?

当持有 WhatsApp Business 应用的手机约 14 天未活动时,Meta 会断开 Coexistence 号码,并将原因报告为 PRIMARY_INACTIVITY。客户只需用同一号码重新运行流程即可重新连接。通过托管页面,easyCoexistence 会监控每个号码,并向您的 events URL 发送携带该原因的 connection.disconnected 事件,因此为客户生成新的连接链接即可让号码恢复连接。

常见错误

  • 使用 Embedded Signup v2 或 v3 进行开发。Meta 已于 2026 年 10 月 15 日弃用这两个版本,并会将对它们的请求以 v4 处理。
  • 请求应用并未使用的权限。Meta 将不必要的权限列为 App Review 驳回提交的常见原因之一。
  • 为两项权限只录制一段视频。Meta 要求为每项权限单独提供录屏和书面说明,并可能驳回包含多项权限的视频。
  • 要求客户从持有该号码的手机上连接。Meta 弹窗会在该手机上以新标签页打开,而同一部手机又必须扫描二维码,因此使用电脑会更方便。
使用 EasyCoexistence 完成这些操作

您的后端接收每位客户自己的令牌,Meta 将消息直接投递到您的 Webhook,断线事件则以带签名的事件形式通知您。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。

常见问题

我需要成为 Meta Tech Provider 才能接入客户的 WhatsApp 号码吗?

只有当您想用自己的 Meta 应用运行 Embedded Signup 时才需要。将客户引导至由 Tech Provider 运营的托管页面,即可连接其号码,无需您自己完成企业验证或 App Review。

WhatsApp 应用的 Meta App Review 通常需要多长时间?

Meta 给出的平均时长约为 24 小时。在审核开始前必须先完成企业验证,每次被驳回的提交都会增加一轮审核。

我的客户还能继续使用 WhatsApp Business 应用吗?

可以。该应用在其手机上可与 API 并行运行,两者之间的消息会相互同步。部分应用功能会有所变化:广播列表变为只读,限时消息和单次查看消息功能会被关闭。

谁为消息向 Meta 付费?

由客户付费。Meta 会将通过 API 发送的消息计入客户自己的 WhatsApp Business 账户,并使用其在该账户中添加的付款方式;而从 WhatsApp Business 应用发送的消息仍然免费。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间