К списку

Создание и настройка Telegram-бота

09
августа
2022
UDS-news


Для подключения Telegram-бота к программе AutoИнтеллект необходимо получить конфигурационные данные (идентификатор и хэш идентификатора) для подключения к API Telegram. А также создать бот и задать настройки его внешнего вида в приложении Telegram. 


Обратите внимание, что для отправки уведомлений с помощью бота необходима установка Сервера AutoИнтеллект. Подробнее о настройке сервера здесь.


Получение конфигурационных данных

1. Перейдите на сайт my.telegram.org.



Не обращайте внимания на надпись Delete your account. Удаления учетной записи после совершения последующих шагов не произойдет.

2. В поле Your Phone Number введите номер телефона, который зарегистрирован в Telegram. Данный номер в дальнейшем будет использован для регистрации на серверах API Telegram. Ввод номера осуществляется в международном формате (с +7).

3. Нажмите кнопку Next. На указанный номер будет направлен код подтверждения.


4. Введите код подтверждения в появившемся поле Confirmation code и нажмите на кнопку Sign In.


5. Авторизуйтесь на сайте my.telegram.org и выберите пункт API development tools. Укажите обязательные данные:

  • App title - полное название приложения.

  • Short name - короткое название приложения в цифро-буквенном формате. 

  • Platform - в перечне выбрать значение Desktop;

Прочие поля формы могут быть заполнены по необходимости. Поля App title, Short name и Description используются лишь для получения идентификатора и хэша, информация из полей не будет отображена.


6. Нажмите на кнопку Create application. В открывшемся окне App configuration отобразится информация для подключения к API, которую необходимо сохранить. В дальнейшем эти данные нужно будет внести в программу AutoИнтеллект:

  • App api_id - идентификатор приложения для доступа к API Telegram;

  • App api_hash - хэш идентификатора приложения для доступа к API Telegram.


Создание бота в Telegram

1. Перейдите в приложение Telegram и в строке Поиска введите BotFather.


2. Нажмите на кнопку start (появиться автоматически) и отправьте в чат команду /newbot для создания нового бота.


3. Далее отправьте название бота, которое будут видеть контрагенты и его имя, которое будет использовано для формирования ссылки. В ответном сообщении после создания будет написан токен бота, который нужно будет скопировать и подставить при вводе настроек подключения бота в AutoИнтеллект.


Поиск бота будет доступен как по названию, так и по ссылке. Название и имя могут быть идентичными. Обязательное условие при написании имени для ссылки – оно должно заканчиваться на bot.

Настройки внешнего вида бота

1. В чат BotFather отправьте команду /mybots и в ответном сообщении выберите бота, которого нужно отредактировать.


2. Выберите команду Edit Bot. В ответном сообщении отобразится перечень команд для визуального изменения разных частей интерфейса вашего бота;


  • Edit Name - имя, которое будет отображаться в списке диалогов и профиле бота;


  • Edit About - описание, которое будет отображаться в профиле бота;


  • Edit Description и Edit Description Picture - текст и картинка с описанием бота, которые будут показаны пользователю при первом открытии диалога с ботом;


Изображение для пункта Edit Description Picture должно соответствовать размеру: 640x360px. При выборе формата GIF, размер изображения должен быть: 320x180px.

  • Edit Botpic – изображение в профиле бота;


  • Edit Commands – добавление команд для работы с ботом. Настройка данного пункта не требуется.

Подписка на бота

1. Отправьте контрагентам название или ссылку на своего бота, чтобы они смогли его найти. Также можно разместить ссылку на бота на вашем сайте или в шаблонах уведомлений.

2. Перейдите по ссылке или найдите бота в поиске и нажмите на команду start

3. Отправьте свой контактный номер для связи (номер должен быть зарегистрирован в приложении Telegram).


Автоматические сообщения на запрос номера контрагента, которые бот отправляет после команды start, предустановлены в программе AutoИнтеллект и недоступны для редактирования.


На данный момент реализована только отправка сообщений через приложение Telegram. Т.е. получение входящих сообщений от контрагентов недоступно.

Подключение бота к программе

После того, как все этапы создания бота будут пройдены необходимо выполнить подключение бота в программе AutoИнтеллект. Далее можно будет использовать отправку уведомлений в приложении Telegram для взаимодействия с клиентами.

1. Перейдите в раздел Управление ► Настройки программы ► Настройки, группа настроек CRM ► Уведомления ► Сервис отправки sms и заполните данные на форме:

  • Использовать отправку сообщений - установить значение Использовать, чтобы активировать использование сервиса.

  • Сервис отправки сообщений - выберите значение Telegram Bot;

  • Идентификатор приложения для доступа к API Telegram - ввести значение из поля App api_id, которое было получено на сайте my.telegram.org;

  • Хэш идентификатора приложения для доступа к API Telegram - ввести значение из поля App api_hash, которое было получено на сайте my.telegram.org;

  • Токен аутентификации бота - ввести Api Token из поля Use this token to access the HTTP API, который был получен при создании бота;

  • Резервный способ отправки сообщений - настроить отправку сообщений через SMS-сервис, если отправка с помощью бота невозможна (например, клиент не подписан на бота);


2. Закройте раздел Настройки программы для сохранения изменений.

3. Проверьте состояние работоспособности Telegram-бота на панели в перечне индикаторов состояний. При корректной работе индикатор отображается зеленым цветом.

4. Выполните пробную отправку уведомления в разделе CRM ► Клиенты с помощью команды Связаться ► Отправить сообщение на панели инструментов.