Начало работы с Charon

Пошаговое руководство: от регистрации до интеграции с CRM. Два пути — начать с облачного демо или установить Charon на свой сервер. Если ещё выбираете, сравните облако и свой сервер.

Автор: Команда документации Charon Время чтения: 15 мин

01

Быстрый старт — облачное демо

Быстрый способ попробовать Charon — зарегистрироваться в облаке. Бесплатно, без привязки карты, 2 подключения в подарок.

Шаг 1

Регистрация

  1. Откройте demo.charon24.ru
  2. На странице входа нажмите «Регистрация»
  3. Заполните форму:
    • Имя — ваше имя и фамилия
    • Email — рабочий email (на него придёт письмо)
    • Компания — название компании
    • Поддомен — заполнится автоматически из названия компании
    • Логин — придумайте логин для входа
    • Пароль — минимум 8 символов
  4. Поставьте галочку согласия и нажмите «Зарегистрироваться»
Подсказка: Если название компании на русском — система автоматически транслитерирует его. Например, «Моя компания» станет moya-kompaniya.charon24.ru.
Шаг 2

Подтверждение email

  1. Откройте свою почту
  2. Найдите письмо от Charon (проверьте папку «Спам»)
  3. Нажмите на ссылку подтверждения
  4. Через 5 секунд вас перенаправит на страницу входа
Важно: Без подтверждения email войти не получится. Если письмо не приходит — на странице входа есть кнопка «Отправить повторно».
Шаг 3

Вход в панель управления

  1. Откройте ваш-поддомен.charon24.ru
  2. Введите логин и пароль
  3. Нажмите «Войти»

После входа вы попадёте на Дашборд — главную страницу панели с информацией о подключениях.

Забыли пароль? Нажмите «Забыли пароль?» на странице входа — на почту придёт ссылка для сброса.
Шаг 4

Знакомство с панелью

Слева — боковое меню с разделами:

РазделНазначение
ДашбордОбщая статистика по подключениям
ПодключенияСписок всех подключений к мессенджерам
Создать подключениеДобавить новый мессенджер
КомандаУправление пользователями
АналитикаСтатистика сообщений
Настройки Bitrix24Интеграция с Bitrix24
02

Подключение мессенджеров

Нажмите «Создать подключение» в панели, выберите мессенджер и следуйте инструкции ниже.

WhatsApp

Подключение WhatsApp

  1. Создайте подключение типа «WhatsApp Beta» в панели — это единственный тип WhatsApp, который заводится сейчас
  2. Дождитесь запуска (обычно до минуты) — появится QR-код
  3. На телефоне откройте WhatsApp → НастройкиСвязанные устройстваПривязка устройства
  4. Наведите камеру на QR-код в панели
  5. Дождитесь статуса «Подключено» (зелёная галочка)
Что нужно знать
  • WhatsApp должен быть установлен и активирован на телефоне
  • Телефон должен быть подключён к интернету
  • QR-код обновляется автоматически — если не успели, подождите новый
  • После подключения телефон можно убрать — связь сохранится
  • Каналы, заведённые раньше на прежнем типе «WhatsApp», панель предлагает перевести на WhatsApp Beta. Перевод односторонний, и после него владелец номера сканирует QR-код заново — переписка, настройки и привязка к CRM сохраняются
Telegram

Подключение Telegram

  1. Создайте подключение типа «Telegram»
  2. Дождитесь инициализации (5–15 секунд) — появится QR-код
  3. На телефоне откройте Telegram → НастройкиУстройстваПодключить устройство
  4. Отсканируйте QR-код
  5. Если включена двухфакторная аутентификация — введите облачный пароль
  6. Дождитесь статуса «Подключено»
Что нужно знать
  • Подключение к Charon = одна дополнительная сессия
  • Если завершите все сессии в Telegram — подключение к Charon отключится
  • Соединение восстанавливается автоматически после обрыва
  • Что попадает в Битрикс24, какие группы передаются и что делать, если сеанс завершили, — на странице Telegram
