Chatwoot

Посетитель пишет через виджет, оператор отвечает из общей очереди. Диалог можно назначить коллеге, снабдить внутренней заметкой и закрыть после решения вопроса. Следующий оператор видит историю.

Почтовый канал помещает письма туда же. На стенде письмо с вложением появилось через 33 секунды, ответ оператора дошел до отправителя. Для клиента это остается обычной перепиской.

Если нужен Telegram, учтите границу проверки этого канала.

Chatwoot заменяет чат и командную обработку обращений в Intercom. Help Center хранит опубликованные инструкции отдельно от личных сообщений: посетитель читает статью, а поддержка отправляет ссылку.

Русский язык выбирается в настройках профиля и пространства. Перевод частичный: в редакторе базы знаний и отдельных настройках остаются английские подписи. Лицензия бесплатной CE - MIT.

У CE нет платы за место оператора. Экономия появляется, когда команда использует общую очередь, но не нуждается в оплачиваемых возможностях конкретного облачного сервиса.

Для пяти операторов Intercom Essential стоит $145 в месяц до дополнительных услуг. Сервер Chatwoot стоит фиксированно, но его обслуживание остается на вашей стороне: это разные статьи расходов.

Zendesk объявлял о приостановке продаж в России и Беларуси. У Intercom перечислены зарубежные способы оплаты; МИР и СБП в документации не перечислены. Прямую оплату из России заранее уточняйте.

Источники цен: Chatwoot, Intercom, Zendesk. Собственный сервер позволяет выбрать место хранения обращений, но сам по себе не делает службу поддержки соответствующей требованиям законодательства.

Rails обслуживает интерфейс и API, Sidekiq выполняет фоновые задачи: получение почты и отправку уведомлений. Оба используют один образ приложения и общий том с вложениями.

PostgreSQL 16 хранит пользователей, обращения и сообщения. Официальный Compose использует образ с расширением pgvector. Redis обслуживает очереди задач. Потеря базы или файлового тома означает потерю части переписки.

Caddy принимает HTTPS на портах 80 и 443 и передает запросы Rails. Порт 3000 доступен только с самого сервера; порты базы и Redis тоже привязаны к localhost.

Файл .env содержит пароли и три ключа шифрования Active Record. Сохраняйте его вместе с базой: новый набор ключей при восстановлении не заменит прежний.

Для этой инструкции берем Ubuntu 24.04 и CPU4-RAM8-DISK100: четыре процессорных ядра, 8 ГБ памяти и диск 100 ГБ. Подробные требования вендора рекомендуют четыре CPU и 4 ГБ RAM.

Один диагностический файл размером 8 МиБ увеличил том вложений на 8 МиБ. Поэтому резервируйте место под присланные документы, а не только под сообщения в PostgreSQL.

От подготовки сервера до ответа посетителю прошло 18 минут, включая настройку и разбор ошибки сертификата. Отведите отдельное время на почтовый канал: его реквизиты не появляются вместе с Chatwoot.

Проверено на версии v4.19.1, 28 октября 2026. На новых версиях результаты могут отличаться.

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

1. Установите Docker

   Подключитесь к чистой Ubuntu 24.04 по SSH и выполните sudo -i. Все команды дальше запускаются от root; установим пакеты из репозитория Docker.

   apt-get update && apt-get install -y ca-certificates curl
   install -m 0755 -d /etc/apt/keyrings
   curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
   echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable" > /etc/apt/sources.list.d/docker.list
   apt-get update && apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
   fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
   echo '/swapfile none swap sw 0 0' >> /etc/fstab

2. Закрепите CE v4.19.1

   Берем официальный Compose из тега релиза. Замена latest обязательна: иначе при следующем скачивании установится другая версия.

   mkdir -p /opt/chatwoot && cd /opt/chatwoot
   curl -fsSL https://raw.githubusercontent.com/chatwoot/chatwoot/v4.19.1/docker-compose.production.yaml -o docker-compose.yaml
   sed -i 's|chatwoot/chatwoot:latest|chatwoot/chatwoot:v4.19.1-ce|; s|redis:alpine|redis:7-alpine|' docker-compose.yaml

