用途:通过 Twilio Channels Senders API 程序化创建、配置和管理 WhatsApp Business 发送者(即注册到 WhatsApp Business 的电话号码)。沙箱测试无需注册发送者。
前提条件:已升级的 Twilio 账户(试用账户无法注册生产发送者);可接收短信或语音验证的电话号码;该号码未注册过 WhatsApp;需配置环境变量 TWILIO_ACCOUNT_SID 与 TWILIO_AUTH_TOKEN;SDK 安装命令为 pip install twilio 或 npm install twilio。
主要能力:发起注册(create,指定 sender_id 与 verification_method),提交 Twilio 发送的 OTP(update verification_code)完成验证;设置业务资料(profile_name、profile_about、profile_address、profile_vertical、profile_logo_url、profile_websites);配置 Webhook(callback_url、callback_method、status_callback_url);查询与列出发送者(fetch、list)。
发送者生命周期状态:CREATING(已发起注册)、PENDING_VERIFICATION(等待提交 OTP)、VERIFYING(验证 OTP 中)、TWILIO_REVIEW(Twilio/Meta 审核中)、ONLINE(可用)、OFFLINE(不可用,需查看 offlineReasons)、DRAFT(注册未完成)。
迁移已有号码:先访问 https://wa.me/<PHONE_NUMBER>?text=hi 检查,删除设备上现有 WhatsApp 账户或关闭竞争平台的 2FA,再按上述流程注册。
ISV/技术提供商流程:在客户的 WABA 下注册发送者,create 时传入 waba_id,客户需在 Meta Business Manager 中接受 Twilio 邀请。
限制:一个号码同一时间只能属于一个 WABA;未完成 Meta 企业验证的账户最多 2 个发送者;已验证的 Meta Business Manager 最多 20 个(申请例外可至 50);短信无法接收时可用语音验证。
后续步骤:使用该发送者发送消息、创建消息模板、发送 WhatsApp OTP。