Создание и настройка Телеграм-бота

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

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

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

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;

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Интеллект.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Идентификатор приложения для доступа к 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, который был получен при создании бота.
  

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

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

5. Выполните пробную отправку уведомления в разделе Управление ► Настройки программы ► Настройки, в блоке настроек CRM ► Уведомления ► Сервис отправки SMS с помощью опции Тестовое сообщение

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

Для получения входящих сообщений от контрагентов необходимо подключение к чату. Для этого:

1. Перейдите в раздел Управление ► Настройки программы ► Настройки, в группу настроек CRM ► Чат с клиентом и активируйте опцию Использовать чат с клиентом.

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

3. Запустите программу AutoИнтеллект и проверьте, что в окне программы применились настройки:

• в меню CRM появился раздел Чат;
• на нижней панели появилась кнопка Чат.

4. Перейдите в окно Чата и проверьте его работоспособность: появилась возможность обмениваться сообщениями с клиентами, которые подписаны на Telegram-бота.