> ## 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 читает конфигурацию из трех мест:

* **Флаги командной строки** на `whatsapp rest` (запустите `./whatsapp rest --help` для полного списка).
* **Переменные окружения**.
* **файл `.env`** в рабочем каталоге (`src/.env` при запуске из source; скопируйте `src/.env.example`).

Файл `.env` заполняет только те переменные, которые еще не установлены в окружении.

> [!WARNING]
>
> В текущем коде переменные окружения (включая `.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`). Список значений разделен запятыми.

## Команды

| Команда | Описание |
| - | - |
| `whatsapp rest` | Запустите REST API, dashboard, WebSocket и MCP конечную точку. Требуется с v6; пустые `whatsapp` не запускает сервер. |
| `whatsapp version` | Печатайте версию и выходите. |
| `whatsapp --help` | Список команд и флагов. |

## Сервер

| Переменная | Флаг | По умолчанию | Описание |
| - | - | - | - |
| `APP_PORT` | `--port`, `-p` | `3000` | HTTP порт. |
| `APP_HOST` | `--host`, `-H` | `0.0.0.0` | Привязать адрес. |
| `APP_DEBUG` | `--debug`, `-d` | `false` | Подробный журнал. |
| `APP_OS` | `--os` | `GOWA` | Имя устройства, отображаемое в списке **Связанных устройств** WhatsApp. |
| `APP_BASIC_AUTH` | `--basic-auth`, `-b` | — | Завершите пары `user:pass`, разделенные запятыми. Требуется для non-loopback listener, если не установлено явное неаутентифицированное переопределение. |
| `APP_ALLOW_UNAUTHENTICATED` | `--allow-unauthenticated` | `false` | Разрешение слушателя без Базового Автора. Используйте только за аутентификации прокси с ограниченным прямым доступом. |
| `APP_TRUSTED_ORIGINS` | `--trusted-origins` | — | Допускается создание дополнительных браузеров для мутации состояния и открытия WebSocket.Также доверяются серверу запроса и определенным CORS источникам. |
| `APP_BASE_PATH` | `--base-path` | — | Подавать по подпути, например `/gowa`. `/health` остается в корне. |
| `APP_TRUSTED_PROXIES` | `--trusted-proxies` | — | Диапазоны IP прокси, которым доверяют перенаправленные заголовки, например `10.0.0.0/8`. |
| `APP_CORS_ALLOWED_ORIGINS` | `--cors-allowed-origins` | — (любой источник) | CORS origins. Определенное происхождение также проходит проверку происхождения браузера. Подстановочная карта не разрешает мутации или WebSockets. |

## Панель

| Переменная | Флаг | По умолчанию | Описание |
| - | - | - | - |
| `APP_UI_ENABLED` | `--ui-enabled` | `true` | Сервируйте панель инструментов gowa-ui в `/`. |
| `APP_UI_AUTO_UPDATE` | `--ui-auto-update` | `true` | Скачайте последний релиз панели инструментов при запуске и периодически. Отключайте для воздушного сжатого узла с предустановленным кэшем `storages/ui`. |
| `APP_UI_REPO` | `--ui-repo` | `aldinokemal/gowa-ui` | GitHub репозиторий для загрузки. |
| `APP_UI_ASSET_NAME` | `--ui-asset-name` | `gowa-ui.html` | Отпустите актив для загрузки. |
| `APP_UI_UPDATE_INTERVAL` | `--ui-update-interval` | `3h` | Интервал между проверками обновлений. |
| `APP_UI_GITHUB_TOKEN` | — | — | Токен GitHub для более высокого лимита API. |
| `APP_UI_ASSET_SHA256` | `--ui-asset-sha256` | — | Отправлять панель инструментов только с этой SHA-256. |

## MCP

| Переменная | Флаг | По умолчанию | Описание |
| - | - | - | - |
| `MCP_ENABLED` | `--mcp-enabled` | `true` | Сервируйте конечную точку MCP в `/mcp`. |
| `MCP_OAUTH_ENABLED` | `--mcp-oauth-enabled` | `false` | Включите OAuth 2.1 для `/mcp`. Требуется `APP_BASIC_AUTH`. |
| `MCP_OAUTH_ISSUER_URL` | `--mcp-oauth-issuer-url` | — | Публичный URL эмитента HTTPS. Требуется для OAuth. |
| `MCP_OAUTH_RESOURCE_URL` | `--mcp-oauth-resource-url` | издатель + базовый путь + `/mcp` | Canonical public MCP URL. |
| `MCP_OAUTH_DB_URI` | `--mcp-oauth-db-uri` | `file:storages/oauth.db` | Магазин SQLite для клиентов OAuth и хэшей токенов. |

