SuperAPI AI 工具集

waba-embedded-signup

通用与其它

查看项目

更新于 10-15 16:46

技能介绍

用途:指导 Sent 平台上 WhatsApp Business Account(WABA)的接入与 Embedded Signup 流程,重点是把三条容易混淆的集成路径区分开,避免错误 API 设计与不安全的凭据处理。

三条路径:一、组织级 Embedded Signup,由组织管理员在 Sent 仪表盘打开 WhatsApp 连接流程,通过 Meta 托管的 Embedded Signup UI 完成授权与 WABA/号码选择;Sent 公开 API 中没有启动该流程的端点。二、组织 WABA 继承,调用 POST /v3/profiles 时省略 whatsapp_business_account,子 profile 继承组织已连接的 WABA。三、子 profile 专用 WABA,同样调用 POST /v3/profiles,提供 whatsapp_business_account.waba_id 与 .access_token,phone_number_id 可选;省略凭据且组织无已连接 WABA 时返回 422。

认证:可使用 profile 专属密钥放入 x-api-key,或使用组织密钥放入 x-api-key 并在为已有子 profile 操作时附加 x-profile-id;仅组织密钥可用 x-profile-id,profile 密钥会收到 403。x-sender-id 属于 v1/v2 遗留术语。

创建后需调用 POST /v3/profiles/{profileId}/complete 并传入 webHookUrl。202 表示后台处理已启动,响应中无最终状态;200 可能表示 profile 已完成。完成回调使用 event 字段而非 sub_type,可能报告 COMPLETED、SUBMITTED 或失败,需保留未知事件字符串、验证真实性并保证幂等。

限制:不要在 Sent 公开 API 中臆造 POST /embedded-signup 或 token 交换端点;access_token 需具备相应 WhatsApp Business 消息与管理权限,须从密钥管理器注入,不得记录、回显、写入夹具、返回浏览器或留存在通用 profile 存储中,Sent 不会在 API 响应中返回该令牌。Meta 浏览器 postMessage 事件使用 event 字段与嵌套 data/session 信息,不可改写为 Sent webhook 的 sub_type 封装。模板与普通消息 webhook 应参照 Sent 当前事件参考。组织未连接 WABA 时创建继承 profile 会返回 422,需先连接组织 WABA 或提供专用凭据。