Matrix

Подключение Matrix

  1. Создайте подключение типа «Matrix»
  2. Заполните форму: Адрес сервера Matrix (Homeserver URL), Имя пользователя, Пароль
  3. Нажмите «Войти»
  4. Может потребоваться верификация — сравните эмодзи на экране и на другом устройстве
  5. После верификации статус изменится на «Подключено»
Важно: Для работы шифрования (E2EE) обязательна верификация сессии. Без неё зашифрованные сообщения не будут расшифровываться.
03

Интеграция с Битрикс24

Свяжите мессенджеры с CRM, чтобы сообщения клиентов автоматически попадали в Открытые линии и создавали лиды.

Настройка за 5 шагов

  1. Установите приложение Charon из Маркетплейса Битрикс24 под учётной записью администратора портала
  2. Введите код сопряжения — портал показывает его после установки; в панели Charon откройте раздел «Битрикс24», блок «Через Маркетплейс», и нажмите «Подключить». Код действует 24 часа
  3. Проверьте канал в Битрикс24 — откройте CRM → Контакт-центр: канал Charon появляется в списке каналов Открытых линий. Регистрировать канал Charon (коннектор) вручную не нужно, при установке приложения это делается само
  4. Создайте или выберите Открытую линию и подключите к ней канал Charon
  5. В панели Charon выберите подключение мессенджера и привяжите к нему ту же Открытую линию

После этого входящие сообщения открывают диалог в Открытой линии, а карточку в CRM заводит Битрикс24 по правилам портала. Менеджеры отвечают прямо из CRM.

Функция «Написать первым»: приложение Маркетплейса добавляет её в карточки лида, сделки, контакта и компании — менеджер начинает переписку по телефону, имени в Telegram или MAX ID из карточки, не дожидаясь сообщения клиента (как работает кнопка). При ручной настройке через локальное приложение с собственными ключами авторизации (OAuth) этой кнопки и пункта «Charon Messenger» в левом меню портала не будет.

Подробнее — что проверять на каждом шаге, чем прямое подключение (Direct) отличается от подключения через шлюз Charon (Relay) и что делать, если канала нет в Контакт-центре: пошаговое подключение Битрикс24.

04

Установка на свой сервер

Данные у вас: Charon разворачивается на вашем сервере через Docker, переписка и данные хранятся на нём. Чем этот путь отличается от облака — на странице «Облако или свой сервер».

Ориентировочные требования к серверу

Сервер выбирают по числу активных подключений — оно определяет нагрузку сильнее, чем количество сотрудников.

СценарийПроцессорОперативная памятьДиск
Проверка или демо
1–5 подключений
2 ядра8 ГБ40 ГБ SSD
Небольшая рабочая установка
до 10 подключений
4 ядра16 ГБ80–100 ГБ SSD
Средняя установка
10–50 подключений
8 ядер32 ГБ200 ГБ SSD/NVMe
Большая установка
от 50 подключений
12–16 ядерот 64 ГБот 500 ГБ NVMe

Нужен домен с SSL-сертификатом и доступ сервера к реестру образов charon24.ru. Выделенный IP не обязателен, но упрощает выпуск сертификата.

Как считать память: 6–8 ГБ занимают базовые службы, плюс 0,5–1 ГБ на каждое активное подключение WhatsApp или WeChat Agent — они поднимают браузерный или агентский процесс. Сверху заложите 20–30% запаса. Если включаете AI-ассистент на своём сервере, добавьте к выбранному профилю ещё 12–16 ГБ: модели встраивания и переранжирования держат память постоянно.
Linux

Установка на Linux

Поддерживаемые ОС: Ubuntu 22.04 LTS и 24.04 LTS, Debian 12+, AlmaLinux, Rocky Linux и RHEL 9+ (x64), а также российские дистрибутивы с Docker Engine. Нужен systemd.

Выполните одну команду от имени root:

