Перейти к основному содержанию
GOWA читает конфигурацию из трех мест:
  • Флаги командной строки на whatsapp rest (запустите ./whatsapp rest --help для полного списка).
  • Переменные окружения.
  • файл .env в рабочем каталоге (src/.env при запуске из source; скопируйте src/.env.example).
Файл .env заполняет только те переменные, которые еще не установлены в окружении.
В текущем коде переменные окружения (включая .env) применяются after флаги, поэтому переменная, которая переопределяет флаг соответствия. Настройки OAuth, --allow-unauthenticated, --trusted-origins, --chatwoot-webhook-allow-unsigned, и --webhook-all-device-receipts - исключения, явные флаги которых выиграли. Задайте каждый вариант только на одном месте. Например, WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY=true переопределяет --webhook-insecure-skip-verify=false.
Логические выражения принимают true/false. Длительность использует синтаксис Go (30s, 5m, 3h). Список значений разделен запятыми.

Команды

Сервер

Панель

MCP

Смотрите MCP сервер.

Хранилище

Хранилище чатов (чаты, сообщения, расписание) всегда живет в storages/chatstorage.db и не настраивается. Базы данных SQLite для сессий, хранения чата и OAuth создаются с правами 0600. Каталоги GOWA создаются для этих файлов с помощью 0700. Существующие каталоги сохраняют свои права. Изменения доступа, которые не поддерживаются файловой системой, регистрируются в качестве предупреждений. Для хранилищ сессий и ключей PostgreSQL пропускает или пустой sslmode по умолчанию verify-full для удаленных целей набора. localhost, loopback IP, и Unix сокеты по умолчанию disable. Настройки текущего URI, PGSSLMODE и службы остаются эффективными. Запись PGSERVICE может переопределить режим URI хоста и TLS. Для управляемых PostgreSQL, поставьте sslmode=verify-full и требуемую конфигурацию CA явно.

Поведение WhatsApp

Вебхуки

См. Вебхуки.

Chatwoot

Фильтр событий и вариант одностороннего отзыва доступны в GOWA main после v9.9.0. Смотрите Chatwoot integration для примеров.

Фиксированные ограничения

Они собраны и не могут быть изменены конфигурацией:

URL файлов

Отправлять запросы, которые получают медиа, документы или превью ссылок допускают HTTP и HTTPS URL. Общедоступные URL выборки отклоняют цикл обратного, приватный, ссылка-локальный, метаданные, многоадресные и зарезервированные места назначения. Проверены редиректы и фактический набор адресов. Эти загрузки подключаются напрямую и не используют HTTP_PROXY или HTTPS_PROXY. GOWA может читать собственные URL-адреса /statics с диска. Chatwoot загрузки вложений могут использовать сконфигурированное место назначения или разрешенные хосты, включая внутренний хост, если доверяете этой интеграции. Это исключение не применяется к произвольным URL, отправленным на посылку API. Используйте загрузку файла, когда источник является приватным.

Не используется

src/.env.example отображает WHATSAPP_WEBHOOK_INCLUDE_OUTGOING и WHATSAPP_CHAT_STORAGE, но текущий код тоже не читает. Установка их не имеет никакого эффекта.

Пример

.env
Эквивалентные флаги: