Как подключить 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-бота
- Откройте официального BotFather, отправьте
/newbot, создайте бота и скопируйте токен. - В настройках Telegram в CRM выберите добавление бота, введите название и токен, сохраните канал.
- Подключите бота: CRM настроит адрес получения новых сообщений.
- Из тестового аккаунта откройте бота, нажмите «Начать» или отправьте
/start, затем обычное сообщение. - Найдите диалог в разделе «Соцсети», ответьте и проверьте доставку в Telegram клиента.
#Способ 2. Подключить Telegram Business
- Сначала подключите бота к CRM по инструкции выше.
- В BotFather выберите бота и включите Bot Settings → Business Mode.
- В настройках аккаунта Telegram найдите подключение бизнес-бота, укажите его @username и разрешите отвечать в нужных чатах. Названия пунктов могут различаться между версиями приложения.
- Проверьте появление Business-канала в CRM. Сначала доступ наследуется от бота, поэтому сразу проверьте список сотрудников.
- Отправьте новое сообщение из тестового аккаунта в разрешённый чат и проверьте ответ из CRM.
Старая переписка Business не импортируется. Новые сообщения поступают после подключения; действуют права бота и правила Telegram. Согласно официальной документации, подключённые боты доступны и без Premium. Остальные бизнес-функции проверяйте отдельно.
#Способ 3. Подключить собственный номер по QR-коду
Сначала команда внедрения настраивает Telegram на сервере CRM. После этого вы входите в рабочий аккаунт как на новом устройстве. Используйте номер компании, к которому сохраните доступ.
- Добавьте собственный номер на странице Telegram в CRM и сохраните канал.
- Выберите вход по QR-коду. На телефоне откройте Telegram → Настройки → Устройства и подключение нового устройства, затем отсканируйте код из CRM.
- Если включена двухэтапная проверка, введите пароль в появившееся поле CRM.
- Если QR-код истёк, запросите новый. Можно перейти ко входу через код: CRM покажет, куда его отправил Telegram. Это не обязательно SMS.
- Убедитесь, что канал подключён. Отправьте сообщение из другого аккаунта и проверьте ответ из CRM.
#Настройте доступ и работу команды
- Проверьте список сотрудников с доступом. Выполните проверку под аккаунтом менеджера, а не только администратора.
- Настройте ответственного или автоматическое распределение новых разговоров.
- При необходимости включите автоответ или AI-консультанта. Проверьте содержание ответа и передачу диалога человеку.
- Убедитесь, что тестовый разговор связан с правильной карточкой заявки.
#Групповые чаты, реакции и удаление
У ботов и прямых номеров группы по умолчанию отключены. Включите их в настройках канала при необходимости. Каждая группа отображается отдельным разговором. Чтобы бот видел все сообщения, нужны соответствующие настройки Group Privacy в BotFather или права администратора группы.
- AI-консультант и автоответ в группах не отвечают.
- Реакции зависят от режима; в текущей реализации Business они не поддерживаются.
- В режимах с событиями удаления сообщение остаётся в CRM с отметкой «Удалено в Telegram». Обычный бот не получает такие события.
- Полное восстановление пропущенной истории не гарантируется. В частности, для прямого номера супергруппы после перезапуска шлюза не догружаются.
#Проверка перед началом работы
- Тестовое сообщение появилось в правильном канале CRM.
- Ответ менеджера дошёл от нужного бота или аккаунта.
- Тестовый файл можно получить и открыть.
- Сотрудник с разрешением видит канал, сотрудник без разрешения — нет.
- Разговор связан с правильной заявкой, распределение работает ожидаемо.
- Если включены AI или автоответ, они отдельно проверены в личном диалоге.
#Что делать, если Telegram не работает
| Проблема | Что проверить |
|---|---|
| Нет сообщений у бота | Нажал ли клиент «Начать», подключён ли бот, доступна ли CRM по HTTPS. Администратор проверяет webhook. |
| Сервис Telegram не запущен | Попросите команду внедрения проверить telegram_gateway. Повторный ввод кода не исправит серверный модуль. |
| После QR нужен пароль | Введите пароль двухэтапной проверки, а не одноразовый код входа. |
| Не приходит код | Посмотрите подсказку о доставке и проверьте приложение Telegram. Используйте другой способ, если интерфейс его предлагает. |
| Business не отвечает | Проверьте права бота, разрешённые чаты и недавнее сообщение клиента. Старый диалог не означает, что ответ сейчас разрешён. |
| Менеджер не видит канал | Проверьте доступ к каналу и права аккаунта CRM. |
| Telegram отклоняет сообщение | Прочитайте ошибку под сообщением. Повторная отправка не снимает ограничения аккаунта или получателя. |
Если нужна помощь, передайте поддержке название канала, время проверки и текст ошибки. Не добавляйте токены, пароли и коды входа в обычную переписку или скриншоты.
