> ## 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.

# Мульти-устройство и выбор устройства

> Запустите несколько аккаунтов WhatsApp на одном сервере GOWA и выберите каждый запрос с X-Device-Id.

![GOWA Multi Device Whats App Architecture](https://mintcdn.com/gowa-docs/ccA2Yz4DVI9xOiS8/images/GOWA-Multi-Device-WhatsApp-Architecture.png?fit=max\&auto=format\&n=ccA2Yz4DVI9xOiS8\&q=85\&s=116b948218cb46aa9eca0b959634eaaf)

"Мульти-устройство" означает две вещи в GOWA:

* **Протокол с несколькими устройствами WhatsApp.** GOWA ссылки на аккаунт как устройство партнера, например WhatsApp Web. Телефону не нужно оставаться в сети, и каждый аккаунт позволяет до четырех связанных компаньонов.
* **Несколько аккаунтов на сервере.** Один GOWA процесс может держать много **слотов устройств**. Каждая пара с другой учетной записью WhatsApp или с тем же номером, что и отдельная компаньон.

## Слоты устройства

У слота есть ID, который вы выбираете (или генерируемый UUID), состояние и, как только связали JID аккаунта.

| Область | Значение |
| - | - |
| `disconnected` | Не подключен к WhatsApp. Здесь начинается новый слот или слот. |
| `connecting` | Идёт подключение. |
| `connected` | Сокет открыт, еще не авторизован (например, при ожидании сканирования QR). |
| `logged_in` | Соединен и готов отправлять и получать. |

### Управление слотами

```bash theme={null}
# Create (device_id is optional)
curl -u admin:changeme -X POST http://localhost:3000/devices \
  -H "Content-Type: application/json" \
  -d '{"device_id": "sales"}'

# List
curl -u admin:changeme http://localhost:3000/devices

# Inspect / live status
curl -u admin:changeme http://localhost:3000/devices/sales
curl -u admin:changeme http://localhost:3000/devices/sales/status

# Pair, log out, reconnect
curl -u admin:changeme http://localhost:3000/devices/sales/login
curl -u admin:changeme -X POST "http://localhost:3000/devices/sales/login/code?phone=628123456789"
curl -u admin:changeme -X POST http://localhost:3000/devices/sales/logout
curl -u admin:changeme -X POST http://localhost:3000/devices/sales/reconnect

# Remove the slot and its session and chat data
curl -u admin:changeme -X DELETE http://localhost:3000/devices/sales
```

Маршруты `/devices/...` берут устройство из пути, поэтому им никогда не нужен `X-Device-Id`. Слоты и сессии сохраняются при перезагрузке.

## Выбор устройства

Каждый маршрут с масштабами устройства (`/send/*`, `/message/*`, `/chat*`, `/group*`, `/user/*`, `/newsletter/*`, `/call/*` и `/app/*`, кроме `/app/info` и `/app/metrics`) должен знать какую учетную запись нужно сделать. GOWA устраняет его в этом порядке:

1. Заголовок `X-Device-Id` (URL-декодировано).
2. Параметр запроса `device_id`.
3. Если ни один из этих ячеек и **ровное** ячейка существует, то это ячейка.

Значение может быть ID слота или JID аккаунта (например, `628123456789@s.whatsapp.net`).

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

# Equivalent, using the query parameter
curl -u admin:changeme -X POST "http://localhost:3000/send/message?device_id=sales" \
  -H "Content-Type: application/json" \
  -d '{"phone": "628123456789", "message": "Hi from the sales number"}'
```

> [!TIP]
>
> Всегда отправляйте `X-Device-Id`, даже с одним слотом. Добавление второго слота позже, в противном случае сделает все невидимые вызовы неудачными при помощи `DEVICE_ID_REQUIRED`.

### Ошибки выбора

| HTTP | `code` | Причина |
| - | - | - |
| 400 | `DEVICE_ID_REQUIRED` | Нет устройства и нуля или нескольких слотов. |
| 404 | `DEVICE_NOT_FOUND` | Нет слотов соответствует данному ID или JID. |
| 503 | `DEVICE_MANAGER_UNAVAILABLE` | Сервер не завершил инициализацию. |

Ячейка существует, но не входит в список пассов; затем ошибка WhatsApp, например "Вы не вошли в систему".

## Функции на устройстве

| Функция | Каким образом она охвачена |
| - | - |
| Вебхуки | Каждая полезная нагрузка несет в себе `device_id` (аккаунт JID) и `session_id` (slot ID). Ячейка может иметь свой вебхук: `PATCH /devices/{device_id}/webhook`. Смотрите [Webhooks](https://gowa-docs.mintlify.site/ru/concepts/webhooks.md#webhooks-%D0%BD%D0%B0-%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%BE). |
| Веб-сокет | Подключитесь к `/ws?device_id=<id>`, чтобы выбрать контекст устройства. Текущий хаб транслирует события для каждого подключенного сокета, поэтому клиенты должны фильтровать идентификаторы устройства. Браузеру необходимо доверять. |
| Запланированные посылки | Относится к слоту, который их создал; перечислите их слотом `X-Device-Id`. |
| MCP | `X-Device-Id` при соединении MCP или аргумент `device_id` на вызов инструмента. Смотрите [MCP сервер](https://gowa-docs.mintlify.site/ru/integrations/mcp.md). |
| Chatwoot | `CHATWOOT_DEVICE_ID` для одной папки входящих или для каждого устройства настроен на одну папку входящих в слот. Смотрите [Chatwoot](https://gowa-docs.mintlify.site/ru/integrations/chatwoot.md). |

## Пределы и оговорки

* WhatsApp позволяет иметь до четырех связанных спутников в одном аккаунте. Каждый слот GOWA в паре с этим аккаунтом использует один.
* WhatsApp связывает компаньон, если телефон находится в оффлайн около 14 дней.
* Синхронизация истории после подключения частично и контролируется WhatsApp; GOWA хранит, что он получает в своем хранилище чатов.
* Для чтения сообщений и чата используется идентификатор хранилища зарегистрированного аккаунта. Не подменять заголовок устройства одного слота при поиске сообщений другого слота. Репаренный слот получает события через его текущий клиент.
* Каждый слот - это полноценное соединение WhatsApp. Память и процессор растут с количеством слотов и громкостью трафика.


## Related topics

- [MCP сервер](https://gowa-docs.mintlify.site/ru/integrations/mcp.md)
- [Справочник по API](https://gowa-docs.mintlify.site/ru/api-reference/introduction.md)
- [Быстрый старт](https://gowa-docs.mintlify.site/ru/quickstart.md)
- [Удалить устройство](https://gowa-docs.mintlify.site/ru/api-reference/device/удалить-устройство.md)
- [Устройство выхода](https://gowa-docs.mintlify.site/ru/api-reference/device/устройство-выхода.md)


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