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

Пошаговое руководство: от регистрации до интеграции с CRM. Два пути — попробовать в облаке за 5 минут или установить на свой сервер.

01

Быстрый старт — демо за 5 минут

Самый быстрый способ попробовать 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» в панели
  2. Дождитесь инициализации (10–30 секунд) — появится QR-код
  3. На телефоне откройте WhatsApp → НастройкиСвязанные устройстваПривязка устройства
  4. Наведите камеру на QR-код в панели
  5. Дождитесь статуса «Подключено» (зелёная галочка)
Что нужно знать
  • WhatsApp должен быть установлен и активирован на телефоне
  • Телефон должен быть подключён к интернету
  • QR-код обновляется автоматически — если не успели, подождите новый
  • После подключения телефон можно убрать — связь сохранится
  • WhatsApp Beta — альтернативная технология (Baileys). Если обычный WhatsApp нестабилен — попробуйте Beta. Процесс тот же
Telegram

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

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

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

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

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

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

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

  1. Откройте раздел «Битрикс24» в панели управления Charon
  2. Укажите домен портала Битрикс24 (например, company.bitrix24.ru) и URL входящего вебхука — или авторизуйтесь через OAuth
  3. Нажмите «Зарегистрировать коннектор» — система автоматически зарегистрирует канал связи в Битрикс24
  4. В Битрикс24 перейдите в CRM → Контакт-центр → выберите канал «Charon WhatsApp» или «Charon Telegram»
  5. Создайте или выберите Открытую линию и подключите к ней канал Charon
  6. В панели Charon выберите подключение и привяжите к нему соответствующую Открытую линию

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

Функция «Написать первым»: После настройки менеджеры смогут инициировать переписку с клиентом прямо из карточки лида, сделки или контакта в Битрикс24 — по номеру телефона через WhatsApp.
04

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

Полный контроль данных: Charon разворачивается на вашем сервере через Docker. Все данные и переписка остаются у вас.

Требования к серверу

ПараметрМинимумРекомендуется
Процессор2 ядра, 2 ГГц4 ядра, 2.5 ГГц
Оперативная память4 ГБ8 ГБ
Диск20 ГБ SSD50 ГБ SSD
СетьСтабильный интернетВыделенный IP
Учтите: каждое активное подключение к мессенджеру потребляет ~200–400 МБ ОЗУ (WhatsApp использует встроенный Chromium). При 10+ подключениях рекомендуется 16 ГБ ОЗУ.
Linux

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

Поддерживаемые ОС: Ubuntu 20.04+, Debian 11+, CentOS 8+, RHEL 8+, Fedora 36+ (x64)

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

curl -fsSL https://charon24.ru/installer-assets/installer/install.sh | bash

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

  • Установит Docker и Docker Compose (если нет)
  • Создаст директорию /opt/charon/
  • Спросит параметры: домен, лицензионный ключ, логин/пароль администратора
  • Сгенерирует криптографические секреты
  • Загрузит Docker-образы и запустит все сервисы
  • Установит агент обновлений
Параметры установки
ПараметрОписаниеПример
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://charon24.ru/installer-assets/installer/install.ps1" | Invoke-Expression

Процесс аналогичен Linux-версии. Директория установки: C:\ProgramData\Charon\

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

После установки выполните проверки:

docker compose -f docker-compose.release.yml ps

Все контейнеры должны иметь статус Up или healthy.

curl http://localhost/api/health

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

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

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

ДействиеКоманда
Статус контейнеровdocker compose -f docker-compose.release.yml ps
Логи backenddocker compose -f docker-compose.release.yml logs -f backend
Перезапускdocker compose -f docker-compose.release.yml restart backend
Резервная копия БДdocker exec charon-postgres pg_dump -U charon charon > backup.sql
Критически важно: Директории data/wwebjs_auth/ (сессии WhatsApp) и data/telegram_sessions/ (сессии Telegram) содержат невосстановимые данные. Включите их в резервное копирование.
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 секунд
  • Проверьте логи: docker compose logs -f backend
  • Убедитесь, что достаточно оперативной памяти

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

Регистрация за 1 минуту. 2 подключения бесплатно, без привязки карты.

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