Как создать бота в Telegram через BotFather и подключить его к «Диалогам»

Бот в Телеграме создаётся у официального бота площадки — @BotFather. Модерации нет: бот появляется сразу, а подключить его к «Диалогам» можно в ту же минуту. Ниже — путь от пустого бота до первого ответа клиенту.

Для MAX порядок другой: бот заводится в бизнес-профиле организации и проходит модерацию. Об этом — в инструкции «Как создать бота в MAX для организации».

Шаг 1. Создать бота у @BotFather

1. Откройте @BotFather в Telegram. Проверьте, что у него синяя галочка: это официальный бот площадки.
2. Отправьте команду /newbot.
3. Введите отображаемое имя — его клиент увидит в заголовке переписки. Например, «Сервисный центр „Техника Плюс“».
4. Введите имя пользователя латиницей. Оно должно заканчиваться на bot, например tehnika_plus_bot. Занятое имя Telegram не примет — добавьте к нему город или слово help.

В ответ BotFather пришлёт ссылку на бота и токен — длинную строку из цифр и букв через двоеточие.

Шаг 2. Оформить карточку бота

Клиент видит карточку, когда впервые открывает бота, поэтому её стоит заполнить сразу. У @BotFather для этого есть команды:

• /setuserpic — картинка: логотип организации;
• /setdescription — текст, который клиент видит до первого сообщения: кто вы и с чем бот помогает;
• /setabouttext — короткая строка в профиле бота.

В отличие от MAX, правки карточки модерацию не проходят и видны сразу.

Шаг 3. Сохранить токен

Токен даёт полный доступ к боту: храните его как пароль и не пересылайте в общих чатах. В «Диалогах» он хранится зашифрованным. Если токен всё же ушёл наружу, отзовите его командой /revoke у @BotFather и замените в карточке канала кнопкой «Заменить токен». Удалять канал ради этого не нужно: вместе с ним удалится и переписка.

Шаг 4. Подключить бота к «Диалогам»

В «Диалогах» откройте раздел «Подключения», нажмите «Подключить Telegram», затем «Дальше: токен». Вставьте токен и нажмите «Подключить». Подписку на сообщения сервис оформит сам — адреса и серверы настраивать не нужно.

Проверка — первое сообщение: откройте бота по ссылке и отправьте /start. Когда сообщение дойдёт до «Диалогов», проверка в мастере закроется сама, а переписка появится в разделе «Чат».

Шаг 5. Привязать сценарий

Чтобы бот отвечал сам, в «Конструкторе» на карточке бота нажмите «Каналы» и отметьте канал Telegram. Сценарий должен быть опубликован. Без этого сообщения клиентов придут в «Чат», но ответят на них только операторы. Если у вас уже есть бот в MAX, отметьте оба канала: сценарий и база знаний не привязаны к мессенджеру.

Что важно знать

• Бот не пишет первым. Разговор начинает клиент, поэтому ссылку на бота размещают на сайте, в подписи письма и на стойке. Ссылку и QR-код можно взять в «Диалогах»: раздел «Подключения», кнопка «Ссылка и QR».
• Сообщения проходят через серверы Telegram, а они за рубежом. Переписка и данные клиентов в «Диалогах» хранятся в России, но сам мессенджер — зарубежный. Перед первым сбором персональных данных бот запрашивает согласие.
• Один бот — вся смена. С перепиской бота одновременно работают все операторы: каждый берёт свой диалог, коллеги видят, кто чем занят.

Если не работает

• Токен не принимается. Скопируйте его из ответа @BotFather целиком, без пробелов по краям. Если токен отзывали командой /revoke, нужен новый.
• Сообщение дошло до «Чата», а бот молчит. К каналу не привязан сценарий или он не опубликован — проверьте шаг 5.
• Проверка в мастере не закрывается. Сообщение нужно отправить именно тому боту, чей токен вставлен.