Как подключить Telegram к X10CRM: бот, Business и собственный номер

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

Инструкция поможет настроить Telegram и проверить, что менеджеры получают сообщения и отвечают из CRM. Если вы ещё выбираете способ подключения, начните со сравнения бота, Business и номера компании.

#Что подготовить

  • Доступ к настройкам интеграций и список сотрудников, которым нужен канал.
  • Для бота — токен BotFather и доступная по HTTPS CRM.
  • Для Business — подключённый бот с бизнес-режимом и доступ к настройкам аккаунта Telegram.
  • Для прямого номера — телефон с Telegram и пароль двухэтапной проверки, если он установлен. Команда внедрения заранее настраивает серверный модуль.
  • Для E-chat — отдельный кабинет провайдера; используйте инструкцию E-chat.

Откройте настройки Telegram: «Интеграции → Соцсети → Telegram». Адрес страницы в вашей CRM — /settings/social/telegram/. Если раздел недоступен, попросите администратора проверить права и версию CRM.

#Способ 1. Подключить Telegram-бота

  1. Откройте официального BotFather, отправьте /newbot, создайте бота и скопируйте токен.
  2. В настройках Telegram в CRM выберите добавление бота, введите название и токен, сохраните канал.
  3. Подключите бота: CRM настроит адрес получения новых сообщений.
  4. Из тестового аккаунта откройте бота, нажмите «Начать» или отправьте /start, затем обычное сообщение.
  5. Найдите диалог в разделе «Соцсети», ответьте и проверьте доставку в Telegram клиента.

#Способ 2. Подключить Telegram Business

  1. Сначала подключите бота к CRM по инструкции выше.
  2. В BotFather выберите бота и включите Bot Settings → Business Mode.
  3. В настройках аккаунта Telegram найдите подключение бизнес-бота, укажите его @username и разрешите отвечать в нужных чатах. Названия пунктов могут различаться между версиями приложения.
  4. Проверьте появление Business-канала в CRM. Сначала доступ наследуется от бота, поэтому сразу проверьте список сотрудников.
  5. Отправьте новое сообщение из тестового аккаунта в разрешённый чат и проверьте ответ из CRM.

Старая переписка Business не импортируется. Новые сообщения поступают после подключения; действуют права бота и правила Telegram. Согласно официальной документации, подключённые боты доступны и без Premium. Остальные бизнес-функции проверяйте отдельно.

#Способ 3. Подключить собственный номер по QR-коду

Сначала команда внедрения настраивает Telegram на сервере CRM. После этого вы входите в рабочий аккаунт как на новом устройстве. Используйте номер компании, к которому сохраните доступ.

  1. Добавьте собственный номер на странице Telegram в CRM и сохраните канал.
  2. Выберите вход по QR-коду. На телефоне откройте Telegram → Настройки → Устройства и подключение нового устройства, затем отсканируйте код из CRM.
  3. Если включена двухэтапная проверка, введите пароль в появившееся поле CRM.
  4. Если QR-код истёк, запросите новый. Можно перейти ко входу через код: CRM покажет, куда его отправил Telegram. Это не обязательно SMS.
  5. Убедитесь, что канал подключён. Отправьте сообщение из другого аккаунта и проверьте ответ из CRM.

#Настройте доступ и работу команды

  • Проверьте список сотрудников с доступом. Выполните проверку под аккаунтом менеджера, а не только администратора.
  • Настройте ответственного или автоматическое распределение новых разговоров.
  • При необходимости включите автоответ или AI-консультанта. Проверьте содержание ответа и передачу диалога человеку.
  • Убедитесь, что тестовый разговор связан с правильной карточкой заявки.

#Групповые чаты, реакции и удаление

У ботов и прямых номеров группы по умолчанию отключены. Включите их в настройках канала при необходимости. Каждая группа отображается отдельным разговором. Чтобы бот видел все сообщения, нужны соответствующие настройки Group Privacy в BotFather или права администратора группы.

  • AI-консультант и автоответ в группах не отвечают.
  • Реакции зависят от режима; в текущей реализации Business они не поддерживаются.
  • В режимах с событиями удаления сообщение остаётся в CRM с отметкой «Удалено в Telegram». Обычный бот не получает такие события.
  • Полное восстановление пропущенной истории не гарантируется. В частности, для прямого номера супергруппы после перезапуска шлюза не догружаются.

#Проверка перед началом работы

  1. Тестовое сообщение появилось в правильном канале CRM.
  2. Ответ менеджера дошёл от нужного бота или аккаунта.
  3. Тестовый файл можно получить и открыть.
  4. Сотрудник с разрешением видит канал, сотрудник без разрешения — нет.
  5. Разговор связан с правильной заявкой, распределение работает ожидаемо.
  6. Если включены AI или автоответ, они отдельно проверены в личном диалоге.

#Что делать, если Telegram не работает

ПроблемаЧто проверить
Нет сообщений у ботаНажал ли клиент «Начать», подключён ли бот, доступна ли CRM по HTTPS. Администратор проверяет webhook.
Сервис Telegram не запущенПопросите команду внедрения проверить telegram_gateway. Повторный ввод кода не исправит серверный модуль.
После QR нужен парольВведите пароль двухэтапной проверки, а не одноразовый код входа.
Не приходит кодПосмотрите подсказку о доставке и проверьте приложение Telegram. Используйте другой способ, если интерфейс его предлагает.
Business не отвечаетПроверьте права бота, разрешённые чаты и недавнее сообщение клиента. Старый диалог не означает, что ответ сейчас разрешён.
Менеджер не видит каналПроверьте доступ к каналу и права аккаунта CRM.
Telegram отклоняет сообщениеПрочитайте ошибку под сообщением. Повторная отправка не снимает ограничения аккаунта или получателя.

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