Інтеграція з Telegram

Сторінка «Налаштування → Месенджери» дозволяє підключити Telegram-бота для отримання повідомлень від клієнтів прямо в bims. Інтеграція реалізована через офіційне API Telegram, тому для підключення необхідно створити бота через @BotFather та отримати API token. Після підключення всі вхідні повідомлення автоматично створюють ліди в системі.

Терміни

• Telegram-бот — автоматизований акаунт у Telegram для прийому повідомлень від клієнтів
• BotFather — офіційний бот Telegram для створення та управління іншими ботами
• API token — унікальний ключ доступу для підключення бота до bims
• Username — унікальна назва бота в Telegram (закінчується на «bot»)
• Вебхук — автоматичне сповіщення від Telegram до bims про нові повідомлення
• Лід — вхідне звернення від клієнта, яке автоматично створюється з повідомлення Telegram

Крок 1: Створення Telegram-бота

Знайдіть BotFather

1. Відкрийте Telegram на будь-якому пристрої
2. У рядку пошуку введіть @BotFather
3. Оберіть бота з блакитним значком підтвердження
4. Або перейдіть за прямим посиланням: https://t.me/BotFather

Створіть нового бота

1. Натисніть кнопку Запустити (або введіть /start)
2. Введіть команду /newbot або оберіть її з меню
3. Введіть ім'я для бота — це назва, яку бачитимуть користувачі
   • Приклад: Best dresses shop або Ваш друг Екофуд
   • Ім'я можна змінити будь-коли через /setname
4. Введіть username для бота — унікальна назва для посилання
   • Вимоги: унікальність + закінчення «bot»
   • Приклад: MyShopBot, EcoFoodSupportBot
   • ⚠️ Важливо: username неможливо змінити після створення

Отримайте API token

1. Після створення BotFather надішле повідомлення з API token
2. Обов'язково збережіть токен у безпечному місці
3. Токен знадобиться для підключення бота до bims

Активуйте бота

1. Відкрийте вашого бота за посиланням з повідомлення
2. Або знайдіть бота через пошук за username
3. Натисніть кнопку Start для запуску бота

⚠️ Важливо: Бот може бути підключений лише до одного сервісу одночасно!

Крок 2: Налаштування бота в BotFather

Доступні команди налаштування

У @BotFather доступне меню для редагування параметрів бота:

Рекомендації з налаштування

• Фото профілю — додайте логотип компанії для впізнаваності
• Опис — вкажіть призначення бота та години роботи
• Команди — налаштуйте швидкі команди для зручності клієнтів

Крок 3: Підключення бота до bims

Відкрийте налаштування месенджерів

1. У bims перейдіть до Налаштування → Месенджери
2. Знайдіть картку Telegram
3. Натисніть кнопку «Підключити»

Введіть API token

1. У полі «API token» вставте токен, отриманий від BotFather
2. Натисніть кнопку «Перевірити» для перевірки валідності токена
3. Після успішної перевірки натисніть «Додати»

Підтвердіть підключення

1. Система налаштує вебхук для отримання повідомлень
2. Статус зміниться на «Підключено» з іконкою ✓
3. Бот готовий до прийому повідомлень від клієнтів

Перевірка підключення

Після завершення налаштування перевірте коректність інтеграції:

💡 Корисні поради

💡 Збережіть токен — API token є секретним ключем, не передавайте його третім особам та не публікуйте у відкритих джерелах.

💡 Унікальний username — обирайте username ретельно, оскільки змінити його після створення неможливо.

💡 Тестування — після підключення надішліть тестове повідомлення в бота для перевірки коректної роботи інтеграції.

💡 Один бот — один сервіс — якщо підключити бота до іншого сервісу, інтеграція з bims припиниться.

💡 Новий токен — якщо токен скомпрометовано, використайте команду /token у BotFather для створення нового.

Поширені проблеми

📞 Підтримка

Якщо виникли труднощі під час налаштування:

• Перевірте всі кроки — переконайтеся, що виконані всі 3 кроки інструкції
• Оновіть сторінку — іноді допомагає оновлення сторінки налаштувань
• Зверніться до підтримки — створіть запит через розділ Допомога або напишіть на support@bims.com.ua