第 1 步:添加允许的网域
登录 Meta 开发者 应用控制台 ,前往 Facebook Login for Business > 设置 > 客户端 OAuth 设置:
- 客户端 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 > 配置。

第 3 步:将嵌入式注册集成到您的网站
将以下 HTML 和 JavaScript 代码添加到您的网站。这是实现嵌入式注册所需的完整代码。 我们建议根据您的解决方案或客户需求构建不同的嵌入式注册流程:嵌入式注册 – 创建 WhatsApp API 账户
1. 创建嵌入式注册按钮
- 将
appId、config_id和solutionID替换为实际值。 - 前端必须将
waba_id和phone_number_id传递给您的后端,以检索 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) 。
如果未看到,则说明配置尚未生效。请确保已完成 应用审核 (App Review) 。

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

