Власний Telegram-бот салону: підключаємо покроково

Нагадування клієнтам у BeeSection працюють з першого дня, і для них нічого підключати не потрібно: їх надсилає наш бот. Власний бот — це інша задача. Він потрібен, коли салон хоче переписуватися з клієнтами в Telegram від свого імені й тримати цю переписку в CRM, а не в чужому телефоні.

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

Крок 1. Створити бота в BotFather

1. Відкрийте в Telegram чат із @BotFather — це офіційний бот Telegram для створення ботів.
2. Надішліть команду /newbot.
3. Введіть відображуване ім’я — його побачить клієнт: «Салон Beauty Line».
4. Введіть ім’я користувача — латиницею, обов’язково закінчується на bot: beautyline_salon_bot. Якщо зайняте, BotFather попросить інше.
5. У відповідь прийде токен — довгий рядок на зразок 7788899911:AAH.... Це пароль від бота: хто його знає, той і бот.

Заодно варто відразу задати ботові аватар і опис (/setuserpic, /setdescription) — це те, що клієнт бачить до першого повідомлення.

Крок 2. Вставити токен у CRM

1. «Налаштування → Інтеграції», знайдіть Telegram.
2. Вставте токен у поле «Токен бота».
3. Натисніть «Перевірити зв’язок». Перевірка питає в Telegram, чий це токен, і повертає ім’я бота. Помилка тут означає, що токен скопійовано не повністю або вже відкликано.
4. Увімкніть інтеграцію.

Ім’я користувача бота окремо вводити не потрібно — ми питаємо його в Telegram самі, щоб воно не розійшлося з дійсністю.

Вебхук ставиться автоматично при увімкненні: адреса, на яку Telegram надсилатиме повідомлення, і секретний ключ створюються самі. Якщо щось пішло не так, у розділі є кнопки «Налаштувати webhook», «Перевірити webhook» та «Інформація про бота» — остання показує, що Telegram думає про ваше налаштування.

Токен після збереження маскується: видно останні чотири символи. Якщо токен витік — відкличте його в BotFather командою /revoke, отримайте новий і вставте знову.

Крок 3. Автовідповідь

Автовідповідь увімкнена за замовчуванням: клієнт, який написав ботові першим, відразу отримує відповідь, а не тишу. Текст можна змінити, у ньому доступна підстановка імені клієнта, формат — звичайний текст із розміткою Telegram. Якщо розмітка неправильна, налаштування не збережуться: зламану розмітку Telegram не покаже взагалі, і ви дізналися б про це від клієнта.

Що бот вміє після підключення

• Чати з клієнтами. Повідомлення приходять у розділ чатів і прив’язуються до картки клієнта; переписка одна на клієнта, а не на пристрій адміністратора. Розділ чатів входить у тариф Salon.
• Канал нагадувань. Власного бота можна поставити у список каналів нагадувань — тоді клієнт отримає нагадування від імені вашого салону, а не від нашого бота.
• Розсилки. У каскаді каналів розсилки Telegram стоїть першим, і власний бот — це саме він.
• Повідомлення співробітникам. Співробітник прив’язує свій Telegram до бота одноразовим кодом: посилання живе 15 хвилин і згорає після використання. Далі йому приходять повідомлення за правилами, які ви налаштуєте.
• Повідомлення щодо документів. Якщо ви користуєтеся ЕДО, події щодо документів теж ідуть через бота салону.
• Джерело заявок. Звернення з бота позначається джерелом, тому у звітах видно, скільки клієнтів прийшло з Telegram.

Безпека

Telegram надсилає нам повідомлення на адресу, яку знаємо тільки ми і він. До кожного запиту додається секретний ключ, створений під час підключення, і запит без правильного ключа відкидається. Для старих інтеграцій, у яких ключа ще немає, перевіряються адреси серверів Telegram — але ключ надійніший, і його варто створити кнопкою «Налаштувати webhook».

Якщо бот мовчить

• Перевірте зв’язок. Помилка перевірки — це токен, а не бот.
• Подивіться «Інформація про webhook». Порожня адреса означає, що Telegram не знає, куди надсилати повідомлення: натисніть «Налаштувати webhook».
• Напишіть ботові самі зі свого телефона. Повідомлення має з’явитися в чатах протягом секунд.
• Перевірте, що бота не заблокував клієнт. Заблокованому ботові Telegram нічого не доставить, і це не налаштовується з нашого боку.