跳转到主要内容
GOWA提供了两种接收信息的方式:

Webhooks

使用 webhook URL 和 secret启动 GOWA:
收到的文本信息为:
在群组中,chat_id 是群组 JID(...@g.us),from 则是发送消息的成员。

示例:自动回复机器人

使用相同的设备验证签名,确认并通过 API 答复:
这个最低限度的例子在发出答复之前就予以确认。 对于生产者来说,在确认之前对已验证的事件进行持久排队,通过设备、 聊天和消息ID进行反复,并且在您的工作人员中重新尝试失败发送。 跳过事件没有 session_id 或明确解析正确的设备。 如果要对每条消息发送固定回复,设置 WHATSAPP_AUTO_REPLY="We'll get back to you soon" 即可,无需编写代码。 每个事件类型、媒体字段、 重试和每个设备的 URL,请参阅 Webhooks。

处理新事件形状

专辑头是 payload.album 的 message 事件,没有文字正文。每个图像或视频都会作为一个单独的媒体事件使用 payload.album_id。用该ID来分组媒体,而不是将标题视为缺失的消息。 newsletter.message 包含频道计数器更新,不能保证一个新的帖子。 在线和离线联系更新使用 presence ,需要 POST /user/presence/subscribe ,并要求您的客户端继续可用。群组名称更改使用 group.info 。 订阅 device.logged_out、device.temporary_ban 和 device.reachout_timelock,以区分账号限制与普通断开连接。这些事件始终通过 session_id 标识设备槽位。有关字段和在线状态配置,请参阅 Webhook。

聊天存储 API

GOWA 在其本地聊天存储中记录每个位置的聊天和消息。每台设备查询:
只能获取 GOWA 已见过的消息(连接期间收到的消息,或由 WhatsApp 历史同步传来的消息)。若要请求手机提供某个聊天中更早的历史消息,请调用 POST /chat/{chat_jid}/history 并携带 {"count": 50};消息会异步到达。 投票适合于补丁和收件箱视图。对于机器人和自动化,请使用 web 钩子。

正在下载媒体

当自动下载(默认)时,webhook 会在statics/media/下提供路径,服务于http://localhost:3000/statics/media/<file>。否则需要获取媒体:
查看 传入媒体 的条件,GOWA 可以恢复过期文件。

读取收入

使用 POST /message/{message_id}/read 和 {"phone": "<chat_jid>"} 将消息标记为已读(蓝色双勾),或设置 WHATSAPP_AUTO_MARK_READ=true,自动将所有收到的消息标记为已读。