Як підключити 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-бота
- Відкрийте офіційного BotFather у Telegram, надішліть
/newbotі створіть бота. Скопіюйте виданий токен. - На сторінці Telegram у CRM оберіть додавання бота, введіть назву та токен, збережіть канал.
- Натисніть «Підключити бота». CRM налаштує адресу отримання нових повідомлень.
- Із тестового акаунта відкрийте бота, натисніть «Почати» або надішліть
/start, а потім звичайне повідомлення. - Відкрийте розділ «Соцмережі» у CRM, знайдіть розмову й надішліть відповідь. Перевірте її в Telegram клієнта.
#Спосіб 2. Підключити Telegram Business
- Спочатку підключіть бота до CRM за кроками вище.
- У BotFather оберіть цього бота, відкрийте Bot Settings → Business Mode та ввімкніть бізнес-режим.
- У налаштуваннях Telegram акаунта знайдіть підключення чат-бота для бізнесу, вкажіть @username бота й дозвольте відповідати в потрібних чатах. Назви пунктів можуть відрізнятися між версіями застосунку.
- Перевірте появу Business-каналу в CRM. Перегляньте доступ: спочатку він успадковується від бота, тому одразу визначте потрібних співробітників.
- Надішліть нове повідомлення з тестового акаунта у дозволений чат та перевірте відповідь із CRM.
Стара переписка Business не імпортується. CRM отримує нові повідомлення після підключення; відповідати можна лише в межах прав бота та правил Telegram. Згідно з офіційною документацією 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 потрібен пароль | Введіть пароль двоетапної перевірки акаунта. Це не одноразовий код входу. |
| Не надходить код | Подивіться підказку CRM про спосіб доставки. Перевірте застосунок Telegram; скористайтеся іншим способом, якщо його пропонує інтерфейс. |
| Business не відповідає | Перевірте права бота, дозволені чати та наявність недавнього звернення клієнта. Старі чати не означають, що відповідь зараз дозволена. |
| Менеджер не бачить канал | Перевірте доступ до каналу й права облікового запису в CRM. |
| Telegram відхиляє вихідне повідомлення | Прочитайте помилку під повідомленням. Обмеження акаунта чи одержувача не знімаються повторним надсиланням із CRM. |
Якщо проблему не вдалося вирішити, передайте підтримці назву каналу, час перевірки й текст помилки. Токени, паролі та коди входу не додавайте до звичайного листування або скриншотів.
