SuperAPI AI 工具集

whatsapp-alt

办公与效率

查看项目

更新于 10-16 06:16

技能介绍

用途:通过扫描二维码(类似 WhatsApp Web 链接设备)把 WhatsApp 号码接入 Zavu,无需 Meta 商业账户、模板审批或 24 小时窗口,链接后即可在 whatsapp_alt 渠道收发消息。适合号码未接入官方 WhatsApp Business 平台、需快速上线或自动化现有个人/商业号码的场景,用于双向、经同意的对话。

主要能力:支持文本、媒体(图片、视频、音频、文档、贴纸)、位置、联系人、表情回应;支持群组收发(以群 JID 作为 to);可接收状态/故事更新(message.status 事件,需在 webhookEvents 中显式订阅);入站消息以 message.inbound 事件推送,送达与已读回执为 message.delivered / message.read。

使用方式:会话通过 REST 端点 /v1/whatsapp-alt/* 管理(创建会话、轮询二维码、扫码、链接到 sender、重连、登出、删除等),发送消息使用 zavu.messages.send 并设置 channel: "whatsapp_alt",通过 Zavu-Sender 头指定 sender。会话状态包括 initializing、qr_ready、authenticating、ready、disconnected、failed。出口必须使用 Zavu 住宅代理(external,按 GB 计费)或自控 Android 出口设备(android,需 nodeId),禁止直连数据中心 IP。

限制:该功能为受限特性,需团队启用后才可用,测试模式 API 密钥(zv_test_...)不可用;发送需团队已启用且 sender 有已连接会话;群 JID 仅在该渠道有效;群成员变更事件暂不发出;媒体字节不下载,仅元数据与文本;高并发或未经请求的发送可能导致号码被封。