Пять шагов: приложение из Маркетплейса Битрикс24, код сопряжения, канал в Контакт-центре, Открытая линия и первый мессенджер. Программировать ничего не нужно, но нужны права администратора портала.
Три вещи. Если чего-то из них нет, настройка встанет на середине.
Портал
Приложение получает доступ к Открытым линиям и CRM, поэтому ставить его должен администратор портала. Установка под обычным пользователем прерывается: Charon не сохраняет выданные ему ключи доступа (токены), чтобы не сломать доступ к CRM.
Charon
Подойдёт и то и другое: облачный аккаунт заводится регистрацией, без установки, установка на своём сервере связывается с порталом так же.
Сравнить облако и свой сервер
Мессенджер
На последнем шаге владелец номера сканирует QR-код в панели Charon. Телефон нужен один раз — после привязки связь держится без него.
Как подключается WhatsAppПорядок именно такой: каждый следующий шаг проверяет, что предыдущий прошёл. Так поломка видна сразу, а не после первого потерянного сообщения.
Откройте Маркетплейс Битрикс24 под учётной записью администратора портала и установите приложение Charon. Приложение просит доступ к Открытым линиям и CRM — без администратора портал этот доступ не выдаст.
Проверка После установки портал открывает окно Charon с кодом сопряжения. Если вместо кода появилась просьба повторить установку под администратором — так и сделайте: токены обычного пользователя намеренно не сохраняются.
Код — три группы по четыре символа, вида
ABCD-EFGH-JKMN. Похожие символы в нём не
используются, поэтому похожих символов — например, нуля и
буквы O — в нём нет.
Код действует 24 часа. В панели Charon
откройте раздел «Битрикс24», введите код в блоке «Через
Маркетплейс» и нажмите «Подключить».
Проверка В разделе появляется строка с доменом портала и режимом связи — прямой (Direct) или через шлюз Charon (Relay). Если код не принимается, он, скорее всего, истёк: переустановите приложение, портал выдаст новый.
Регистрировать канал Charon в Контакт-центре (коннектор) вручную не нужно — при установке приложения это делается само. Достаточно убедиться, что канал Charon виден в Битрикс24: CRM → Контакт-центр, в списке каналов Открытых линий.
Проверка Канала нет — вернитесь в раздел «Битрикс24» панели Charon: там видно состояние авторизации по протоколу OAuth портала и есть кнопка регистрации коннектора. Оба действия повторяются без потерь.
В Контакт-центре откройте канал Charon и подключите его к Открытой линии — новой или уже работающей. Линия решает, кто из сотрудников отвечает и в каком порядке; очередь и правила распределения настраиваются в Битрикс24, а не в Charon.
Проверка В карточке линии канал Charon отображается среди подключённых. Одну линию можно оставить на все мессенджеры или завести отдельную под каждый — от этого зависит, кому попадут обращения.
В панели Charon нажмите «Создать подключение», выберите мессенджер и авторизуйте аккаунт: WhatsApp и Telegram привязываются QR-кодом с телефона, Matrix — адресом сервера и паролем. Затем в настройках подключения выберите ту же Открытую линию.
Проверка Статус подключения — «Подключен». Напишите на этот номер с другого телефона: сообщение должно открыть диалог в Открытой линии.
Дальше портал работает сам: первое сообщение клиента открывает диалог в Открытой линии, а карточку в CRM заводит Битрикс24 по правилам, которые уже настроены на портале. Что происходит с перепиской, лидами и сделками после этого, описано на странице об интеграции с Битрикс24.
Всё это ставится только при установке из Маркетплейса. При ручной настройке остаётся функционал Контакт-центра: сообщения ходят, но кнопки в карточках и пункта в меню портала не будет.
Режим выбирается при связывании и виден в разделе «Битрикс24». Он влияет только на путь запросов — на работу операторов и на переписку нет.
| Вопрос | Direct | Relay |
|---|---|---|
| Куда портал шлёт события | Напрямую на вашу установку Charon | На шлюз Charon, который передаёт их установке |
| Что для этого нужно | Публичный адрес установки, доступный порталу | Ничего: установка сама держит соединение со шлюзом |
| Когда получается | Облако Charon и свой сервер с публичным доменом | Сервер в локальной сети, без публичного адреса |
| Можно ли сменить потом | Да. Если у установки появился публичный адрес, укажите его в разделе «Битрикс24» и переключите портал на Direct | |
Relay — не временная мера и не урезанный режим: он существует ровно для того, чтобы коробка в локальной сети без публичного адреса работала с облачным порталом. Где при этом остаются переписка и файлы, разобрано на странице про облако и свой сервер.
Второй путь — локальное приложение Битрикс24 с собственными ключами OAuth. Он рассчитан на администратора, который сам заводит приложение на портале.
Сообщения при этом ходят: работает функционал Контакт-центра, операторы отвечают из Открытых линий.
Выбирайте ручную настройку, только если приложение Маркетплейса на вашем портале недоступно или политика компании запрещает сторонние приложения. Во всех остальных случаях путь через Маркетплейс короче и даёт больше.
Пять ситуаций, которые встречаются чаще прочих, и что смотреть в каждой.
| Что видно | Что проверить |
|---|---|
| Код сопряжения не принимается | Коду больше суток или он от другого портала. Переустановите приложение Charon в Битрикс24 — портал выдаст новый код. |
| Установка просит повторить под администратором | Приложение ставил обычный пользователь. Его токены не сохраняются намеренно, иначе интеграция получила бы урезанный доступ к CRM. Повторите установку под администратором портала. |
| Канала Charon нет в Контакт-центре | В разделе «Битрикс24» панели Charon посмотрите состояние OAuth-авторизации, затем зарегистрируйте коннектор. Регистрация не трогает уже настроенные линии и переписку. |
| Связь пропала после переустановки приложения | В том же разделе есть восстановление связи по сохранённой OAuth-авторизации портала — новый код сопряжения для этого не нужен. |
| Линия настроена, но сообщений в ней нет | Откройте подключение мессенджера в панели: работает только статус «Подключен». Если стоит «Отключен» или «Нужен вход в аккаунт» — переподключите канал или отсканируйте QR-код заново. И проверьте, что подключение привязано именно к этой Открытой линии. |
Проблемы с самим мессенджером — QR-код не появляется, аккаунт отвалился, Telegram просит облачный пароль — разобраны в инструкции по настройке.
Да. Приложение Charon получает доступ к Открытым линиям и CRM портала, поэтому устанавливать его должен администратор Битрикс24. Если установку начал обычный пользователь, Charon намеренно не сохраняет его токены — чтобы не сломать доступ к CRM — и просит повторить установку под администратором.
24 часа. Если код истёк, переустановите приложение Charon в Битрикс24 — портал выдаст новый. Код привязан к конкретному порталу: код от одного портала не подойдёт другому.
При установке из Маркетплейса Charon сам регистрирует коннектор, подписывается на события о новых сообщениях, добавляет кнопку «Написать первым» в карточки лида, сделки, контакта и компании и ставит пункт «Charon Messenger» в левое меню портала. Ручная настройка через локальное приложение с собственными ключами OAuth даёт только функционал Контакт-центра: встроенные окна панели и мессенджера (виджеты) в Битрикс24 не появятся.
Откройте раздел «Битрикс24» в панели Charon. Там видно, пройдена ли у портала авторизация по протоколу OAuth, и есть кнопка регистрации коннектора. Это два отдельных шага, и повторить их можно без потерь: регистрация не трогает уже настроенные линии и переписку.
Да. В этом случае связка поднимается в режиме Relay: события портала идут через шлюз Charon, а установка сама держит с ним соединение. Если у неё появится публичный адрес, в панели можно переключить портал на режим Direct — тогда Битрикс24 будет обращаться к установке напрямую.
Charon работает и с облачным, и с коробочным Битрикс24: подключение идёт по штатным механизмам Открытых линий. Если приложение Маркетплейса на портале недоступно, остаётся ручная настройка через локальное приложение с собственными ключами OAuth.
Расскажите, какой у вас Битрикс24 и какие мессенджеры нужны. На созвоне разберём подключение канала и покажем, как обращения расходятся по операторам.
Оставить заявку