Контакты Попробовать бесплатно
Попробовать бесплатно
Matrix

Matrix в Открытых линиях Битрикс24

Charon входит в аккаунт на вашем сервере Matrix по логину и паролю. Сообщения из личных и групповых комнат приходят в Открытую линию, оператор отвечает из Битрикс24. Зашифрованные комнаты тоже поддерживаются.

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

Попробовать бесплатно Как подключить аккаунт

Подойдёт ли это вам

Matrix — открытый протокол переписки, сервер которого компания может держать у себя. Charon подключает аккаунт на таком сервере и переносит переписку из его комнат в Битрикс24. Прежде чем подключать, проверьте по карточкам ниже.

Подходит

Переписка с клиентами на своём сервере

Клиенты и партнёры пишут в комнаты аккаунта на вашем сервере Matrix, операторы отвечают из Открытой линии, история остаётся в карточке клиента.

Как устроена связка с Битрикс24
Не для этого

Звонки и первое сообщение из CRM

Звонки, стикеры, опросы и геопозиция в линию не передаются. Написать первым из карточки CRM в Matrix нельзя — диалог начинается в комнате.

Что передаётся
Понадобится

Адрес сервера и учётная запись

Адрес вашего сервера Matrix, логин и пароль аккаунта, от имени которого будут отвечать операторы. Для зашифрованных комнат — ещё один клиент Matrix этого аккаунта, чтобы заверить сеанс Charon.

Как работают зашифрованные комнаты
Где работает

В облаке или на своём сервере

Подключение одинаково в облаке Charon24 и на своём сервере. При установке у себя ключи шифрования и переписка остаются в вашей сети.

Сравнить облако и свой сервер

Как сообщение доходит до оператора

Charon входит в аккаунт Matrix как ещё одно устройство и работает с сервером по стандартному протоколу клиентов Matrix, без привязки к конкретной программе сервера. Приглашения в комнаты Charon принимает сам.

Клиент пишет вам

  1. Matrix клиента

    Клиент пишет в ваш аккаунт, как обычно.

  2. Charon

    Получает сообщение из комнаты как одно из устройств аккаунта.

  3. Открытая линия

    Открывает диалог и распределяет его по своим правилам.

  4. Оператор

    Видит сообщение в Битрикс24 и историю в карточке клиента.

Оператор отвечает

  1. Битрикс24

    Оператор пишет ответ или прикладывает файл в чате линии.

  2. Charon

    Отправляет ответ в ту же комнату от имени аккаунта.

  3. Matrix клиента

    Клиент получает ответ в том же чате.

Как подключить аккаунт

Четыре шага. Первые два делаются в панели Charon, третий — один раз для всего портала Битрикс24.

  1. 1

    Укажите адрес сервера Matrix

    В панели Charon добавьте подключение Matrix и укажите адрес сервера, например https://matrix.example.com.

  2. 2

    Войдите в аккаунт

    Введите имя пользователя (user или @user:matrix.example.org) и пароль аккаунта Matrix. Если в аккаунте есть зашифрованные комнаты, заверьте сеанс Charon — как это сделать.

    Проверка Статус подключения в панели — «На связи».

  3. 3

    Привяжите подключение к Открытой линии

    Если портал ещё не подключён, поставьте приложение Charon из Маркетплейса Битрикс24 и выберите Открытую линию — по шагам это описано на странице подключения Битрикс24. Затем привяжите к линии подключение Matrix.

  4. 4

    Проверьте на тестовом сообщении

    Напишите аккаунту из другого аккаунта Matrix.

    Проверка Сообщение появилось в Открытой линии, а ответ оператора пришёл в ту же комнату.

Что попадает в Битрикс24

Коротко о том, что оператор увидит в Открытой линии и чего там не будет.

