> ## 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, подключите WhatsApp аккаунт и отправьте первое сообщение через несколько минут.

## 1. Запустить сервер

> [tab] Докер
>
> ```bash theme={null}
> docker run -d --name gowa \
>   -p 3000:3000 \
>   -v gowa_storages:/app/storages \
>   -v gowa_statics:/app/statics \
>   -e APP_BASIC_AUTH=admin:changeme \
>   aldinokemal2104/go-whatsapp-web-multidevice:latest
> ```
>
> По умолчанию команда изображения `rest`, поэтому аргументов не требуется. То же изображение публикуется как `ghcr.io/aldinokemal/go-whatsapp-web-multidevice`.

> [tab] Двоичный
>
> Скачайте архив для своей платформы с [последней стабильной версии](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest). В этом примере используется архив Linux amd64 v9.9.0. Заменяйте имя загруженного файла.
>
> ```bash theme={null}
> unzip whatsapp_9.9.0_linux_amd64.zip
> chmod +x whatsapp
> ./whatsapp rest --basic-auth=admin:changeme
> ```
>
> Сначала установите FFmpeg и libwebp (`cwebp`). GOWA использует их для конвертации медиа.

> [tab] Из источника
>
> Требуется Go 1.26+, FFmpeg и libwebp.
>
> ```bash theme={null}
> git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
> cd go-whatsapp-web-multidevice/src
> go run . rest --basic-auth=admin:changeme
> ```

Проверить вверх:

```bash theme={null}
curl http://localhost:3000/health
# OK
```

> [!NOTE]
>
> Слушатель non-loopback по умолчанию требует полных учетных данных `APP_BASIC_AUTH`. Для неаутентифицированной локальной разработки привяжите `APP_HOST=127.0.0.1`. Аутентификационный обратный прокси может использовать явное значение `APP_ALLOW_UNAUTHENTICATED=true`. См. [authentication](https://gowa-docs.mintlify.site/ru/authentication.md).

## 2. Создайте устройство

Каждый аккаунт WhatsApp живет в слоте устройства. Создайте его и дайте ему идентификатор, который вы будете повторно использовать:

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/devices \
  -H "Content-Type: application/json" \
  -d '{"device_id": "my-device"}'
```

Omit `device_id`, чтобы получить сгенерированный UUID.

## 3. Привязать аккаунт

> [tab] QR code
>
> ```bash theme={null}
> curl -u admin:changeme http://localhost:3000/devices/my-device/login
> ```
>
> Откройте `results.qr_link` в браузере и отсканируйте его из WhatsApp → **Связанные устройства** → **Связать устройство**. Код истекает после `results.qr_duration` секунд; запросить новый, если он падает.

> [tab] Pairing code
>
> ```bash theme={null}
> curl -u admin:changeme -X POST \
>   "http://localhost:3000/devices/my-device/login/code?phone=628123456789"
> ```
>
> Введите `results.pair_code` в телефоне в разделе **Связанные устройства** → **Привязать номер телефона**.

> [tab] Панель
>
> Откройте `http://localhost:3000/`, введите основные учетные данные авторизации при появлении запросов браузера и подключите устройство к интерфейсу.

Подтвердите вход с устройства (`results.is_logged_in` должен быть `true`):

```bash theme={null}
curl -u admin:changeme http://localhost:3000/devices/my-device/status
```

## 4. Отправить сообщение

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" \
  -H "X-Device-Id: my-device" \
  -d '{"phone": "628123456789", "message": "Hello from GOWA"}'
```

```json theme={null}
{
  "code": "SUCCESS",
  "message": "Success",
  "results": {
    "message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
    "status": "Message sent to 628123456789 (server timestamp: ...)"
  }
}
```

`phone` занимает число с кодом страны и не имеет пробелов или символ `+` или полный JID, например `628123456789@s.whatsapp.net` или `120363025246125486@g.us` для группы. Только одно устройство зарегистрировано, `X-Device-Id` не является обязательным.

## 5. Получать сообщения

Перезапустите с веб-хука URL, и GOWA будет POST каждое событие:

```bash theme={null}
export WHATSAPP_WEBHOOK_SECRET="$(openssl rand -hex 32)"
./whatsapp rest --basic-auth=admin:changeme --webhook=https://example.com/wa-hook
```

Сохраните сгенерированный секрет webhook и настройте то же значение на приемнике. Повторное использование после перезапуска. Смотрите [Webhooks](https://gowa-docs.mintlify.site/ru/concepts/webhooks.md) для проверки полезных нагрузок и подписи.

## Следующие шаги

> [card] [Установка](https://gowa-docs.mintlify.site/ru/installation.md)
>
> Docker Compose, reverse proxy, PostgreSQL.

> [card] [Ссылка на конфигурацию](https://gowa-docs.mintlify.site/ru/configuration.md)
>
> Каждый флаг и окружающая среда переменные.

> [card] [Мульти-устройство](https://gowa-docs.mintlify.site/ru/concepts/multidevice.md)
>
> Запустите несколько аккаунтов на одном сервере.

> [card] [Справочник по API](https://gowa-docs.mintlify.site/ru/api-reference/introduction.md)
>
> Все конечные точки.


## Related topics

- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/ru/index.md)


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