Перейти к основному содержанию
GOWA поддерживает HTTP Basic Auth и ничего другого: нет ни ключей API, ни токенов предъявителя или JWT для REST API. (MCP может дополнительно принимать токены OAuth; см. MCP сервер.)

Настроить

Каждая пара user:pass через запятую является допустимой логином. Каждая запись должна содержать как имя пользователя, так и пароль. Слушатель нециклического повтора отказывается запускать без полных учетных данных. Привязывайте APP_HOST=127.0.0.1 для локальной разработки, не прошедшей проверку подлинности. Используйте APP_ALLOW_UNAUTHENTICATED=true только в том случае, если лимит авторизации звонящих и прямой доступ к GOWA ограничен.

Отправить учетные данные

Неправильные или отсутствующие учетные данные возвращают 401 Unauthorized.

Общественные маршруты

Веб-сокет

Браузеры не могут устанавливать заголовки при подключении к WebSockt, поэтому /ws также принимает /ws?device_id=my-device&authorization=<base64 user:pass>. Используйте wss:// и redact учетные данные из логов прокси. WebSocket и изменяющиеся состояния HTTP-маршруты отвергают ненадежные источники происхождения браузера. Установите точное происхождение панели инструментов в APP_TRUSTED_ORIGINS или APP_CORS_ALLOWED_ORIGINS. Появление wildcard CORS не предоставляет этот доступ, а null происходит от страниц file://. HTTP мутации от ненадежных источников, возвращающие 403 CROSS_SITE_REQUEST_BLOCKED. Смотрите конфигурацию доступа браузера.

Заголовок устройства

Basic Auth идентифицирует вызывающего API, а не аккаунт WhatsApp. Если существует более одного устройства, каждый вызов, относящийся к конкретному устройству, также требует X-Device-Id. См. Работа с несколькими устройствами.
Базовая аутентификация отправляет учетные данные по каждому запросу. Всегда используйте HTTPS перед GOWA вне доверенной сети.