用途:通过 Twilio 的 Channels Senders API 以编程方式创建、配置和管理 WhatsApp Business 发送者(即注册到 WhatsApp Business 的电话号码)。注册需经历多个状态后才会变为 ONLINE。沙箱测试无需注册发送者。
前提条件:已升级的 Twilio 账户(试用账户无法注册生产发送者);可接收短信或语音验证的电话号码;该号码尚未注册到 WhatsApp;环境变量 TWILIO_ACCOUNT_SID 与 TWILIO_AUTH_TOKEN;SDK 安装命令 pip install twilio 或 npm install twilio。
主要能力:发起注册并提交 OTP 验证;设置业务资料(名称、简介、地址、行业、Logo、网站);配置入站回调与状态回调 Webhook;获取和列出发送者;处理 OFFLINE 状态(查看 offlineReasons,如代码 63020 表示企业尚未接受 Twilio 的 Meta 邀请);迁移已注册的 WhatsApp 号码;ISV/技术提供商可在客户 WABA 下注册发送者。
使用方式:使用 Twilio 客户端调用 messaging.v2.channels.senders 的 create、update、fetch、list 方法。注册时传入 sender_id 与 verification_method,再提交 verification_code。状态包括 CREATING、PENDING_VERIFICATION、VERIFYING、TWILIO_REVIEW、ONLINE、OFFLINE、DRAFT。
限制:一个号码同一时间只能属于一个 WABA;未完成 Meta 企业验证的账户最多 2 个发送者;已验证的 Meta Business Manager 最多 20 个(申请例外可至 50);短信无法接收时可用语音验证;ISV 流程中客户需在 Meta Business Manager 接受 Twilio 邀请。