Chatwootv4.19.1

Поддержка клиентов для команды: чат сайта, почта и Telegram, история обращений и ответственные - замена чат-части Intercom.

Операторы отвечают клиентам из общей очереди, передают диалоги коллегам и видят предыдущую переписку. Макрос отправляет готовый ответ и закрывает решенный вопрос, а база знаний помогает отправить клиенту инструкцию. В бесплатной Community Edition нет лицензионной платы за каждого оператора; сервер и обслуживание вы оплачиваете сами.

После создания сервера рецепт устанавливает Chatwoot CE 4.19.1, создает администратора и открывает приложение по HTTPS с сертификатом Let's Encrypt. На чистых стендах страница входа открывалась примерно за 5-13 минут; основное время уходило на пакеты, образы и миграции. О ходе установки приходят уведомления. Собственный домен для первого входа не нужен.

Что внутри

Chatwoot CE 4.19.1 на Ruby 3.4.4 и Rails 7.2.3.1
кабинет оператора, виджет сайта, макросы, поиск, отчеты и база знаний для клиентов; интерфейс частично переведен на русский.
Sidekiq 7.3.10
обработка фоновых задач и писем, чтобы они не задерживали работу в очереди.
PostgreSQL 16.15 с pgvector 0.8.7
пользователи, обращения и история сообщений.
Redis 7.4.12
очередь фоновых задач и кеш приложения.
Caddy 2.11.7
вход по HTTPS, выпуск и автоматическое продление сертификата.

Всего пять контейнеров: веб-приложение и отдельный обработчик задач используют один образ Chatwoot.

Безопасность

  • Администратор создан до открытия сайтапосторонний не сможет занять первый аккаунт; свободная регистрация закрыта, операторов приглашает администратор.
  • Приложение и базы изолированыRails опубликован только на 127.0.0.1:3000, PostgreSQL и Redis не открыты в интернет; веб-доступ идет через Caddy по HTTPS.
  • Свои секреты и ключи шифрованияустановка генерирует их один раз, сохраняет при повторном запуске и ограничивает чтение конфигурации владельцем сервера.
  • fail2ban для SSHпосле пяти неудачных попыток входа блокирует адрес на час.
  • Телеметрия и push relay выключеныстатистика установки не отправляется вендору, внешний ретранслятор push-уведомлений не используется.
  • Закрепленные образырецепт использует проверенные теги и digest, чтобы следующий заказ получил ту же сборку.
  • Исправления уязвимостей прежних версийCE 4.19.1 содержит исправление CVE-2025-21628: в старых выпусках пользователь мог через фильтры обращений и контактов внедрить SQL-команду. Эта критическая ошибка закрыта еще в 3.16.0.

Как войти

  1. Дождитесь уведомления о готовности. Адрес формируется из IP сервера: замените точки на дефисы, добавьте .fatmetal.net и откройте /app/login. Например, для IP 45.15.159.10 вход находится по адресу https://45-15-159-10.fatmetal.net/app/login.

  2. Администратор уже создан. Логин - admin@<исходное имя сервера> без https:// и пути: например, admin@45-15-159-10.fatmetal.net. Если при установке задавали ADMIN_EMAIL, используйте его. Первый пароль - пароль сервера из личного кабинета Fatmetal с префиксом Cw1! без пробела: сначала Cw1!, сразу за ним весь пароль сервера. Публичная регистрация закрыта.

  3. После входа смените пароль и укажите настоящий email в настройках профиля. Заполните предложенную форму компании, включая роль, сайт и часовой пояс. Чтобы изменить сайт, нажмите кнопку с карандашом рядом с полем.

  4. Откройте Настройки -> Источники -> Добавить источник -> Сайт. Задайте название и адрес сайта, добавьте операторов, включая себя, и завершите создание. Скопируйте показанный JavaScript-код на страницы сайта перед закрывающим тегом body.

  5. Откройте сайт как посетитель и отправьте сообщение. В Chatwoot выберите Диалоги -> Все или Неназначен, откройте обращение, назначьте ответственного и ответьте. Убедитесь, что ответ появился у посетителя в виджете.

Важно

