Требования
- GOWA доступен с Chatwoot через публичный URL (для agent-reply webhooks).
- Учетная запись Chatwoot с правами администратора и маркером доступа к API пользователя.
- По крайней мере одно залогиненное устройство WhatsApp.
Настроить
1
Создать входящий API канал
В Чате перейдите в Настройки → Входящие → Добавить Входящие → API. Обратите внимание на числовые входящие ID по адресу “Входящие” и на секрет webhook в чате для канала. Или пусть GOWA создаст входящие (см. Auto-provisioning).
2
Сбор идентификаторов и токена
ID аккаунта — это число в
/app/accounts/<id>/.... Скопируйте пользователя маркер доступа из настроек профиля. Оба идентификатора должны быть цифровыми идентификаторами, а не идентификатором канала identifier или hmac_token.3
Настроить GOWA
.env
4
Точка Чатвут на GOWA
Установите URL-адрес канала API в
https://gowa.example.com/chatwoot/webhook (с APP_BASE_PATH, укажите путь к базе данных). Этот маршрут является общедоступным: он защищен секретом webhook, а не Базовым Автом.5
Тест
Сообщайте номер WhatsApp с другого телефона; он должен появиться в папке “Входящие”. Ответьте из Чатвута и проверьте, что он прибудет на WhatsApp.
Конфигурация
У большинства настроек также есть флаг
--chatwoot-*; CHATWOOT_URL, CHATWOOT_API_TOKEN, CHATWOOT_ACCOUNT_ID и CHATWOOT_INBOX_ID задаются только через переменные окружения. См. справочник конфигурации.
Для GOWA main после v9.9.0 установите CHATWOOT_EVENTS=message, чтобы поддерживать зеркалирование сообщений в Chatwoot при фильтрации обычных доставки веб-хука отдельно. Селектор message также позволяет реакции, квитанции, правки и удалять через фильтр Chatwoot. Все еще применяются параметры для чтения, редактирования и удаления.
Оставьте поле CHATWOOT_EVENTS пустым, чтобы наследовать WHATSAPP_WEBHOOK_EVENTS. Если эффективный фильтр пуст, он позволяет все поддерживаемые события. Если он исключает message, GOWA записывает предупреждение при запуске и останавливает зеркалирование сообщений WhatsApp в Chatwoot.
В этих сборках GOWA посылает токен пользователя Chatwoot в заголовке api-access-token, чтобы nginx мог передать его с параметрами заголовка по умолчанию.
Секрет Webhook
Пустой эффективный секретный вебхук отказывает в доставке.CHATWOOT_WEBHOOK_ALLOW_UNSIGNED=true явно разрешает доставку без знака, когда эффективный секрет пуст. С помощью секретного ключа каждый запрос должен доказать его одним из:
- Chatwoot’s signature (
X-Chatwoot-Signature+X-Chatwoot-Timestamp), рекомендуется. Используйте собственный секрет webhook каналов. GOWA проверяет HMAC-SHA256 из<timestamp>.<raw body>и отвергает временные метки вне настроенного допущения. X-Hub-Signature-256HMAC тела.- Секрет в заголовке
X-Chatwoot-Webhook-SecretилиX-Gowa-Chatwoot-Secret. ?secret=в URL webhook, только для версий Chatwoot, которые не могут подписать или добавить заголовки. Секрет, затем появляется в логах доступа.
401; GOWA записывает причину в журнал (signature does not match означает неверный секрет, timestamp outside the tolerance window — расхождение часов).
webhook_secret на устройстве заменяет глобальный секрет для этого устройства как на общедоступных терминалах, так и на отдельных устройствах. Без секретного устройства глобальная секретная информация будет сохранена. GOWA проверяет секрет маршрутизированного устройства перед отправкой, удалением, маркировкой чтения или записью данных. При использовании нескольких устройств одним и тем же идентификатором учетной записи и папки “входящие” предпочтение отдается URL обратного вызова на устройство.
Повторный запрос с подписью Chatwoot, на который уже был получен ответ 2xx, подтверждается ответом 200 и пропускается в пределах допустимого временного окна. Неудавшиеся запросы можно повторять. Идентичный запрос, обработка которого ещё продолжается, может получить 503 после ожидания до 30 секунд. Данные для защиты от повторов хранятся локально в процессе, теряются при перезапуске и ограничены 65,536 принятыми запросами. Они не разделяются между экземплярами GOWA. Две доставки одного сообщения Chatwoot с отдельными подписями по-прежнему могут привести к двойной отправке. HMAC только для тела запроса, заголовки с секретом и секреты в параметрах запроса не обеспечивают такую дедупликацию доставок.
Автонастройка
СCHATWOOT_AUTO_CREATE=true без CHATWOOT_INBOX_ID, GOWA ищет входящий API с именем CHATWOOT_INBOX_NAME при запуске и повторно использует его или создает его с помощью CHATWOOT_WEBHOOK_URL в качестве веб-хука.
Один входящий на устройство
Переменные окружения настраивают одно направление общего доступа для всех устройств. Для маршрутизации каждого устройства на свой почтовый ящик, аккаунт или сервер Chatwoot, храните настройки для каждого устройства (применяется основная аутентификация):webhook_url (<base>/chatwoot/webhook/<device_id>); установите его как webhook inbox. Другие маршруты: GET /chatwoot/configs, GET и DELETE /devices/{device_id}/chatwoot/config.
api_tokenхранится в базе данных GOWA и замаскирован в чтениях;webhook_secretникогда не возвращается.chatwoot_urlдолжен быть HTTP или HTTPS без учётных данных. БезCHATWOOT_ALLOWED_HOSTS, приватного, loopback, ссылки локальных и метаданных не учитываются. Откровенно подходящий хост вCHATWOOT_ALLOWED_HOSTSявляется доверенным и может быть использован в чатwoot приватной сети. Установите этот список только для хостов, которым вы управляете.- Изменение
chatwoot_url,account_idилиinbox_idпосле того, как разговоры связаны, возвращает409; удалите и пересоздайте конфигурацию. - Перед синхронизацией устройства можно создать конфигурацию.
- Прямой импорт баз данных работает только в режиме одинарной конфигурации (окружения).
Ответы и форматирование
Когда агент использует Ответь в Чатвуде, GOWA цитирует исходное сообщение WhatsApp, когда оно может разрешать его в локальном магазине и в том же чате. Это применимо к тексту и каждому вложению, включая аудио- и файловый резерв. Заголовок остается только на первом вложении. Для входящего сообщения WhatsApp GOWA разрешаетin_reply_to_external_id с префиксом WAID:<id>. Для более раннего ответа агента числовое значение in_reply_to разрешает через прочную ссылку сообщения в том же устройстве, разговоре, аккаунте, папке “Входящие” и настройке. Сообщение с несколькими вложениями цитирует первый файл. Если цель не может быть решена, ответ доставлен без цитаты.
Входящие ответы WhatsApp и темы реакций на указанное сообщение в Chatwoot. Agent reply Markdown ссылки и акцент преобразуются в читаемый текст WhatsApp. Списки, разрывы строк и код сохраняются. Пустые разделители подписи удаляются. CHATWOOT_SIGN_MSG префиксы имени агента после этой конвертации.
Отправляются только сообщения публичных исходящих агентов. Приватные заметки и исключенные чаты не пересылаются. GOWA использует настроенную идентификацию устройства и учетной записи/папки “входящие” для маршрута общих обратных вызовов. Обратный вызов каждого устройства обеспечивает однозначный маршрут.
Опросы и Агенты удаляют
На GOWAmain после v9.9.0 зеркала Chatwoot создают, редактируют и добавляют опции. Чтобы обработать голосование, подпишитесь на message в WhatsApp webhooks и прочитайте структурированные данные опроса.
Для этих сборок установите CHATWOOT_REVOKE_ON_DELETE=true для синхронизации удалений из Chatwoot только в WhatsApp. Удаление должно совпадать с прочными ссылками на исходящие сообщения в конфигурации активного чата. GOWA аннулирует каждое связанное сообщение WhatsApp, включая вложения, отправленные отдельно. С помощью CHATWOOT_FORWARD_DELETES=true, удаляет из WhatsApp все еще как личные заметки. Используйте CHATWOOT_MESSAGE_DELETE=true для удаления связанных сообщений в обоих направлениях.
История импорта
days_limit=3, include_media=true и include_groups=true. Синхронизация считывает локальное хранилище чатов GOWA и работает в фоновом режиме. Каждое устройство может запустить одну синхронизацию одновременно.
На GOWA main после v9.9.0, история может попросить телефон повторно загрузить просроченный носитель. Телефон должен быть онлайн и все еще иметь файл. Если телефон не ответил в течение 30 секунд, синхронизация пропускает дальнейшие повторные запросы на загрузку и продолжает импортировать сообщения. Сообщение, файл которого не доступен, импортирован без вложения.
Путь REST не может установить оригинальные временные метки; импортированные сообщения получают время импорта. Для самостоятельной работы Chatwoot, CHATWOOT_IMPORT_DB_URI записывается в PostgreSQL и сохраняет их.
С помощью CHATWOOT_REOPEN_CONVERSATION=true в main GOWA после v9.9.0, синхронизация истории только вновь открывает разрешенный разговор, когда у него есть новое сообщение для импорта. Повторная синхронизация вновь открывает разговор перед отправкой сообщения и повторяет чат в следующей синхронизации, если возобновление завершилось неудачей. Прямой импорт PostgreSQL открывает его в той же транзакции, что и запись сообщения. Если настройка выключена, REST синхронизация создает свежую беседу для новых сообщений, в то время как прямой импорт продолжит использовать разрешенную беседу.
Поставки и повторы
Живые сообщения, которые столкнулись с временной ошибкой Chatwoot (ошибка сети, HTTP 429 или 5xx) поставлен в очередь на локальное хранилище и повторен в фоновом режиме с ограниченным экспоненциальным backoff. Другие 4xx ошибки регистрируются и удаляются.Устранение проблем
Запустите
APP_DEBUG=true и найдите строки журнала, начиная с Chatwoot: и Chatwoot Webhook:. Вверх Руководство по Chatwoot описывает непосредственный импорт баз данных и правила форматирования в более глубокой степени.