跳转到主要内容
POST /send/interactive 通过选定的设备发送 WhatsApp 本地流消息。 使用 Basic Auth, X-Device-Id 和 JSON 机构。此端点支持即时REST 发送。预定的发送和 MCP不会暴露它。
此实验性端点使用非官方的 WhatsApp 协议。接收方的渲染因客户而异,可以随时更改。 使用前测试您的目标客户端。成功的 API 响应确认发送接受,而不是发送或渲染。
在运行曲线示例之前设置服务器 URL 和凭据。使用远程服务器的公共HTTPS URL,并在配置时包含 APP_BASE_PATH 。

发送按钮

phone 接受一个电话号码或完整的用户或组 JID。 群组发送需要成员资格和发布权限。不支持通讯和广播接收者。 提供顶级的 buttons 或 cards。提供两者或两者均未被验证。 选择列表使用这些参数:

请求一个位置

发送此 JSON 到 /send/interactive 。收件人必须选择共享位置。如果没有他们的动作,端点不会检索位置。

发送一张图像轮播!

用原始标准基准64替换图像占位符,没有数据URL前缀。图像是可选的。 GOWA 调整提供的图像大小以适应1280像素,将它们转换为 JPEG,创建缩略图,并将它们上传到 WhatsApp。远程图像URL不被接受。

请求限制

服务器总的HTTP请求体限制也适用。发送几张卡片时使用小图像。 无效的选项或大小在发送前返回验证错误。

处理回复和回复

成功发送返回 results.message_id 的正常成功信封,并且状态表明收件人渲染未被验证。 使用 传入Webhooks 的回复和 message.ack 事件的收据。在模糊的超时后重试可能会重复消息。 下游安卓测试报告了工作回复、URL、复制、电话、选择、位置和旋转操作。 这些报告没有确定不同账户、iOS或WhatsApp Web之间的兼容性。 单独的旋转卡片可以显示待处理图标,即使父消息有勾选标记,收件人也可以回复。该问题仍未解决。 端点不注册官方模板或支持内联流、目录或本机付款。