Перейти к основному содержанию
GOWA предлагает два способа получения сообщений:

Вебхуки

Запустите GOWA с URL-адресом и секретным ключом:
Приходит текстовое сообщение:
В группе chat_id является JID группы (...@g.us), а from является участником, который отправил его.

Пример: автоматический ответ бота

Проверьте подпись, подтвердите подтверждение, затем ответьте через API тем же устройством:
Этот минимальный пример подтверждает перед отправкой ответа. Для производства, добавьте проверенное событие в очередь перед его подтверждением, deduplicate по устройству, чату и идентификатору сообщения, а также повторите попытку отправить в вашем работнике. Пропускайте события без session_id или определяйте правильное устройство явно. Исправленный ответ на каждое сообщение WHATSAPP_AUTO_REPLY="We'll get back to you soon" без кода. Смотрите Webhooks для каждого типа события, поля мультимедиа, повторы и URL-адреса для каждого устройства.

Обрабатывать новые формы событий

Заголовок альбома — это событие message с payload.album и не текстовым телом. Каждое изображение или видео следует в качестве отдельного события с payload.album_id. Группируйте медиа по этому идентификатору вместо того, чтобы рассматривать заголовок как недостающее сообщение. newsletter.message содержит обновления счетчиков каналов и не гарантирует тело новости. Онлайн и оффлайн обновление контактов использует presence, требует POST /user/presence/subscribe и требует наличия вашего клиента. Имя группы изменено с помощью group.info. Подпишитесь на device.logged_out, device.temporary_ban, и device.reachout_timelock, чтобы отличить ограничения аккаунта от обычных разъединений. Эти события всегда определяют ячейку с помощью session_id. Смотрите Webhooks для полей и настройки присутствия.

API чата

GOWA записывает чаты и сообщения для каждого слота в локальном хранилище чата. Запросите его на устройство:
Доступны только сообщения GOWA (полученные при подключении или поставляемые историей WhatsApp). Чтобы запросить у телефона старую историю в чате, позвоните в POST /chat/{chat_jid}/history с {"count": 50}; сообщения приходят асинхронно. Опрос подходит для просмотров во входящем и сборочном режиме. Для работы ботов и автоматизации используйте вебхуки.

Загрузка медиа

С автозагрузкой (по умолчанию) webhook задает путь к statics/media/, который используется в http://localhost:3000/statics/media/<file>. В противном случае получайте медиа при требовании:
См. Входящий файл для условий, при которых GOWA может восстановить просроченный файл.

Читать чеки

Отметьте сообщение прочитанным (синие галочки) с помощью POST /message/{message_id}/read и {"phone": "<chat_jid>"}, или установите WHATSAPP_AUTO_MARK_READ=true, чтобы помечать каждое автоматически прочитанное входящее сообщение.