Свой 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 ничего не доставит, и это не настраивается с нашей стороны.