用途:在代码中调用 Zavu API 发送消息,覆盖渠道选择、收件人(to)格式、消息类型与错误处理。
渠道:auto、sms、sms_oneway、whatsapp、telegram、email、instagram、messenger、voice。Sender 是作为 Zavu-Sender 传入的 API 句柄,账号(WhatsApp Business、Facebook 主页、Telegram bot、电话号码)是其路由与计费对象;Sender 免费,连接账号会自动创建对应 Sender,可用 GET /v1/senders 查询其 channels。
渠道选择:收件人为邮箱则用 email(需已验证域名);非文本消息用 whatsapp;需语音通话/TTS 用 voice;数字聊天 ID 用 instagram/messenger/telegram;单向短信用 sms_oneway;需指定渠道则显式指定;auto 由 Zavu 选择(非基于成本);默认 sms。
收件人格式:E.164 电话(+14155551234)、邮箱、WhatsApp BSUID(如 US.13491208655302741918)、数字聊天 ID。
主要能力:基础文本发送(多语言 SDK 示例)、WhatsApp 富消息(image、document、video、audio、sticker、location、contact、buttons 最多 3 个、list、template、cta_url)、语音 TTS、单向短信、Instagram/Messenger 消息、表情回应、输入中指示器、Sender 覆盖、幂等键、关闭 WhatsApp 自动回退、查询状态与分页列表。location_request 与 request_contact_info 仅 WhatsApp,暂未生成 SDK,需用 REST 调用。
限制与错误:WhatsApp 24 小时窗口关闭需改用模板;免费计划每月 2000 条(WhatsApp/Telegram/Instagram/Messenger 共享,双向计数);余额不足返回 402;未验证 URL 需先提交;美国/加拿大 +1 号码需 10DLC;发送暂停需联系支持;每日上限按渠道组与验证状态不同;sms、sms_oneway、email、voice 发送前会经内容审查,可能被暂扣或拒绝(RISK_BLOCKED 等),被拒短信不计费,重复拒绝会暂停发送。具体价格、平台与效果以官方文档为准。