Telegram Бот

1.Описание

Предназначено для настройки чата в мессенджере Telegram

Состоит из полей:

  1. Имя;
  2. Telegram BOT API Token;
  3. URI;
  4. Схема.

Рис. 1. Страница для настройки чата Telegram

1.1. Имя 

Предназначено для ввода имени, которое будет отображаться в реестре данных страницы "Текстовые шлюзы". 

1.2. Telegram BOT API Token

Для получения "Telegram BOT API Token" необходимо создания нового бота в Telegram. Для создания нового бота:

Откройте мессенджер Telegram, войдите в вашу учетную запись или создайте новую.

Шаг 1. Введите в поле поиска @BotFather и выберите бота (Рис. 2).

Рис. 2. Поиск  @BotFather

Обратите внимание, что у официального бота Telegram будет стоять синий подтверждающий знак возле имени в виде галочки.

Шаг 2. Нажмите «Запустить» для активации бота BotFather (Рис. 3).

Рис. 3. Активации бота BotFather

В ответ вы получите список команд по управлению ботов.

Шаг 3. Выберите или напечатайте и отправьте команду /newbot (Рис.4).

Рис. 4. Выбор команды  /newbot

Шаг 4. Дайте имя боту — клиенты увидят это имя при общении с ботом. И никнейм бота — по нему можно будет найти бота в Telegram. Никнейм должен быть уникальным, не повторять существующие в базе и заканчиваться на слово «bot» (Рис.5).

Рис. 5. Назначения имя бота и никнейма

После того как вы выберите подходящее имя бот будет создан. Вы получите сообщение со ссылкой на бота t.me/<никнейм_бота>, рекомендации по настройке аватарки, описание бота и список команд для настройки бота.

А также токен, который необходимо скопировать (Рис.6).

Рис. 6. Получения токена

Где найти ключ для уже существующего бота

Шаг 1. Перейдите к боту @BotFather и введите команду /token (Рис.7).

Рис. 7. Введение команды /token

Вы увидите кнопки с созданными ботами.

Шаг 2. Выберите бота, которого нужно подключить (Рис.8).

Рис. 8. Выбор бота

Скопируйте значение токена (Рис.9).

Рис. 9. Копирование токена

Одержанный токен вводим в поле "Telegram BOT API Token".

1.3. URI

Уникальный URI учетной записи. Генерируется автоматически. Используется внутри системы Webitel.

1.4. Схема

При нажатии на поле открывается выпадающий список с которого необходимо выбрать схему. По этой схеме будет работать чат. Если необходимой схемы нет, то используйте поле "Схема", как поле поиска. Как создать новую схему смотреть здесь

2. Возможности

2.1. Изменить, или задать, параметр Имя/Telegram BOT API Token/URI/Схема.

Цель

Изменить, или задать данные в поле  Имя/Telegram BOT API Token/URI/Схема.

Предусловия
  1. Доступ к приложению Admin;
  2. Доступ к разделу "Текстовые шлюзы" в приложении Admin;
  3. Разрешение на редактирование в разделе "Текстовые шлюзы";
  4.  Наличие минимум одного текстового шлюза для Telegram, или создание нового.

Сценарий:


  1. Нажать на поле, которое нужно изменить.
  2. Внести необходимые изменения.
  3. Нажать кнопку "Сохранить".
РезультатДанные сохранены. 

3. Дополнительные материалы

3.1. Инструкции

3.1.1. Подключаем Telegram Bot