用途:在代码中创建、管理并发送 WhatsApp 模板消息。当用户 24 小时内未主动发消息、需要群发广播或主动外发通知时,必须使用模板消息。
主要能力:模板分 UTILITY(交易通知)、MARKETING(营销)、AUTHENTICATION(验证码)三类。支持按渠道设置不同正文(body 为 WhatsApp 默认,smsBody、telegramBody、instagramBody 可覆盖),支持快捷回复、URL、电话、请求联系人信息及 OTP 按钮,OTP 支持 COPY_CODE 与 Android ONE_TAP 自动填充。
使用方式:通过 SDK 调用 zavu.templates.create 创建,字段含 name、language、body、whatsappCategory、variables 等,提供 JavaScript、Python、Go、Ruby、PHP 示例。创建后调用 zavu.templates.submit 提交 Meta 审核,状态经 draft→pending→approved/rejected。发送时用 zavu.messages.send,messageType 设为 template,content 传 templateId 与 templateVariables。可用 list、get、delete(仅草稿)管理模板。
限制:模板名须小写加下划线;变量用 {{1}} 位置格式;最多 3 个按钮,按钮文字不超过 25 字符;ONE_TAP 需 Android 包名与签名哈希;addSecurityRecommendation 与 codeExpirationMinutes(1-90)仅限 AUTHENTICATION。分类由 Meta 最终决定,可能被重新归类(常见 UTILITY 转 MARKETING)并影响计费,应读取 template.category 而非假定提交值。审核通常数分钟至数小时,最长 24 小时,被拒可修改后重提。
同步:POST /v1/templates/sync 可导入 Meta 侧已有模板并刷新状态与分类,SDK 暂未生成该方法,需用 REST 调用,示例:curl -X POST https://api.zavu.dev/v1/templates/sync -H "Authorization: Bearer $ZAVU_API_KEY" -H "Content-Type: application/json" -d '{}'。该调用同步等待 Meta,可能耗时数秒;无 WhatsApp Business Account 时返回 400。