3. Задайте домен и секреты

   Замените ваш-домен на адрес, чья A-запись указывает на сервер. Откройте входящие 80/443; сохраните все ключи. Саморегистрация отключена, первое создание администратора остается доступным.

   DOMAIN=ваш-домен
   REDIS_PASSWORD=$(openssl rand -hex 24)
   umask 077
   cat > .env <<EOF
   FRONTEND_URL=https://$DOMAIN
   SECRET_KEY_BASE=$(openssl rand -hex 64)
   POSTGRES_HOST=postgres
   POSTGRES_DATABASE=chatwoot_production
   POSTGRES_USERNAME=postgres
   POSTGRES_PASSWORD=$(openssl rand -hex 24)
   REDIS_PASSWORD=$REDIS_PASSWORD
   REDIS_URL=redis://:$REDIS_PASSWORD@redis:6379
   FORCE_SSL=false
   DEFAULT_LOCALE=ru
   ENABLE_ACCOUNT_SIGNUP=false
   ENABLE_PUSH_RELAY_SERVER=false
   ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY=$(openssl rand -hex 16)
   ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY=$(openssl rand -hex 16)
   ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT=$(openssl rand -hex 16)
   EOF
   umask 022

4. Добавьте HTTPS и пароль PostgreSQL

   Пустой пароль в upstream Compose перекрывает значение из .env. Исправим его отдельным файлом; проверка готовности базы нужна перед созданием таблиц.

   cat > docker-compose.override.yaml <<'EOF'
   services:
     postgres:
       environment:
         POSTGRES_DB: chatwoot_production
         POSTGRES_PASSWORD: "${POSTGRES_PASSWORD}"
       healthcheck:
         test: ["CMD-SHELL", "pg_isready -U postgres -d chatwoot_production"]
         interval: 5s
         retries: 30
     caddy:
       image: caddy:2-alpine
       restart: unless-stopped
       ports: ["80:80", "443:443"]
       volumes: ["./Caddyfile:/etc/caddy/Caddyfile:ro", "caddy_data:/data"]
   volumes:
     caddy_data:
   EOF
   printf '%s {
     reverse_proxy rails:3000
   }
   ' "$DOMAIN" > Caddyfile

5. Поднимите сервисы

   Сначала готовим базу штатной задачей Chatwoot, затем запускаем приложение. Сервис base служит шаблоном: отдельный контейнер из него поднимать не нужно.

   docker compose pull
   docker compose up -d --wait postgres redis
   docker compose run --rm rails bundle exec rails db:chatwoot_prepare
   docker compose up -d rails sidekiq caddy
   docker compose ps

Откройте на своем HTTPS-домене страницу /installation/onboarding, задайте имя, организацию, email и пароль администратора. Завершите этот шаг сразу: до первого администратора форма установки доступна по публичному адресу.

После входа заполните профиль пространства, язык и часовой пояс. Адрес сайта редактируется кнопкой с карандашом рядом с полем.

В настройках откройте «Источники» и добавьте виджет онлайн-чата. Укажите название сайта и его адрес, выберите оператора. Скопируйте предложенный JavaScript на страницы сайта перед закрывающим тегом body.

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

Для почты добавьте источник Email, выберите другого провайдера и откройте дополнительные параметры. В настройках канала включите IMAP: имя сервера, порт 993, SSL, полный адрес ящика и пароль.

Для отправки включите SMTP, укажите сервер, порт 587, STARTTLS и учетные данные почтового провайдера. Выберите проверку сертификата peer. Пригласительные письма самого приложения требуют отдельного системного SMTP.

Отправьте письмо с вложением с другого адреса, дождитесь его в очереди и ответьте из Chatwoot. Получение письма без успешной обратной доставки еще не означает, что канал настроен.

Создайте макрос в настройках: добавьте действие отправки сообщения с готовым ответом, затем действие закрытия диалога. Примените его из меню разговора, когда вопрос действительно решен.