curl -fsSL https://lemnos.ru/cases/charon/installer-assets/installer/install.sh | bash

Установщик автоматически:

  • Установит Docker, если его нет
  • Создаст директорию /opt/charon/
  • Спросит параметры: домен, лицензионный ключ, логин/пароль администратора
  • Сгенерирует криптографические секреты
  • Поставит агент кластера Nomad как системную службу charon-nomad — версия закреплена, контрольная сумма проверяется до распаковки
  • Загрузит образы и поднимет службы Charon заданиями Nomad в порядке зависимостей
  • Установит агент обновлений charon-update-agent для обновления в один клик
Один узел, не кластер. Nomad здесь запускает и перезапускает службы Charon на том же сервере — отдельные машины и ручная настройка кластера не нужны. Готовить конфигурацию вручную тоже не требуется: установщик сам выдаёт токены доступа и генерирует файлы переменных.
Уже установили Charon раньше?

Установки, сделанные до перехода на Nomad, работают на Docker Compose и остаются на нём: повторный запуск установщика этого не меняет — он смотрит на файл .charon-runtime рядом с установкой. Перевод работающей коробки на Nomad — отдельная односторонняя процедура, обратного пути у неё нет; напишите нам, и мы проведём её вместе.

Параметры установки
ПараметрОписаниеПример
DOMAINДомен сервераcharon.example.com
BASE_URLПолный URLhttps://charon.example.com
LICENSE_KEYЛицензионный ключXXXX-XXXX-XXXX-XXXX
BITRIX24_DOMAINДомен Битрикс24 (опц.)company.bitrix24.ru
ADMIN_USERNAMEЛогин администратораadmin
ADMIN_PASSWORDПароль (или автогенерация)
Windows

Установка на Windows

Требования: Windows 10/11 или Server 2016+, Docker Desktop с Compose v2, PowerShell 5.1+

Выполните в PowerShell от имени администратора:

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-WebRequest -UseBasicParsing "https://lemnos.ru/cases/charon/installer-assets/installer/install.ps1" | Invoke-Expression

Установщик задаёт те же параметры, что и на Linux, но поднимает службы через Docker Compose. Директория установки: C:\ProgramData\Charon\. Агент обновлений запускается локально на порту 18881 — права администратора нужны для привязки адреса и правила брандмауэра.

Проверка работоспособности

Установщик кладёт рядом с установкой скрипт проверки, который сам определяет, на чём она запущена. Запустите его из директории установки:

bash scripts/ops/charon-enterprise-healthcheck.sh --mode auto

Он проверяет службы, базу, доступность API и ошибки в логах за последние 15 минут. На Windows скрипт запускается из Git Bash или WSL.

curl http://localhost/api/health

Ожидаемый ответ: {"status":"ok"}

Откройте в браузере адрес, указанный при установке — должна появиться страница входа в панель управления.

Полезные команды

Скрипты из директории установки работают и на Nomad, и на Docker Compose — на Windows запускайте их из Git Bash или WSL:

ДействиеКоманда
Проверка состоянияbash scripts/ops/charon-enterprise-healthcheck.sh --mode auto
План резервной копииbash scripts/ops/charon-enterprise-backup.sh --mode auto
Создать резервную копиюbash scripts/ops/charon-enterprise-backup.sh --mode auto --execute

Linux — установка на Nomad. Адрес и токен агента задаются один раз за сессию; тот же адрес установщик печатает в конце установки:

export NOMAD_ADDR=http://$(docker network inspect bridge -f '{{range .IPAM.Config}}{{.Gateway}}{{end}}'):4646
export NOMAD_TOKEN=$(sudo cat /etc/charon/nomad.token)
ДействиеКоманда
Статус службnomad job status charon-control
Логи серверной части (backend)nomad alloc logs -f -job charon-control charon-api
Перезапуск backendnomad job restart charon-control
Состояние агентаsystemctl status charon-nomad

