Zavu API v2 是 Zavu 消息发送平台的 HTTP 接口版本，用于替代 v1 的发送者对象模型。本技能帮助开发者在代码中调用 https://api.zavu.dev/v2，或当用户明确要求 v2 时使用。
用途
- 发送短信、语音、WhatsApp、邮件、Telegram、Instagram、Messenger 等消息，使用地址标识发送方。
- 连接无需购买或 Meta 注册的渠道（邮件、Telegram、单向短信）。
- 按 conversationId 回复会话，配置项目级 webhook 接收事件。
- 管理联系人、活动、模板、AI 代理、号码、邮件域名等资源。
主要能力
- 地址模型：v2 用接收者可见的地址（如 E.164 号码、邮箱、@botname）代替发送者对象，不再使用 Zavu-Sender 头。
- 渠道连接：POST /v2/channels 可连接邮件（需验证域名）、Telegram（需 bot token）、单向短信（无需凭证）；双向短信和语音通过购买号码开通；WhatsApp、Instagram、Messenger 需在仪表盘通过 Meta 连接。
- 消息发送：POST /v2/messages，请求体兼容 v1 消息体并增加 from 和 conversationId；返回 202 包含消息和路由信息。
- 会话回复：传入 conversationId 即可回复，可省略 to；需注意 WhatsApp 24 小时窗口限制。
- Webhook：每个项目一个 webhook，支持事件列表，创建时返回 secret 用于签名验证（X-Zavu-Signature）。
- 其他资源：联系人 CRUD、活动创建与发送、WhatsApp 模板提交、AI 代理连接与测试、号码搜索购买、邮件域名管理、函数配置。
使用方式
- 认证：Authorization: Bearer $ZAVUDEV_API_KEY（与 v1 相同）。
- 调用方式：使用 fetch、curl 或任意 HTTP 客户端；官方 SDK 仅调用 v1。
- 速率限制：按项目共享，与 v1 相同。
- 列表分页：{ items, nextCursor }，将 nextCursor 作为 cursor 传入，直到为 null。
- 金额单位：美元，保留 6 位小数。
- 测试模式密钥始终从 WhatsApp 沙箱发送，from 和 conversationId 被忽略。
适用场景
- 需要在代码中直接通过 HTTP 调用 Zavu 发送多渠消息。
- 需要按地址而非发送者对象管理消息来源。
- 需要统一项目级 webhook 接收所有事件。
- 需要管理联系人、活动、模板、AI 代理等资源。
限制
- v1 未废弃，可继续使用；v1 和 v2 可混用同一 API 密钥和 ID。
- SDK 仅支持 v1，v2 需手动 HTTP 调用。
- 部分功能仅限 v1：语音通话、10DLC、监管要求、地址与文档、自有号码列表/释放、代理工具/流程/知识库、记忆、联系人渠道编辑与合并、消息反应/输入状态/附件、模板同步、子账户、余额、邀请。
- 部分渠道（WhatsApp、Instagram、Messenger）必须通过仪表盘连接，不能通过 API。
- 单向短信对 +1 号码需先通过 10DLC 活动审核；邮件活动需付费计划（Free 计划发送返回 402 paid_plan_required）。
- 错误需按 code 分支处理，不应依赖 message 文本。