Help Center создается в разделе базы знаний. Добавьте портал, категорию и статью; переведите ее в опубликованное состояние. Публичная страница открывается посетителю без учетной записи оператора.

Глобальный поиск переключается между типами результатов. После публикации статья находится по тексту; сообщение из переписки появляется в результатах диалогов. Это удобнее ручного просмотра всех обращений одного клиента.

Администратор видит сводный отчет и может перейти от показателя к обращениям, из которых он составлен. Так проще разобрать конкретный долгий ответ, а не спорить о средней цифре.

cd /opt/chatwoot
docker compose up -d --wait postgres redis
docker compose logs --tail=50 postgres

cd /opt/chatwoot
docker compose logs --since=10m sidekiq rails

docker compose logs --tail=100 caddy

После изменения Caddyfile через редактор с заменой файла пересоздайте контейнер: прежнее файловое подключение может продолжать читать старое содержимое.

docker compose up -d --force-recreate caddy

Остановите прием обращений на время копирования. Эти команды сохраняют согласованную базу, файловый том и настройки, затем возвращают приложение в работу. Каталог backup содержит секреты: храните его закрытым.

cd /opt/chatwoot
umask 077
mkdir -p backup
docker compose stop rails sidekiq
docker compose exec -T postgres pg_dump -U postgres -Fc chatwoot_production > backup/db.dump
tar czf backup/config.tgz .env docker-compose.yaml docker-compose.override.yaml Caddyfile
docker run --rm --entrypoint tar -v chatwoot_storage_data:/data:ro -v "$PWD/backup":/backup redis:7-alpine czf /backup/storage.tgz -C /data .
docker compose start rails sidekiq

Скопируйте весь каталог backup на отдельное хранилище. Копия на том же диске не переживет потерю сервера. Ниже восстановление на установленном стеке: оно заменяет текущую базу.

cd /opt/chatwoot
docker compose stop rails sidekiq
tar xzf backup/config.tgz
docker compose exec -T postgres dropdb -U postgres chatwoot_production
docker compose exec -T postgres createdb -U postgres chatwoot_production
docker compose exec -T postgres pg_restore -U postgres -d chatwoot_production --no-owner --exit-on-error < backup/db.dump
docker run --rm --entrypoint tar -v chatwoot_storage_data:/data -v "$PWD/backup":/backup redis:7-alpine xzf /backup/storage.tgz -C /data
docker compose start rails sidekiq

После восстановления войдите оператором, откройте прежний разговор и скачайте вложение. Сохранение только PostgreSQL оставляет в переписке ссылки на файлы, которых уже нет.

Сначала сделайте резервную копию предыдущими командами. В docker-compose.yaml замените тег v4.19.1-ce на выбранный выпущенный тег CE. Сохраните .env, включая старые ключи шифрования.

cd /opt/chatwoot
docker compose pull rails sidekiq
docker compose stop rails sidekiq
docker compose run --rm rails bundle exec rails db:chatwoot_prepare
docker compose up -d rails sidekiq caddy

Задача db:chatwoot_prepare выполняет миграции перед запуском новой версии. После обновления проверьте вход оператора, ответ посетителю и доставку почты. Возврат старого образа не отменяет миграцию базы.

Для отката восстановите конфигурацию, базу и вложения из одной копии. Не применяйте db:schema:load к действующей установке: эта команда не заменяет последовательное обновление схемы.

CE v4.19.1 из этой инструкции содержит исправления перечисленных ошибок. Если установлен затронутый выпуск, сделайте резервную копию и обновитесь по разделу выше. Здесь серьезность взята из бюллетеней.

В v4.19.1 усилили защиту: проверку уведомлений Twilio, очистку CSS и обработку сессионных cookies на публичных страницах. Отдельные CVE и уровни риска для этих изменений в заметках релиза не указаны.

Защита этой установки также зависит от закрытых портов базы, сохранности секретов и своевременного обновления образов.

В документации Telegram заявлен как канал общей очереди; на этом стенде подтверждены сайт и почта, подключение Telegram не проверено.