用途:本技能是 Twilio WhatsApp 消息发送的深入参考,说明如何通过 Programmable Messaging API 向 WhatsApp 发送消息。所有号码使用 whatsapp:+E.164 前缀,统一调用 messages.create()。
主要能力:支持两种发送模式。自由格式(free-form)仅在用户最近一次来信后 24 小时内可用,参数为 body 和可选 mediaUrl;模板(template)任意时间可用,参数为 contentSid 与 contentVariables。支持发送媒体文件,最大 16 MB。
使用方式:需具备已启用 WhatsApp 的 Twilio 账户,配置环境变量 TWILIO_ACCOUNT_SID 与 TWILIO_AUTH_TOKEN,安装 SDK(pip install twilio 或 npm install twilio),且接收方已选择接收消息。测试可用沙箱:向 +14155238886 发送 join <your-code>,参与者每 3 天需重新加入。生产环境需先注册 WhatsApp Business 发送方。模板需在 Console 的 Content Template Builder 创建并经 Meta 审批。
响应字段包括 sid、status(queued、sent、delivered、read、failed、undelivered)、error_code、error_message、date_sent。常见错误:63003 目标号码无效、63018 发送方超速率、63020 未接受 Meta 邀请,以及窗口外发送自由格式消息会静默失败。
限制:每发送方不超过 80 条/秒(纯文本可申请提升至 400 MPS);消息排队不超过 4 小时;沙箱限 1 条/3 秒、试用期 50 条/天;未获用户选择接收不得发送,否则有账户被暂停风险;WhatsApp Groups API 已于 2020 年 4 月弃用,应改用 Conversations API。
适用场景:订单确认、发票发送、模板通知等 WhatsApp 消息集成。