跳转到主要内容
使用您的 Meta 应用和合作伙伴解决方案,通过您的软件引导客户接入 WhatsApp。在执行这些步骤之前,请完成技术开发合作伙伴入驻。 关于 TP Lite 集成方案,请参阅合作伙伴直链。

第 1 步:添加允许的网域

登录 Meta 开发者 应用控制台 ,前往 Facebook Login for Business > 设置 > 客户端 OAuth 设置:
YCloud 产品截图
将以下开关设置为 是:
  • 客户端 OAuth 登录
  • 网页 OAuth 登录
  • 强制使用 HTTPS
  • 内嵌浏览器 OAuth 登录
  • 对重定向 URI 使用严格模式
  • 使用 JavaScript SDK 登录
⚠️ 注意事项:
  • 嵌入式注册依赖于 JavaScript SDK。
  • 当企业客户完成嵌入式注册流程时,其 WABA ID、 商业电话号码 ID 以及 可交换的 token code 会返回到发起该流程的窗口,但前提是该页面的网域必须已同时添加到 允许的网域 和 有效的 OAuth 重定向 URI中。
  • 请添加您计划部署嵌入式注册的所有网域(包括开发环境中的测试网域)。
  • 仅支持启用了 HTTPS 的网域。

第 2 步:创建 Facebook Login for Business 配置 ID

Facebook Login for Business 配置定义了当企业客户使用嵌入式注册时,需要请求哪些权限以及收集哪些补充信息。 在控制台中,前往 Facebook Login for Business > 配置。
YCloud 产品截图
点击 根据模板创建 ,并选择 WhatsApp Embedded Signup Configuration With 60 Expiration Token 来创建配置。 该模板会生成包含最常用权限和访问级别的配置。
YCloud 产品截图
配置完成后,记录下 配置编号 (Configuration ID) — 下一步骤将会用到。

第 3 步:将嵌入式注册集成到您的网站

将以下 HTML 和 JavaScript 代码添加到您的网站。这是实现嵌入式注册所需的完整代码。 我们建议根据您的解决方案或客户需求构建不同的嵌入式注册流程:

嵌入式注册 – 创建 WhatsApp API 账户

1. 创建嵌入式注册按钮

⚠️ 注意事项:
  • 将 appId、config_id 和 solutionID 替换为实际值。
  • 前端必须将 waba_id 和 phone_number_id 传递给您的后端,以检索 WABA 并注册号码(见下文)。
更多详情:https://developers.facebook.com/docs/whatsapp/embedded-signup/implementation 2. 绑定 WABA 与已注册号码 客户完成嵌入式注册后,您的前端将获取 waba_id 和 phone_number_id,并将其传递给后端以进行后续 API 调用。 绑定 WABA 调用 YCloud WABA 绑定 API,然后在您的系统中将其与对应的客户账户进行关联。 请求示例:
成功响应示例:
注意:如果响应字段 paymentMethodAttached 为 true,则表明 YCloud 已成功为该 WABA 绑定支付方式。否则, 请联系 YCloud 团队解决该问题。 注册电话号码
响应示例

嵌入式注册 – WhatsApp Business App 共存

1. 创建嵌入式注册按钮


2. 获取 WABA 并绑定到 YCloud

客户完成嵌入式注册后,您的前端将收到 waba_id。将其传递给您的后端以进行进一步的 API 调用。 调用 YCloud SMB 绑定 API。成功后,在您的系统中将该 WABA 与客户的账户进行关联。
响应示例

常见问题

如果您正确配置了 solutionID ,客户在进行 Facebook 授权时将会看到解决方案合作伙伴的真实名称。
如果未看到,则说明配置尚未生效。
请确保已完成 应用审核 (App Review) 。
YCloud 产品截图
如果用户选择的是 现有 WABA 而不是创建新 WABA,可能会发生这种情况。
现有 WABA 可能已存在尚未解绑的支付方式。
打开嵌入式注册(Embedded Signup)页面时,可能会显示以下提示信息:应用未激活
目前无法访问此应用,应用开发者已知悉此问题。应用重新激活后,您将能够登录。
当应用处于 开发 模式时会出现此情况,此时仅测试用户拥有权限(请参阅 应用面板 > 应用角色 > 角色 / 测试用户)。解决方案:
通过在控制面板中打开相应的应用,经由 Meta 应用将应用模式切换为 上线 。
或者,为当前用户授权。请参阅:在您的业务资产组合中向人员分配业务资产。
打开嵌入式注册(Embedded Signup)页面时,可能会显示以下提示信息:功能不可用
由于我们正在更新此应用的其他详细信息,Facebook 登录功能目前对此应用不可用。请稍后再试。
解决方案:
前往 应用面板 > 应用审核 > 权限和功能 ,申请 public_profile 高级访问权限。