Что Как передаётся
Текст В обе стороны: от клиента в линию и от оператора в комнату.
Изображения, видео, аудио, файлы Приходят в линию файлами — в том числе из зашифрованных комнат. Оператор может отправить файл в ответ.
Правки и удаления Передаются в обе стороны.
Сообщения из других клиентов этого аккаунта Если сотрудник ответил из другого клиента Matrix под тем же аккаунтом, ответ тоже попадает в переписку.
Личные и групповые комнаты Приходят в линию, у каждого сообщения указан участник, который его написал.
Звонки, стикеры, опросы, геопозиция Не передаются.

Зашифрованные комнаты

В зашифрованных комнатах (сквозное шифрование, E2EE) сообщения расшифровывает только устройство, которому доверяет аккаунт. Charon — новое устройство, поэтому его сеанс нужно заверить.

Если подключение перестало работать

Статус каждого подключения виден в панели Charon. Вход сохраняется между перезапусками; заново входить нужно, только если сеанс завершили на сервере Matrix.

Что случилось Что увидите Что делать
Charon перезапустили или обновили Подключение возвращается в «На связи» без вашего участия. Ничего. Вход в Matrix хранится в базе Charon в зашифрованном виде.
Сеанс Charon завершили на сервере Matrix Подключение перестаёт получать сообщения, панель показывает ошибку. Войдите в аккаунт заново по логину и паролю и, если нужно, снова заверьте сеанс.
Потеряно хранилище ключей шифрования Charon подключается как новое устройство. Заверьте новый сеанс. Прежние зашифрованные сообщения прочитать уже не получится.

Куда присылать сообщение о том, что подключение перестало работать, — на почту, в Telegram, в MAX или push-уведомлением — выбирают в панели Charon.

Коротко о подключении Matrix

Способ подключения
Адрес сервера Matrix, логин и пароль аккаунта. Charon работает с сервером по стандартному протоколу клиентов Matrix.
Где хранится вход
В базе Charon в зашифрованном виде, ключи шифрования комнат — на сервере, где работает Charon.
Куда идёт переписка
В Открытые линии Битрикс24. amoCRM и другие CRM — через программный интерфейс Charon (API) и уведомления о событиях; без CRM — в мессенджер Charon.
Первое сообщение
Из карточки CRM в Matrix написать нельзя — диалог начинается в комнате.
Комнаты
Личные и групповые, в том числе зашифрованные. Приглашения Charon принимает сам.
Развёртывание
Облако, свой сервер на Linux или Windows, приложение из Маркетплейса Битрикс24 — чем они отличаются.

Частые вопросы про Matrix в Charon

С каким сервером Matrix работает Charon?

С тем, на котором заведён аккаунт: Charon подключается по стандартному протоколу клиентов Matrix и не привязан к конкретной программе сервера. Нужны адрес сервера, логин и пароль.

Поддерживаются ли зашифрованные комнаты?

Да. Charon расшифровывает сообщения и файлы в зашифрованных комнатах и шифрует ответы. Для этого сеанс Charon нужно заверить из другого клиента этого аккаунта. Как заверить сеанс.

Почему часть зашифрованных сообщений приходит без текста?

Скорее всего, сеанс Charon ещё не заверен. Нажмите в панели «Заверить сеанс» и подтвердите запрос в другом клиенте этого аккаунта, например в Element.

Что будет, если потерять ключи шифрования?

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

Попадают ли в Битрикс24 групповые комнаты?

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

Можно ли писать клиенту первым?

Нет. Кнопка «Написать первым» в карточке CRM работает для WhatsApp, Telegram и Max; в Matrix диалог начинается в комнате. Как работает кнопка.

Сколько аккаунтов можно подключить?

Каждый аккаунт — отдельное подключение, их число зависит от тарифа. Пробный период — 14 дней на 2 подключения; в облаке после покупки эти 2 подключения остаются бесплатно сверх тарифа. Тарифы.

Проверьте на своём аккаунте

Пробный период — 14 дней на два подключения: заведите Matrix и проверьте подключение на своём аккаунте.

Попробовать бесплатно Запросить демо