Смотрите [MCP сервер](https://gowa-docs.mintlify.site/ru/integrations/mcp.md).

## Хранилище

| Переменная | Флаг | По умолчанию | Описание |
| - | - | - | - |
| `DB_URI` | `--db-uri` | `file:storages/whatsapp.db` | Session store: SQLite (`file:...`) or PostgreSQL (`postgres://...`). |
| `DB_KEYS_URI` | `--db-keys-uri` | то же, что и `DB_URI` | Необязательное хранилище кэша ключей шифрования. Избегайте хранения памяти в производстве. |
| `CHAT_STORAGE_MAX_OPEN_CONNS` | — | `5` | Максимальное количество подключений SQLite для хранения чата. Если посылается время ожидания при большой загрузке входящего чата. |

Хранилище чатов (чаты, сообщения, расписание) всегда живет в `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

| Переменная | Флаг | По умолчанию | Описание |
| - | - | - | - |
| `WHATSAPP_AUTO_REPLY` | `--autoreply` | — | Исправлен ответ, отправленный каждому входящему сообщению. |
| `WHATSAPP_AUTO_MARK_READ` | `--auto-mark-read` | `false` | Отметить входящие сообщения прочитанными. |
| `WHATSAPP_AUTO_DOWNLOAD_MEDIA` | `--auto-download-media` | `true` | Сохранить входящий файл в `statics/media`. |
| `WHATSAPP_IGNORE_STATUS_MEDIA` | `--ignore-status-media` | `false` | Пропустить загрузку статуса. |
| `WHATSAPP_AUTO_REJECT_CALL` | `--auto-reject-call` | `false` | Отклонить входящие звонки. |
| `WHATSAPP_ACCOUNT_VALIDATION` | `--account-validation` | `true` | Проверять получателей в WhatsApp перед отправкой. |
| `WHATSAPP_PRESENCE_ON_CONNECT` | `--presence-on-connect` | `unavailable` | Присутствие отправлено при подключении: `available`, `unavailable` или `none`. |
| `WHATSAPP_PRESENCE_PULSE_ENABLED` | `--presence-pulse-enabled` | `true` | Периодически пойти на сайт кратко, а затем оффлайн. |
| `WHATSAPP_PRESENCE_PULSE_INTERVAL` | `--presence-pulse-interval` | `24h` | Время между пульсами. |
| `WHATSAPP_PRESENCE_PULSE_DURATION` | `--presence-pulse-duration` | `5m` | Как долго каждый импульс остается в сети. |
| `WHATSAPP_PROXY` | `--whatsapp-proxy` | — | Прокси для подключения WhatsApp: `socks5://`, `http://` или `https://`. `HTTP_PROXY` к нему не относится. |

## Вебхуки

| Переменная | Флаг | По умолчанию | Описание |
| - | - | - | - |
| `WHATSAPP_WEBHOOK` | `--webhook`, `-w` | — | Webhook URL(s), разделенные запятыми. |
| `WHATSAPP_WEBHOOK_SECRET` | `--webhook-secret` | случайно за процесс | HMAC ключ для `X-Hub-Signature-256`. Установите стабильный сгенерированный ключ. Пустый, `secret`, `super-secret-key`, и `your-private-key` вместо него генерирует эфемерный ключ. |
| `WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY` | `--webhook-insecure-skip-verify` | `false` | Пропустить проверку TLS (только разработка). |
| `WHATSAPP_WEBHOOK_EVENTS` | `--webhook-events` | — (все) | Разрешено событие, например `message,message.ack`. |
| `WHATSAPP_WEBHOOK_IGNORE_JIDS` | `--webhook-ignore-jids` | — | Идентификаторы JID или шаблоны (`@g.us`, `@s.whatsapp.net`, `@lid`) не переадресованы. |
| `WHATSAPP_WEBHOOK_DEVICE_MERGE_GLOBAL` | `--webhook-device-merge-global` | `false` | Отправлять события устройства на глобальные URL, а также на собственный вебхук. |
| `WHATSAPP_WEBHOOK_ALL_DEVICE_RECEIPTS` | `--webhook-all-device-receipts` | `false` | Перенаправлять квитанции с устройств связанных с ними контактов, а также с их основным устройством. Может быть выдано несколько подтверждений за одно сообщение. |

См. [Вебхуки](https://gowa-docs.mintlify.site/ru/concepts/webhooks.md).

## Chatwoot

| Переменная | Флаг | По умолчанию |
| - | - | - |
| `CHATWOOT_ENABLED` | `--chatwoot-enabled` | `false` |
| `CHATWOOT_URL` | — | — |
| `CHATWOOT_API_TOKEN` | — | — |
| `CHATWOOT_ACCOUNT_ID` | — | — |
| `CHATWOOT_INBOX_ID` | — | — |
| `CHATWOOT_DEVICE_ID` | `--chatwoot-device-id` | — |
| `CHATWOOT_ALLOWED_HOSTS` | `--chatwoot-allowed-hosts` | — |
| `CHATWOOT_IMPORT_MESSAGES` | `--chatwoot-import-messages` | `false` |
| `CHATWOOT_DAYS_LIMIT_IMPORT_MESSAGES` | `--chatwoot-days-limit-import-messages` | `3` |
| `CHATWOOT_IMPORT_DB_URI` | `--chatwoot-import-db-uri` | — |
| `CHATWOOT_IMPORT_PLACEHOLDER_MEDIA_MESSAGE` | `--chatwoot-import-placeholder-media-message` | `true` |
| `CHATWOOT_IMPORT_MEDIA_WITH_REST` | `--chatwoot-import-media-with-rest` | `false` |
| `CHATWOOT_AUTO_CREATE` | `--chatwoot-auto-create` | `false` |
| `CHATWOOT_INBOX_NAME` | `--chatwoot-inbox-name` | `WhatsApp` |
| `CHATWOOT_WEBHOOK_URL` | `--chatwoot-webhook-url` | — |
| `CHATWOOT_WEBHOOK_SECRET` | `--chatwoot-webhook-secret` | — |
| `CHATWOOT_WEBHOOK_ALLOW_UNSIGNED` | `--chatwoot-webhook-allow-unsigned` | `false` |
| `CHATWOOT_WEBHOOK_SIGNATURE_TOLERANCE` | `--chatwoot-webhook-signature-tolerance` | `5m` |
| `CHATWOOT_REOPEN_CONVERSATION` | `--chatwoot-reopen-conversation` | `true` |
| `CHATWOOT_CONVERSATION_PENDING` | `--chatwoot-conversation-pending` | `false` |
| `CHATWOOT_IGNORE_JIDS` | `--chatwoot-ignore-jids` | — |
| `CHATWOOT_SIGN_MSG` | `--chatwoot-sign-msg` | `false` |
| `CHATWOOT_SIGN_DELIMITER` | `--chatwoot-sign-delimiter` | `\n\n` |
| `CHATWOOT_FORWARD_EDITS` | `--chatwoot-forward-edits` | `true` |
| `CHATWOOT_FORWARD_DELETES` | `--chatwoot-forward-deletes` | `true` |
| `CHATWOOT_EVENTS` | `--chatwoot-events` | Отслеживает `WHATSAPP_WEBHOOK_EVENTS` когда пуст |
| `CHATWOOT_MESSAGE_READ` | `--chatwoot-message-read` | `false` |
| `CHATWOOT_MESSAGE_DELETE` | `--chatwoot-message-delete` | `false` |
| `CHATWOOT_REVOKE_ON_DELETE` | `--chatwoot-revoke-on-delete` | `false` |

Фильтр событий и вариант одностороннего отзыва доступны в GOWA `main` после v9.9.0. Смотрите [Chatwoot integration](https://gowa-docs.mintlify.site/ru/integrations/chatwoot.md#%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F) для примеров.

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

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

| Лимит | Значение |
| - | - |
| Загрузка изображения | 20 МБ |
| Загрузка документа | 50 МБ |
| Видео загрузка и тело HTTP-запроса | 100 МБ |
| Загрузка входящих файлов | 500 МБ |
| Таймаут запроса | 45 с (`504 GATEWAY_TIMEOUT`) |
| Доставка вебхука | 10 сек за попытку, 5 попыток |

## 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`, но текущий код тоже не читает. Установка их не имеет никакого эффекта.

## Пример

```bash .env theme={null}
APP_PORT=3000
APP_OS=MyCompany
APP_BASIC_AUTH=admin:a-long-random-password
APP_TRUSTED_PROXIES=10.0.0.0/8
DB_URI=postgres://gowa:replace-with-password@db.example.com:5432/gowa?sslmode=verify-full
WHATSAPP_WEBHOOK=https://example.com/wa-hook
WHATSAPP_WEBHOOK_SECRET=another-long-random-secret
WHATSAPP_WEBHOOK_EVENTS=message,message.ack
WHATSAPP_AUTO_MARK_READ=false
```

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

```bash theme={null}
./whatsapp rest --port=3000 --os=MyCompany \
  --basic-auth=admin:a-long-random-password \
  --webhook=https://example.com/wa-hook \
  --webhook-secret=another-long-random-secret \
  --webhook-events=message,message.ack
```


## Related topics

- [Быстрый старт](https://gowa-docs.mintlify.site/ru/quickstart.md)
- [Ссылка на приглашение в группу](https://gowa-docs.mintlify.site/ru/api-reference/group/ссылка-на-приглашение-в-группу.md)
- [Удалить конфигурацию Chatwoot устройства](https://gowa-docs.mintlify.site/ru/api-reference/chatwoot/удалить-конфигурацию-chatwoot-устройства.md)
- [Получить конфигурацию Chatwoot устройства](https://gowa-docs.mintlify.site/ru/api-reference/chatwoot/получить-конфигурацию-chatwoot-устройства.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.