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

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

Личный аккаунт подключается к Charon по QR-коду, как Telegram на компьютере. Сообщения клиентов приходят в Открытую линию, оператор отвечает из Битрикс24, переписка остаётся в карточке клиента.

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

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

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

Charon берёт аккаунт, в котором менеджеры уже переписываются с клиентами, и переносит эту переписку в Битрикс24. Прежде чем подключать, проверьте по карточкам ниже: что подходит, что нет и что понадобится.

Подходит

Менеджеры переписываются с клиентами

Клиенты пишут в ваш аккаунт, операторы отвечают из Открытой линии, а менеджер может начать диалог сам из карточки CRM — по имени пользователя или номеру телефона.

Как написать клиенту первым
Не для этого

Рассылки, каналы и большие чаты

За спам и массовые рассылки Telegram блокирует аккаунты. Каналы и супергруппы Charon в список чатов не синхронизирует — в линию попадают личные переписки и обычные группы.

Что Telegram говорит о правилах
Понадобится

Телефон с аккаунтом и доступ к порталу

Телефон, на котором аккаунт уже открыт в Telegram, — чтобы отсканировать QR-код, и облачный пароль, если он включён. В мобильном приложении Charon можно войти и по номеру с кодом от Telegram. Для CRM — права администратора портала Битрикс24, чтобы поставить приложение.

Подключение портала за пять шагов
Где работает

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

В облаке Charon24 подключение готово сразу. На своём сервере администратор один раз получает на my.telegram.org ключи API ID и API Hash — это пара идентификаторов приложения — и указывает их в настройках установки.

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

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

Telegram разрешает входить в один аккаунт с нескольких устройств: так работают Telegram на компьютере и в браузере. Charon входит в аккаунт таким же отдельным устройством и держит связь с Telegram сам, поэтому телефону не нужно быть в сети.

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

  1. Telegram клиента

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

  2. Charon

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

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

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

  4. Оператор

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

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

  1. Битрикс24

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

  2. Charon

    Отправляет ответ из вашего аккаунта.

  3. Telegram клиента

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

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

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

  1. 1

    Создайте подключение Telegram

    В панели Charon добавьте подключение Telegram. Панель подготовит QR-код для входа.

  2. 2

    Отсканируйте QR-код в Telegram

    На телефоне откройте Telegram → Настройки → Устройства → Подключить устройство и наведите камеру на код в панели. Если в аккаунте включён облачный пароль, панель попросит его ввести. Если Telegram запросит адрес почты или проверку «я не робот», панель покажет и этот шаг. В мобильном приложении Charon вместо QR-кода можно ввести номер телефона и код, который пришлёт Telegram.

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

  3. 3

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

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

  4. 4

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

    Напишите в подключённый аккаунт с другого аккаунта Telegram.

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

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

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

Что Как передаётся
Текст В обе стороны: от клиента в линию и от оператора клиенту.
Фото, видео, документы, аудио и голосовые, видеосообщения, стикеры Приходят в линию файлами, оператор может отправить файл в ответ. Ссылка на файл ведёт в Charon, подписана и действует ограниченное время — это не открытая ссылка на хранилище.
Опросы и геопозиция Опрос приходит в линию текстом с вопросом и вариантами ответа, геопозиция — координатами и ссылкой на карту.
Сообщения, отправленные с телефона Если менеджер ответил клиенту прямо из Telegram, ответ тоже попадает в переписку в Битрикс24 — история остаётся полной.
Правки и удаления Передаются в Битрикс24.
Обычные группы Приходят в линию, у каждого сообщения указан участник, который его написал.
Супергруппы и каналы Charon не синхронизирует их в список чатов. Как канал для CRM на них не рассчитывайте.

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

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

Что случилось Что увидите Что делать
Charon перезапустили или обновили Подключение возвращается в «На связи» без вашего участия. Ничего. Сеанс Telegram хранится в базе Charon в зашифрованном виде, входить заново не нужно.
Charon был недоступен, например сервер выключали После включения подключение возвращается в «На связи». Ничего. Charon догружает сообщения, пришедшие за последние 7 дней, — до 100 в каждом чате — и отправляет их в линию.
Связь с Telegram прервалась Подключение возвращается в «На связи» без вашего участия. Ничего: Charon переподключается сам.
Сеанс Charon завершили в Telegram или Telegram его отозвал Панель сообщает, что сессия Telegram больше не активна. Нажмите «Переподключить и авторизовать» и заново отсканируйте QR-код телефоном с этим аккаунтом.

Сеанс Charon виден в Telegram в разделе Настройки → Устройства, рядом с остальными. Если там нажать «Завершить все другие сеансы», Charon тоже отключится. Куда присылать сообщение о том, что подключение перестало работать, — на почту, в Telegram, в MAX или push-уведомлением — выбирают в панели Charon.

Правила Telegram и риск блокировки

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

Официальные правила: «Obtaining api_id» («Как получить api_id», страница для разработчиков Telegram, на английском).

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

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

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

Нужны ли Telegram Premium или Telegram Business?

Нет. Charon подключает обычный личный аккаунт: он входит по QR-коду как ещё одно устройство, так же как Telegram на компьютере.

Нужно ли держать телефон с Telegram включённым?

Нет. Сеанс Charon работает сам по себе, как Telegram на компьютере: телефон нужен только для того, чтобы отсканировать QR-код.

Что, если в аккаунте включён облачный пароль?

После сканирования QR-кода панель попросит ввести облачный пароль Telegram. Его вводят один раз при подключении; Charon хранит в базе сеанс, а не пароль.

Могут ли заблокировать аккаунт?

Такой риск есть. Charon — неофициальный клиент Telegram, а Telegram пишет, что аккаунты, которые входят через неофициальные клиенты, автоматически попадают под наблюдение, и навсегда блокирует за флуд, спам и накрутку. Что помогает снизить риск.

Что делать, если сеанс Charon завершили в Telegram?

Панель сообщит, что сеанс больше не активен. Нажмите «Переподключить и авторизовать» и заново отсканируйте QR-код. После перезапуска или обновления Charon входить заново не нужно. Все случаи.

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

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

Попадёт ли в Битрикс24 старая переписка?

Нет. При подключении Charon загружает к себе историю последних 100 чатов — до 500 сообщений в каждом, — но в Открытую линию она не отправляется: там переписка начинается с первого нового сообщения.

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

Да. Кнопка «Charon: Написать первым» в карточке CRM открывает чат по имени пользователя Telegram или по номеру телефона. По номеру — если настройки приватности собеседника позволяют найти его по номеру. Что видит менеджер.

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

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

Где взять API ID и API Hash?

В облаке Charon24 ничего получать не нужно. При установке на свой сервер администратор один раз получает API ID и API Hash на my.telegram.org и указывает их в настройках установки; они общие для всех подключений Telegram на этом сервере.

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

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

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