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

Оберіть спосіб підключення, додайте канал, налаштуйте доступ менеджерів і перевірте першу розмову.

Ця інструкція допоможе налаштувати Telegram і перевірити, що менеджери можуть отримувати повідомлення та відповідати з CRM. Якщо ви ще обираєте між ботом, Business і номером компанії, спочатку перегляньте порівняння способів підключення.

#Що підготувати

  • Доступ до налаштувань інтеграцій у вашій CRM і список співробітників, яким потрібен канал.
  • Для бота — токен від BotFather і доступна через HTTPS адреса CRM.
  • Для Business — підключений бот із бізнес-режимом і доступ до налаштувань акаунта Telegram.
  • Для прямого номера — телефон із Telegram та, якщо встановлено, пароль двоетапної перевірки. Команда впровадження має заздалегідь налаштувати серверний модуль.
  • Для E-chat — окремий кабінет провайдера. Цей спосіб описаний в інструкції E-chat.

У CRM відкрийте налаштування Telegram: «Інтеграції → Соцмережі → Telegram». Адреса сторінки у вашій інсталяції — /settings/social/telegram/. Якщо розділ недоступний, зверніться до адміністратора щодо прав і версії CRM.

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

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

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

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

Стара переписка Business не імпортується. CRM отримує нові повідомлення після підключення; відповідати можна лише в межах прав бота та правил Telegram. Згідно з офіційною документацією 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 потрібен парольВведіть пароль двоетапної перевірки акаунта. Це не одноразовий код входу.
Не надходить кодПодивіться підказку CRM про спосіб доставки. Перевірте застосунок Telegram; скористайтеся іншим способом, якщо його пропонує інтерфейс.
Business не відповідаєПеревірте права бота, дозволені чати та наявність недавнього звернення клієнта. Старі чати не означають, що відповідь зараз дозволена.
Менеджер не бачить каналПеревірте доступ до каналу й права облікового запису в CRM.
Telegram відхиляє вихідне повідомленняПрочитайте помилку під повідомленням. Обмеження акаунта чи одержувача не знімаються повторним надсиланням із CRM.

Якщо проблему не вдалося вирішити, передайте підтримці назву каналу, час перевірки й текст помилки. Токени, паролі та коди входу не додавайте до звичайного листування або скриншотів.