SuperAPI AI 工具集

sender-profile-architect

智能体与模型

查看项目

更新于 10-16 09:56

技能介绍

用途:Sender Profile 是租户身份、渠道配置、继承资源、计费和凭据的运营边界。本技能用于开通前的架构设计,避免品牌、合规、限流影响或 webhook 归属被混在一起。实时 MCP 配置生命周期操作应使用 sent-profile-provisioning,市场合规要求使用 sent-compliance。

主要能力:建议的租户模型是每个租户一个 Sent organization 加一个 Sender Profile;仅当租户确实共享同一品牌、发送资源、合规姿态、计费/限流预期和运营影响范围时才共用 profile。不要默认推荐汇聚式架构,隔离决策需显式记录。

认证模式:Profiles 专用 API key 使用 x-api-key,凭据与限流按 profile 作用域,不要附加 x-profile-id;组织 API key 代表子 profile 时使用 x-api-key 加 x-profile-id: <profile UUID>,限流仍留在组织池。只有组织密钥可发送 x-profile-id,profile 密钥发送该头会收到 403;组织外的 profile 返回 404。x-sender-id 仅为 v1/v2 旧术语,不用于 v3 认证或路由。

创建与继承:使用 POST /v3/profiles,name 必填;可选区域涉及 identity、sharing、inheritance、billing、专用 WABA 凭据和专用品牌。不另设品牌端点,专用品牌随 profile 创建,活动在 /v3/profiles/{profileId}/campaigns 下管理。inherit_tcr_brand: true 表示使用组织品牌;inherit_tcr_campaign: true 使继承活动只读。

计费与号码:billing_model 当前支持 profile、organization、profile_and_organization;需要 billing_contact。卡字段转交支付处理器,不得记录或持久化。更新可管理多个发送号码引用,需防止 profile 间引用成环。WABA 有三条路径:仪表盘组织 Embedded Signup、组织已有 WABA 后省略 whatsapp_business_account 继承、用 waba_id 与 access_token 的专用 profile WABA。

完成与状态:用 POST /v3/profiles/{profileId}/complete,需 webHookUrl;202 表示已开始处理,200 可表示已完成。状态集合在不同接口/回调间不一致,不要断言封闭枚举,保留未知字符串。

Webhook 归属:事件不含应用租户 ID,需在发送前保存 message_id 与租户、profile 的映射,入站按接收号码/profile 资源映射。不要仅凭 account_id 推断租户归属。

限制:未提供公开的启动组织 Embedded Signup 的端点,也没有所谓混合 WABA 路径;敏感卡字段不得记录。资料未涵盖价格、平台支持与效果数据。