S-WEBS24

Битрикс24

CRM, процессы и приложения для вашей компании

К описанию приложенияРуководство
Установка

Установка: Telegram: чаты, боты и CRM

Личные диалоги Telegram в CRM и обращения в Открытых линиях. Подключения аккаунтов и ботов, текстовый робот, файлы и доступ сотрудников.

Эта инструкция поможет установить приложение, подключить Telegram и проверить первый обмен.

Перед установкой

Установку и общие настройки выполняет администратор вашего Битрикс24.

Подготовьте:

  • Доступ администратора к порталу, в котором будет работать приложение.
  • Личный аккаунт Telegram и доступ к устройству, где он уже авторизован. Если включена двухфакторная защита, понадобится её пароль.
  • Знакомого тестового адресата, которому можно отправить сообщение для проверки.
  • Для работы через Открытую линию — настроенную линию и права на её использование.
  • Для подключения Telegram-бота вместо личного аккаунта — бота, созданного через BotFather, и доступ владельца к его токену.

Приложение распространяется по подписной лицензии Битрикс24. Отдельной платы S-WEBS за сообщения и диалоги нет. Доступность приложения и условия подписки проверьте в его карточке в каталоге «Битрикс24 Маркетплейс».

Для первого теста CRM-чата нужен личный аккаунт Telegram. Telegram-боты в этом чате не поддерживаются; они используются в других сценариях приложения, включая текстового робота.

Установка

  1. Войдите в нужный Битрикс24 под администратором.
  2. Откройте каталог «Битрикс24 Маркетплейс».
  3. Найдите карточку приложения S-WEBS для подключения Telegram.
  4. Проверьте издателя, доступную версию, условия лицензии и ограничения карточки.
  5. Нажмите кнопку установки, предложенную карточкой.
  6. Ознакомьтесь с запрошенными правами приложения.
  7. Подтвердите установку, если эти права согласованы для вашего портала.
  8. Дождитесь завершения экрана «Установка Telegram».
  9. Откройте установленное приложение в своём Битрикс24.

Экран установки показывает подготовку приложения и подтверждение установки. Не закрывайте его, пока выполняются шаги. Успешное завершение обозначено состоянием «Установка завершена».

Если нужная новая версия ещё не доступна вашему порталу, уточните порядок её получения у S-WEBS. Адрес приложения вручную в браузере не заменяет установку через Битрикс24.

Установка не означает, что Telegram уже подключён, связка включена или сотрудники получили доступ к переписке. Эти настройки выполняются далее.

Необходимые права и доступ

Для чего нужен доступ Что проверить
Установка и настройка приложения Пользователь является администратором Битрикс24.
CRM-чат У сотрудника есть права на конкретную сделку, лид, контакт или поддерживаемый элемент смарт-процесса и доступ к выбранному личному аккаунту Telegram.
Открытая линия Администратору доступна нужная линия; операторы имеют права работать с её обращениями.
Групповой чат Битрикс24 Настраивающий пользователь имеет доступ к выбранному чату; бот приложения добавлен в этот чат.
Ограничение доступа по отделам и рабочим группам В форме разрешений приложения согласован доступ к соответствующим справочникам.
Текстовый робот Выбранный пользователь выполнения имеет права на CRM-карточку и выбранное Telegram-подключение.

Ориентируйтесь на фактическую форму разрешений устанавливаемой версии. Инструкция не предлагает вводить серверные ключи, технические адреса, параметры Telegram API или создавать отдельную учётную запись в стороннем сервисе.

Первичная настройка

Обязательный шаг: подключить Telegram

Для CRM и первой проверки используйте личный аккаунт:

  1. Откройте «Подключения Telegram».
  2. Нажмите «Подключить».
  3. Введите понятное название подключения.
  4. Выберите «Личный аккаунт».
  5. Подтвердите создание подключения.
  6. Для входа по телефону введите номер с + и кодом страны.
  7. Нажмите «Продолжить».
  8. Введите код способом, который предложил Telegram.
  9. Если Telegram запросит пароль двухфакторной защиты, введите его в форме.
  10. Проверьте состояния «Авторизован» и «На связи» в карточке подключения.

Код может прийти в служебный чат Telegram на уже авторизованном устройстве, а не по SMS. Форма показывает доступный способ доставки.

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

Если вы выбрали сценарий с Telegram-ботом, при создании укажите «Telegram-бот» и введите токен BotFather в соответствующее поле. Дождитесь авторизации. Для личной отправки получатель должен сначала написать боту; в группе бот должен быть участником и иметь право отправлять сообщения. Бот работает с известным чатом или его ID и не ищет произвольного получателя по телефону.

Настроить первый сценарий: личный чат в CRM

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

  1. В меню приложения откройте «Чат Telegram».
  2. Нажмите «Добавить вкладку в сделки, лиды и контакты».
  3. Откройте доступную вам сделку, лид или контакт.
  4. Обновите CRM-карточку.
  5. Откройте вкладку Telegram.
  6. Выберите тестового адресата из списка CRM или нажмите «Другой адресат».
  7. Выберите готовый личный аккаунт Telegram.
  8. Укажите телефон в международном формате с + либо username выбранного адресата.
  9. Нажмите «Найти и привязать к карточке».
  10. Проверьте, что открыт нужный Telegram-диалог.

Привязка диалога не отправляет сообщение. Если этот же диалог явно привязан в другой CRM-карточке, будет доступна общая сохранённая история; учитывайте это при выборе тестовой карточки и её участников.

Если первый сценарий — Открытая линия