Каналы вы подключаете на своих реквизитах. Для писем откройте Настройки -> Источники -> Добавить источник -> Email: укажите свой ящик, IMAP для приема и SMTP для ответов. Для Telegram выберите источник Telegram и укажите токен своего бота. Установка не создает почтовый ящик или бота; на стенде проверены сайт и почта.

Для приглашений операторов и восстановления пароля настройте системный SMTP отдельно от почтового источника. В /opt/chatwoot/.env заполните значения своего провайдера; ниже пример для порта 587 с STARTTLS:

SMTP_ADDRESS=smtp.example.org
SMTP_PORT=587
SMTP_USERNAME=support@example.org
SMTP_PASSWORD=пароль_вашего_SMTP
SMTP_AUTHENTICATION=login
SMTP_ENABLE_STARTTLS_AUTO=true
SMTP_OPENSSL_VERIFY_MODE=peer
SMTP_DOMAIN=example.org
MAILER_SENDER_EMAIL="Поддержка <support@example.org>"

Замените пример своими реквизитами и примените настройки:

cd /opt/chatwoot
sudo docker compose up -d --force-recreate rails sidekiq

Перед обновлением сохраните резервную копию PostgreSQL, вложения из тома chatwoot_storage_data и файл /opt/chatwoot/.env, включая ключи ACTIVE_RECORD_ENCRYPTION_*. Копирования только базы недостаточно, чтобы восстановить вложения. Проверенные команды копирования и восстановления приведены в разборе.

Платные Captain, SLA и SSO в эту установку CE не входят. Для этих возможностей выбирайте соответствующую редакцию вендора.

Лицензия

Community Edition распространяется по лицензии MIT.

Свой домен

  1. Направьте A-запись своего домена на публичный IPv4 сервера.
  2. Проверьте DNS: ping ваш-домен должен показывать этот IP. Если показывает прежний адрес, дождитесь обновления записей.
  3. По SSH в файле /etc/chatwoot-mp/params.env задайте свой домен без протокола и пути, например DOMAIN=help.example.org.
  4. Выполните sudo bash /opt/chatwoot-mp/install.sh и дождитесь завершения. Рецепт обновит адрес приложения и настройки Caddy; HTTPS проверяется до пяти минут с интервалом около десяти секунд.
  5. Если свой домен еще не указывает на сервер, исправное приложение завершит установку успешно. Направьте A-запись на IP этого сервера из личного кабинета Fatmetal: Caddy получит сертификат после обновления DNS. Если письмо о готовности уже приходило, повторно оно не отправляется. Когда DNS обновится, откройте https://ваш-домен/app/login.
  6. Логин администратора не меняется. Если первая установка была на автоматическом адресе, замените точки в IP сервера на дефисы и используйте admin@<IP-с-дефисами>.fatmetal.net: например, для 45.15.159.10 логин - admin@45-15-159-10.fatmetal.net. Если задавали ADMIN_EMAIL, используйте этот адрес. Первый пароль - пароль этого сервера из личного кабинета Fatmetal с префиксом Cw1! без пробела: сначала Cw1!, сразу за ним весь пароль сервера. Если меняли пароль в профиле, используйте свой новый пароль.
  7. Для ранее установленного виджета скопируйте код с новым адресом из настроек источника сайта и замените старый код на страницах сайта.

При повторном запуске текущий DNS, нужный IP и пояснение об ожидании сертификата также доступны в приветствии при входе по SSH и в файле реквизитов: sudo cat /root/chatwoot-credentials.txt.

Требования

Для пилота с чатом сайта и почтой берите тариф CPU4-RAM8-DISK100: 4 ядра и 8 ГБ памяти. На CE 4.19.1 процессы пяти контейнеров занимали около 989 МиБ в простое; при передаче одного файла 8 МиБ наблюдали до 1058 МиБ. Это проверка сценария, а не лимит числа операторов. Для растущей команды, когда в часы нагрузки заканчивается свободная память или накапливаются фоновые задачи, рассмотрите CPU6-RAM16-DISK100; количество одновременно работающих операторов оценивайте по своей нагрузке.

Подробный разбор с замерами, скриншотами и резервным копированием в Базе знаний →
Chatwoot990 ₽/месЗапустить →