Установки на Docker Compose — Windows и коробки, поставленные раньше:

ДействиеКоманда
Статус контейнеровdocker compose -f docker-compose.release.yml ps
Логи backenddocker compose -f docker-compose.release.yml logs -f backend
Перезапуск backenddocker compose -f docker-compose.release.yml restart backend
Критически важно: входы в мессенджеры невосстановимы — при потере аккаунты придётся подключать заново, сканируя QR-код с телефона. Часть входов лежит в базе, часть — файлами в каталогах data/baileys_auth/ и data/wwebjs_auth/ (WhatsApp), data/telegram_sessions/ (Telegram) и data/matrix_crypto/ (ключи Matrix), и что где — зависит от канала и установки. Поэтому в резервную копию всегда входит и база, и все четыре каталога. Разбираться, что именно у вас, не нужно, если снимать копию скриптом charon-enterprise-backup.sh выше: он забирает и то, и другое. Никогда не запускайте docker compose down -v на рабочей установке: эта команда удаляет базу, медиа и сессии.
05

Мобильное приложение

Charon Messenger для Android и iOS — чаты и push-уведомления на телефоне.

Шаг 1

Установка и вход

  1. Установите приложение Charon Messenger (установочный файл APK или магазин приложений — уточните у администратора)
  2. Откройте приложение и заполните три поля:
    • Адрес сервера — URL вашего Charon (например, https://ваш-поддомен.charon24.ru)
    • Логин — ваш логин в системе
    • Пароль — ваш пароль
  3. Нажмите «Войти»
  4. Разрешите push-уведомления, когда приложение попросит
Откуда логин и пароль? Если регистрировались сами — используйте свои данные. Если подключение создавал администратор — он передал вам учётные данные.
Шаг 2

Работа с чатами

  • Выбор подключения: нажмите на заголовок вверху экрана — откроется список подключений. Зелёная точка = подключено, красная = отключено
  • Единый вид: включите переключатель «Единый вид» чтобы видеть чаты из всех подключений одновременно
  • Поиск: иконка поиска вверху — поиск по имени или сообщениям
  • Отправка сообщений: нажмите на чат, введите текст и отправьте
  • Прикрепить файл: иконка скрепки — фото, видео, документ
  • Ответить: долгое нажатие или свайп → «Ответить»
Статусы сообщений
  • Одна серая галочка — отправлено
  • Две серых галочки — доставлено
  • Две синих галочки — прочитано
06

Решение проблем

QR-код WhatsApp не появляется

  • Подождите 30–60 секунд — инициализация может занять время
  • Обновите страницу в браузере
  • Если не помогает — удалите подключение и создайте заново

WhatsApp отключился

  • Проверьте, что WhatsApp на телефоне подключён к интернету
  • В панели нажмите «Переподключить»
  • Если не помогает — повторное сканирование QR-кода

Telegram просит пароль

  • Это облачный пароль двухфакторной аутентификации
  • Если не задавали — этот шаг не появится
  • Забыли — восстановите в Telegram: Настройки → Конфиденциальность → Двухэтапная аутентификация

Не приходят push-уведомления

  • Разрешите уведомления в настройках телефона для приложения Charon
  • Убедитесь, что подключение активно
  • Проверьте, не заглушены ли уведомления в приложении

Не могу войти в мобильное приложение

  • Адрес сервера должен начинаться с https://
  • Проверьте логин и пароль (попробуйте войти через браузер)
  • Убедитесь, что телефон подключён к интернету

Ошибка 502 Bad Gateway

  • Серверная часть (backend) ещё не запустилась — подождите 30–60 секунд
  • Запустите проверку из директории установки: bash scripts/ops/charon-enterprise-healthcheck.sh --mode auto
  • Убедитесь, что достаточно оперативной памяти — при нехватке backend уходит в цикл перезапуска

Готовы начать?

Регистрация без банковской карты. На бесплатном тарифе — 2 подключения.

Создать аккаунт Оставить заявку