用途:zavu-rules 是 Zavu 统一多通道消息 API 的基础上下文,始终加载,帮助开发者在短信、WhatsApp、Telegram、Email、Instagram、Voice 等通道上发送消息,并支持自动选路与回退。
主要能力与使用方式:提供多语言 SDK,包括 TypeScript(npm add @zavudev/sdk)、Python(pip install zavudev,含 AsyncZavudev)、Go(go get github.com/zavudev/sdk-go)、PHP、Ruby。CLI 可用 npx zavudev@latest 运行或 npm install -g zavudev 安装,并管理 Zavu Functions(Zavu Cloud 上的无服务器 TypeScript)。函数运行时预装 @zavudev/functions,提供 defineAgent、defineTool、defineFunction。鉴权使用环境变量 ZAVUDEV_API_KEY,密钥前缀 zv_live_、zv_test_,请求头 Authorization: Bearer <api_key>,可用 Zavu-Sender 覆盖发送方。
约定与限制:电话号码用 E.164 格式;渠道含 auto、sms、sms_oneway、whatsapp、telegram、email、instagram、messenger、voice;消息类型丰富;列表接口采用游标分页并返回 items 与 nextCursor;发送可用 idempotencyKey 防重。业务规则方面,WhatsApp 自由文本需 24 小时会话窗口,否则用模板;含 URL 的短信与邮件须先经 /v1/urls 预验证,短链服务被禁用;auto 按固定偏好选首个可用渠道,不考虑成本,基于成本的智能选路仅用于 broadcast。验证只提升每日上限而非发送权限,超限返回 429 daily_limit_exceeded;美国与加拿大 +1 短信需 10DLC 注册(KYB 门控,403 ten_dlc_required)。sms、sms_oneway、email、voice 发送前会经审核,可被暂扣或拒绝(RISK_BLOCKED、RISK_REJECTED、RISK_REVIEW_EXPIRED),反复拒绝会暂停发送(403 sending_suspended)。
其他:可通过 MCP 在 AI 助手中执行,命令为 claude mcp add --transport stdio zavudev_sdk_api --env ZAVUDEV_API_KEY=$ZAVUDEV_API_KEY -- npx -y @zavudev/sdk-mcp,提供 search_docs 与 execute 工具。速率限制见 X-RateLimit-Remaining 头。消息状态包括 queued、sending、sent、delivered、read、failed、received、pending_url_verification。语音智能体需开启 voice 配置并使用 live key,经 /v1/calls 发起并获取转录。