用途:在确定租户边界后,通过 API 驱动发送者档案的创建、完成回调、活动注册与用户管理,使档案可用于发送。
主要能力:MCP 实时档案操作(sender_profiles.list/get/create/update/delete,使用客户端管理的 OAuth 2.1/PKCE;变更前用 account.get 校验组织)。list 使用 page(从 1 开始)和 pageSize(1-100,默认 20);get 返回 found/item。create 需 name、shortName、idempotencyKey;shortName 为 3-11 位字母、数字或空格且至少含一个字母;可选 smsCountry、smsNumberType 等。update 需 id 及至少一个变更字段。delete 需 id 和非空 idempotencyKey。创建与删除使用持久回执,重试须复用原键与参数;每次变更前须预览并明确确认,超时后不得新建键,需先在仪表盘对账。
REST 流程:POST /v3/profiles 需组织级 admin 密钥;创建前决定继承与共享标志;US SMS 需注册活动;用 POST /v3/profiles/{profileId}/complete 和可达 webHookUrl 完成档案;回调体为 {profileId, success, status, timestamp} 且只投递一次,须以轮询 GET /v3/profiles/{profileId} 为权威恢复路径。活动管理位于 GET|POST /v3/profiles/{profileId}/campaigns。用户管理有 GET/POST /v3/users 等五个操作,均不在 MCP 中暴露。
限制:MCP 不提供档案完成、活动管理、用户管理或市场添加工具;所需文档上传会先阻断创建,须用仪表盘或 REST 流程;不返回一次性 API 密钥;WhatsApp、RCS、计费、文档上传等参数不在 MCP create 工具中暴露;卡字段须转发给支付处理器,禁止记录。档案状态词汇因界面而异,不可断言固定枚举。