> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Получение сообщений

> Обрабатывайте входящие сообщения веб-хуками, или читайте хранимые чаты и сообщения из хранилища чата GOWA.

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

| Метод | Использовать для |
| - | - |
| **Webhooks** (рекомендуется) | Реакция на события в режиме реального времени. GOWA толкает каждое событие на ваш URL. |
| **API для хранения чата** | История чтения, извлечение после простоя, просмотр папки "входящие". |

## Вебхуки

Запустите GOWA с URL-адресом и секретным ключом:

```bash theme={null}
./whatsapp rest --basic-auth=admin:changeme \
  --webhook=https://example.com/wa-hook \
  --webhook-secret=change-me \
  --webhook-events=message,message.ack
```

Приходит текстовое сообщение:

```json theme={null}
{
  "event": "message",
  "device_id": "628123456789@s.whatsapp.net",
  "session_id": "my-device",
  "payload": {
    "id": "3EB0C127D7BACC83D6A1",
    "chat_id": "628987654321@s.whatsapp.net",
    "from": "628987654321@s.whatsapp.net",
    "from_name": "John Doe",
    "sender_display_name": "John Doe",
    "timestamp": "2026-10-15T10:30:00Z",
    "is_from_me": false,
    "body": "Hello, how are you?"
  }
}
```

В группе `chat_id` является JID группы (`...@g.us`), а `from` является участником, который отправил его.

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

Проверьте подпись, подтвердите подтверждение, затем ответьте через API тем же устройством:

```javascript theme={null}
const express = require("express");
const crypto = require("crypto");

const GOWA = "http://localhost:3000";
const AUTH = "Basic " + Buffer.from("admin:changeme").toString("base64");
const SECRET = "change-me";

const app = express();
app.post("/wa-hook", express.raw({ type: "application/json" }), async (req, res) => {
  const sig = crypto.createHmac("sha256", SECRET).update(req.body).digest("hex");
  const received = req.get("X-Hub-Signature-256") || "";
  const expected = `sha256=${sig}`;
  if (!/^sha256=[0-9a-f]{64}$/.test(received) ||
      received.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected))) {
    return res.sendStatus(401);
  }
  const evt = JSON.parse(req.body);
  res.sendStatus(200);
  if (evt.event !== "message" || evt.payload.is_from_me) return;
  if (!evt.session_id) return;
  if (!/^hi\b/i.test(evt.payload.body || "")) return;

  const response = await fetch(`${GOWA}/send/message`, {
    method: "POST",
    headers: {
      Authorization: AUTH,
      "Content-Type": "application/json",
      "X-Device-Id": evt.session_id,          // reply from the slot that received it
    },
    body: JSON.stringify({
      phone: evt.payload.chat_id,
      message: "Hello! How can we help?",
      reply_message_id: evt.payload.id,
    }),
  });
  if (!response.ok) console.error("GOWA reply failed", response.status);
});
app.listen(8080);
```

Этот минимальный пример подтверждает перед отправкой ответа. Для производства, добавьте проверенное событие в очередь перед его подтверждением, deduplicate по устройству, чату и идентификатору сообщения, а также повторите попытку отправить в вашем работнике. Пропускайте события без `session_id` или определяйте правильное устройство явно.

Исправленный ответ на каждое сообщение `WHATSAPP_AUTO_REPLY="We'll get back to you soon"` без кода.

Смотрите [Webhooks](https://gowa-docs.mintlify.site/ru/concepts/webhooks.md) для каждого типа события, поля мультимедиа, повторы и 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](https://gowa-docs.mintlify.site/ru/concepts/webhooks.md) для полей и настройки присутствия.

## API чата

GOWA записывает чаты и сообщения для каждого слота в локальном хранилище чата. Запросите его на устройство:

```bash theme={null}
# list chats (filters: search, has_media, archived; paging: limit, offset)
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/chats?limit=20"

# messages in one chat (filters: start_time, end_time, media_only, is_from_me, search)
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/chat/628987654321@s.whatsapp.net/messages?limit=50"
```

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

Опрос подходит для просмотров во входящем и сборочном режиме. Для работы ботов и автоматизации используйте вебхуки.

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

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

```bash theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/message/3EB0C127D7BACC83D6A3/download?phone=628987654321@s.whatsapp.net"
```

См. [Входящий файл](https://gowa-docs.mintlify.site/ru/examples/media-handling.md#%D0%B2%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D0%B9-%D0%BC%D0%B5%D0%B4%D0%B8%D0%B0) для условий, при которых GOWA может восстановить просроченный файл.

## Читать чеки

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


## Related topics

- [Получать счетчики сообщений](https://gowa-docs.mintlify.site/ru/api-reference/newsletter/получать-счетчики-сообщений.md)
- [Вебхуки](https://gowa-docs.mintlify.site/ru/concepts/webhooks.md)
- [Отправка сообщений](https://gowa-docs.mintlify.site/ru/examples/sending-messages.md)
- [Установить исчезающий таймер сообщений](https://gowa-docs.mintlify.site/ru/api-reference/chat/установить-исчезающий-таймер-сообщений.md)
- [Синхронизировать историю сообщений в Chatwoot](https://gowa-docs.mintlify.site/ru/api-reference/chatwoot/синхронизировать-историю-сообщений-в-chatwoot.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.