Вместо настройки CRM-диалога выполните следующие действия:

  1. Откройте «Связки».
  2. Выберите готовое подключение Telegram.
  3. Выберите «Все входящие чаты» или «Один чат Telegram».
  4. Для одного чата укажите его ID.
  5. Выберите нужные «Типы Telegram-чатов».
  6. В назначении выберите «Открытая линия».
  7. Выберите нужную настроенную линию.
  8. Проверьте входящие и исходящие правила файлов.
  9. Нажмите «Сохранить связку».
  10. В сохранённой связке нажмите «Проверить и включить».
  11. Убедитесь, что связка показывает «Включена».

При настройке Telegram-коннектора из Контакт-центра компактная форма сохраняет выбранное подключение. Фильтры и включение передачи проверяются в «Связках» приложения. Сохранённый выбор сам по себе не включает пересылку.

Необязательные настройки

После первого успешного обмена настройте только то, что нужно команде:

  • «Доступ к аккаунтам» — ограничить конкретный аккаунт пользователями, отделами или рабочими группами. Права на CRM-карточку продолжают действовать. Пустой ограниченный список оставляет доступ только администраторам.
  • «Чат в смарт-процессах» — выбрать существующие типы, которым нужна вкладка Telegram.
  • «Файлы CRM-чата» на том же экране — отдельно разрешить входящие и исходящие форматы для аккаунта.
  • «Автоматизация CRM» на том же экране — разрешить подключения и зарегистрировать текстового робота.
  • «Оформление» — выбрать светлую, тёмную или системную тему.

Эти настройки не нужны все одновременно. Выберите те, которые требуются вашей команде.

Проверка установки

Проверяйте последовательно три результата.

Этап Видимый результат Что он подтверждает
Установка в Битрикс24 Экран показал «Установка завершена», приложение открывается из портала. Завершение установки приложения.
Подключение Telegram Карточка подключения показывает «Авторизован» и «На связи». Готовность выбранного подключения к работе.
Первый обмен Тестовое сообщение фактически получено в Telegram; ответ виден в выбранном назначении Битрикс24. Работу проверенного направления и адресата.

Первый эффект из CRM

  1. В привязанном тестовом диалоге напишите короткое нейтральное сообщение.
  2. Нажмите «Отправить».
  3. Дождитесь статуса «Отправлено в Telegram».
  4. Проверьте получение у тестового адресата.
  5. Попросите его ответить в том же диалоге.
  6. Проверьте ответ как сообщение клиента во вкладке Telegram.
  7. Перезагрузите CRM-карточку.
  8. Убедитесь, что диалог и оба сообщения сохранились.

Это первый проверяемый результат: отправка из CRM и ответ клиента в том же сохранённом диалоге. Статус «Прочитано» может появиться позже; он не обязателен для подтверждения установки.

Первый эффект через Открытую линию

  1. Отправьте тестовое сообщение из другого Telegram-аккаунта в диалог, подходящий под включённую связку.
  2. Проверьте его появление у оператора выбранной Открытой линии.
  3. Ответьте из линии.
  4. Проверьте ответ в Telegram.

Для первой проверки используйте только нужную связку: несколько подходящих включённых связок могут передать сообщение в несколько назначений.

Сохранение настроек, открытие экрана и состояние «В очереди» не заменяют фактического получения сообщения. При неизвестном результате сначала проверьте Telegram-диалог, прежде чем отправлять повторно.

Частые проблемы установки и первичной настройки

Что произошло Как действовать
«Установка не завершена» Проверьте, что установка открыта под администратором нужного портала. Если на экране доступна кнопка «Повторить установку», повторите после проверки причины.
Повторная установка сообщает о конфликте или необходимости сверки Обратитесь к администратору или S-WEBS. Не удаляйте приложение ради обхода неопределённого результата.
Открывается пример с предупреждением о тестовых данных Откройте установленное приложение из Битрикс24. Пример не подключён к реальному Telegram.
Код Telegram не пришёл Прочитайте подсказку о канале доставки. Проверьте служебный чат Telegram на уже авторизованном устройстве. Повтор возможен только когда Telegram его разрешает; при доступности используйте QR.
Время формы входа истекло Нажмите «Обновить» и продолжите по актуальному состоянию. Не выполняйте выход из уже готового аккаунта только из-за старой формы.
Нет вкладки Telegram в сделке, лиде или контакте Администратор открывает «Чат Telegram» и добавляет вкладку отдельной кнопкой; затем карточку нужно обновить.
У сотрудника нет доступного аккаунта Администратор проверяет авторизацию аккаунта, назначения доступа и права сотрудника на карточку. Сотруднику не нужно повторно устанавливать приложение.
Не найдена Открытая линия Проверьте линию в Контакт-центре и доступ к ней. В «Связках» обновите список линий.
Связка сохранена, но сообщения не поступают Проверьте «Проверить и включить», состояние подключения и выбранные типы чатов. Сохранение изменённого фильтра выключает связку.
Telegram не подтвердил отправку Проверьте диалог и состояние операции. Не создавайте повторную отправку до сверки неизвестного результата.

Для обращения за помощью достаточно раздела, времени действия, текста ошибки и показанного ID для диагностики. Коды входа, пароль, QR и токен бота передавать в переписке не нужно.

Удаление и повторная установка

Для временной остановки используйте «Выключить» у конкретной связки или «Приостановить» у подключения. Выход из Telegram-сессии — отдельное действие «Выйти из аккаунта», после которого потребуется новый вход.

Удаление приложения из Битрикс24 отключает его установку и связки. Повторная установка не подтверждает автоматическое включение прежних связок, сохранность всех пользовательских данных или перенос настроек старой версии. Согласуйте восстановление с S-WEBS и после него повторите проверку подключения и первого обмена.

Удаление связки внутри приложения отличается от удаления самого приложения: связку можно восстановить через «Показать удалённые», после чего отдельно проверить и включить её.