Эта инструкция поможет установить приложение, подключить Telegram и проверить первый обмен.
Перед установкой
Установку и общие настройки выполняет администратор вашего Битрикс24.
Подготовьте:
- Доступ администратора к порталу, в котором будет работать приложение.
- Личный аккаунт Telegram и доступ к устройству, где он уже авторизован. Если включена двухфакторная защита, понадобится её пароль.
- Знакомого тестового адресата, которому можно отправить сообщение для проверки.
- Для работы через Открытую линию — настроенную линию и права на её использование.
- Для подключения Telegram-бота вместо личного аккаунта — бота, созданного через BotFather, и доступ владельца к его токену.
Приложение распространяется по подписной лицензии Битрикс24. Отдельной платы S-WEBS за сообщения и диалоги нет. Доступность приложения и условия подписки проверьте в его карточке в каталоге «Битрикс24 Маркетплейс».
Для первого теста CRM-чата нужен личный аккаунт Telegram. Telegram-боты в этом чате не поддерживаются; они используются в других сценариях приложения, включая текстового робота.
Установка
- Войдите в нужный Битрикс24 под администратором.
- Откройте каталог «Битрикс24 Маркетплейс».
- Найдите карточку приложения S-WEBS для подключения Telegram.
- Проверьте издателя, доступную версию, условия лицензии и ограничения карточки.
- Нажмите кнопку установки, предложенную карточкой.
- Ознакомьтесь с запрошенными правами приложения.
- Подтвердите установку, если эти права согласованы для вашего портала.
- Дождитесь завершения экрана «Установка Telegram».
- Откройте установленное приложение в своём Битрикс24.
Экран установки показывает подготовку приложения и подтверждение установки. Не закрывайте его, пока выполняются шаги. Успешное завершение обозначено состоянием «Установка завершена».
Если нужная новая версия ещё не доступна вашему порталу, уточните порядок её получения у S-WEBS. Адрес приложения вручную в браузере не заменяет установку через Битрикс24.
Установка не означает, что Telegram уже подключён, связка включена или сотрудники получили доступ к переписке. Эти настройки выполняются далее.
Необходимые права и доступ
| Для чего нужен доступ | Что проверить |
|---|---|
| Установка и настройка приложения | Пользователь является администратором Битрикс24. |
| CRM-чат | У сотрудника есть права на конкретную сделку, лид, контакт или поддерживаемый элемент смарт-процесса и доступ к выбранному личному аккаунту Telegram. |
| Открытая линия | Администратору доступна нужная линия; операторы имеют права работать с её обращениями. |
| Групповой чат Битрикс24 | Настраивающий пользователь имеет доступ к выбранному чату; бот приложения добавлен в этот чат. |
| Ограничение доступа по отделам и рабочим группам | В форме разрешений приложения согласован доступ к соответствующим справочникам. |
| Текстовый робот | Выбранный пользователь выполнения имеет права на CRM-карточку и выбранное Telegram-подключение. |
Ориентируйтесь на фактическую форму разрешений устанавливаемой версии. Инструкция не предлагает вводить серверные ключи, технические адреса, параметры Telegram API или создавать отдельную учётную запись в стороннем сервисе.
Первичная настройка
Обязательный шаг: подключить Telegram
Для CRM и первой проверки используйте личный аккаунт:
- Откройте «Подключения Telegram».
- Нажмите «Подключить».
- Введите понятное название подключения.
- Выберите «Личный аккаунт».
- Подтвердите создание подключения.
- Для входа по телефону введите номер с
+и кодом страны. - Нажмите «Продолжить».
- Введите код способом, который предложил Telegram.
- Если Telegram запросит пароль двухфакторной защиты, введите его в форме.
- Проверьте состояния «Авторизован» и «На связи» в карточке подключения.
Код может прийти в служебный чат Telegram на уже авторизованном устройстве, а не по SMS. Форма показывает доступный способ доставки.
В качестве другого способа входа можно нажать «Войти по QR», если кнопка доступна. В Telegram откройте Настройки → Устройства → Подключить устройство и отсканируйте QR. Завершите дополнительные запросы Telegram, если они появятся.
Если вы выбрали сценарий с Telegram-ботом, при создании укажите «Telegram-бот» и введите токен BotFather в соответствующее поле. Дождитесь авторизации. Для личной отправки получатель должен сначала написать боту; в группе бот должен быть участником и иметь право отправлять сообщения. Бот работает с известным чатом или его ID и не ищет произвольного получателя по телефону.
Настроить первый сценарий: личный чат в CRM
Этот путь позволяет проверить приложение без создания связки с Открытой линией.
- В меню приложения откройте «Чат Telegram».
- Нажмите «Добавить вкладку в сделки, лиды и контакты».
- Откройте доступную вам сделку, лид или контакт.
- Обновите CRM-карточку.
- Откройте вкладку Telegram.
- Выберите тестового адресата из списка CRM или нажмите «Другой адресат».
- Выберите готовый личный аккаунт Telegram.
- Укажите телефон в международном формате с
+либо username выбранного адресата. - Нажмите «Найти и привязать к карточке».
- Проверьте, что открыт нужный Telegram-диалог.
Привязка диалога не отправляет сообщение. Если этот же диалог явно привязан в другой CRM-карточке, будет доступна общая сохранённая история; учитывайте это при выборе тестовой карточки и её участников.
Если первый сценарий — Открытая линия
Вместо настройки CRM-диалога выполните следующие действия:
- Откройте «Связки».
- Выберите готовое подключение Telegram.
- Выберите «Все входящие чаты» или «Один чат Telegram».
- Для одного чата укажите его ID.
- Выберите нужные «Типы Telegram-чатов».
- В назначении выберите «Открытая линия».
- Выберите нужную настроенную линию.
- Проверьте входящие и исходящие правила файлов.
- Нажмите «Сохранить связку».
- В сохранённой связке нажмите «Проверить и включить».
- Убедитесь, что связка показывает «Включена».
При настройке Telegram-коннектора из Контакт-центра компактная форма сохраняет выбранное подключение. Фильтры и включение передачи проверяются в «Связках» приложения. Сохранённый выбор сам по себе не включает пересылку.
Необязательные настройки
После первого успешного обмена настройте только то, что нужно команде:
- «Доступ к аккаунтам» — ограничить конкретный аккаунт пользователями, отделами или рабочими группами. Права на CRM-карточку продолжают действовать. Пустой ограниченный список оставляет доступ только администраторам.
- «Чат в смарт-процессах» — выбрать существующие типы, которым нужна вкладка Telegram.
- «Файлы CRM-чата» на том же экране — отдельно разрешить входящие и исходящие форматы для аккаунта.
- «Автоматизация CRM» на том же экране — разрешить подключения и зарегистрировать текстового робота.
- «Оформление» — выбрать светлую, тёмную или системную тему.
Эти настройки не нужны все одновременно. Выберите те, которые требуются вашей команде.
Проверка установки
Проверяйте последовательно три результата.
| Этап | Видимый результат | Что он подтверждает |
|---|---|---|
| Установка в Битрикс24 | Экран показал «Установка завершена», приложение открывается из портала. | Завершение установки приложения. |
| Подключение Telegram | Карточка подключения показывает «Авторизован» и «На связи». | Готовность выбранного подключения к работе. |
| Первый обмен | Тестовое сообщение фактически получено в Telegram; ответ виден в выбранном назначении Битрикс24. | Работу проверенного направления и адресата. |
Первый эффект из CRM
- В привязанном тестовом диалоге напишите короткое нейтральное сообщение.
- Нажмите «Отправить».
- Дождитесь статуса «Отправлено в Telegram».
- Проверьте получение у тестового адресата.
- Попросите его ответить в том же диалоге.
- Проверьте ответ как сообщение клиента во вкладке Telegram.
- Перезагрузите CRM-карточку.
- Убедитесь, что диалог и оба сообщения сохранились.
Это первый проверяемый результат: отправка из CRM и ответ клиента в том же сохранённом диалоге. Статус «Прочитано» может появиться позже; он не обязателен для подтверждения установки.
Первый эффект через Открытую линию
- Отправьте тестовое сообщение из другого Telegram-аккаунта в диалог, подходящий под включённую связку.
- Проверьте его появление у оператора выбранной Открытой линии.
- Ответьте из линии.
- Проверьте ответ в Telegram.
Для первой проверки используйте только нужную связку: несколько подходящих включённых связок могут передать сообщение в несколько назначений.
Сохранение настроек, открытие экрана и состояние «В очереди» не заменяют фактического получения сообщения. При неизвестном результате сначала проверьте Telegram-диалог, прежде чем отправлять повторно.
Частые проблемы установки и первичной настройки
| Что произошло | Как действовать |
|---|---|
| «Установка не завершена» | Проверьте, что установка открыта под администратором нужного портала. Если на экране доступна кнопка «Повторить установку», повторите после проверки причины. |
| Повторная установка сообщает о конфликте или необходимости сверки | Обратитесь к администратору или S-WEBS. Не удаляйте приложение ради обхода неопределённого результата. |
| Открывается пример с предупреждением о тестовых данных | Откройте установленное приложение из Битрикс24. Пример не подключён к реальному Telegram. |
| Код Telegram не пришёл | Прочитайте подсказку о канале доставки. Проверьте служебный чат Telegram на уже авторизованном устройстве. Повтор возможен только когда Telegram его разрешает; при доступности используйте QR. |
| Время формы входа истекло | Нажмите «Обновить» и продолжите по актуальному состоянию. Не выполняйте выход из уже готового аккаунта только из-за старой формы. |
| Нет вкладки Telegram в сделке, лиде или контакте | Администратор открывает «Чат Telegram» и добавляет вкладку отдельной кнопкой; затем карточку нужно обновить. |
| У сотрудника нет доступного аккаунта | Администратор проверяет авторизацию аккаунта, назначения доступа и права сотрудника на карточку. Сотруднику не нужно повторно устанавливать приложение. |
| Не найдена Открытая линия | Проверьте линию в Контакт-центре и доступ к ней. В «Связках» обновите список линий. |
| Связка сохранена, но сообщения не поступают | Проверьте «Проверить и включить», состояние подключения и выбранные типы чатов. Сохранение изменённого фильтра выключает связку. |
| Telegram не подтвердил отправку | Проверьте диалог и состояние операции. Не создавайте повторную отправку до сверки неизвестного результата. |
Для обращения за помощью достаточно раздела, времени действия, текста ошибки и показанного ID для диагностики. Коды входа, пароль, QR и токен бота передавать в переписке не нужно.
Удаление и повторная установка
Для временной остановки используйте «Выключить» у конкретной связки или «Приостановить» у подключения. Выход из Telegram-сессии — отдельное действие «Выйти из аккаунта», после которого потребуется новый вход.
Удаление приложения из Битрикс24 отключает его установку и связки. Повторная установка не подтверждает автоматическое включение прежних связок, сохранность всех пользовательских данных или перенос настроек старой версии. Согласуйте восстановление с S-WEBS и после него повторите проверку подключения и первого обмена.
Удаление связки внутри приложения отличается от удаления самого приложения: связку можно восстановить через «Показать удалённые», после чего отдельно проверить и включить её.