Подключение Telegram к открытым линиям Битрикс24

Подключение Telegram к открытым линиям Битрикс24

Telegram подключается к открытым линиям через официальный Bot API. Технически это один из самых чистых вариантов интеграции мессенджера с Битрикс24: никаких сторонних провайдеров, никаких промежуточных сервисов, прямое соединение через webhook.

Что происходит после подключения

Клиент пишет боту в Telegram → сообщение поступает в очередь открытой линии → оператор видит чат в Битрикс24 и отвечает → ответ приходит клиенту в Telegram. История переписки сохраняется в CRM-карточке лида или сделки.

Для клиента это выглядит как обычная переписка с ботом. Для оператора — стандартный чат в Битрикс24, без разницы откуда пришло сообщение.

Пошаговое подключение

Шаг 1. Создать Telegram-бота. Написать @BotFather в Telegram:

• /newbot → ввести название бота (видит клиент, например «Поддержка ООО Ромашка»).
• Ввести username бота (латиница, заканчивается на bot, например romashka_support_bot).
• BotFather выдаёт токен: 1234567890:AAF....

Сохранить токен — он потребуется в настройках Битрикс24.

Шаг 2. Подключить к открытой линии. Битрикс24 → CRM → Контакт-центр → Открытые линии → выбрать нужную линию → Каналы → Telegram → «Подключить».

Ввести токен бота. Битрикс24 автоматически устанавливает webhook на своём сервере — ничего дополнительно настраивать не нужно.

Шаг 3. Проверить. Написать боту в Telegram → убедиться, что сообщение появилось в очереди операторов открытой линии.

Шаг 4. Настройки бота в Bitrix24. В настройках подключённого Telegram-канала можно указать:

• Приветственное сообщение для команды /start.
• Как часто разрешать обращения (ограничение спама).

Частые проблемы

«Бот не отвечает» после подключения. Самая частая причина — токен скопирован с пробелом или неверно. Перепроверить: скопировать токен заново из BotFather, удалить канал в Битрикс24 и добавить повторно.

Один токен нельзя использовать дважды. Если бот уже подключён к другому сервису или к другой открытой линии — webhook перезаписывается. Бот будет работать только там, где он подключён последним. Для разных целей нужны разные боты с разными токенами.

Медиафайлы не принимаются. Битрикс24 принимает от Telegram: текст, фото, видео, документы, голосовые, стикеры (как изображения). Видеосообщения (кружочки) — поддерживаются не во всех версиях. Если клиент присылает неподдерживаемый тип — оператор видит пустое сообщение. Решение: в приветственном тексте попросить присылать фото, а не видео.

Лиды не создаются в CRM. Проверить настройки открытой линии: CRM-интеграция должна быть включена. Telegram-пользователи идентифицируются по telegram_id, а не по телефону — если в CRM нет контакта с таким telegram_id, будет создан новый лид.

Несколько операторов видят один чат. Нормальное поведение при настройке режима «одновременно всем». Ответить первым может любой оператор — после этого чат закрепляется за ним. Если нужна персональная ответственность — переключить на режим «поочерёдно».

Ограничения нативной интеграции

• Нет автоматических ответов и ботовой логики — только маршрутизация к оператору.
• Нет интерактивных кнопок Telegram в ответах операторов.
• История чата хранится в Битрикс24, но не в самом Telegram у клиента (обычная переписка с ботом).
• При повторном обращении клиент попадает в ту же линию, но не всегда к тому же оператору (зависит от настроек).

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