Telegram-бот

1. Создание Telegram-бота

Для создания бота необходимо в телеграм найти аккаунт @BotFather.

Далее ему необходимо прописать следующие команды:
image-1678781088675.png

Красная команда - создание нового бота;
Зеленая команда - Имя бота, которое будет отображаться пользователю;
Желтая команда  - Логин бота для поиска в телеграм.

Синий прямоугольник с белой заливкой - место, в котором будет находится токен доступа к боту. Его нужно будет ввести в СУЛ. 

2. Ввод токена Telegram-бота

Для установки токена у пользователя должна быть роль ул_ДобавлениеИзменениеНастроек или ПолныеПрава. 
Для работы бота так же необходимо установить двухфакторную аутентификацию.

Чтобы настроить токен бота необходимо слева в меню нажать "Настройки".

image-1677588341946.png

Затем перейти в настройки поведения сервиса.

image-1677588386368.png

В переключателе вверху страницы выбрать "SMS, Email, Push, Telegram", а затем опустится вниз страницы. Нужная настройка называется "Токен доступа к Telegram-боту".

image-1678782232432.png

Работать бот может начать не сразу. Возможно придется подождать 10 - 15 минут.

 

3. Настройка Telegram-бота

Подготовка к настройке

Для настройки работы бота у пользователя должна быть роль ул_ДобавлениеИзменениеНастроекТелеграм или ПолныеПрава.

После обновления настроек их применение может произойти не сразу.  Возможно придется подождать 10 - 15 минут.

Раздел настроек

Чтобы перейти к форме настроек в меню слева необходимо нажать "Коммуникации".

image-1677588768348.png

В открывшейся форме нажать раздел "Чат боты".

image-1709647346557.png

Описание настроек

В открывшейся форме расположены настройки телеграм и вк ботов. Первые 5 настроек относятся и к телеграм и к вк боту.

Общие настройки:

- Флаг "Показывать раздел "Описание акций" отвечает за отображение введенных акций в настройках;

- Реквизит "Представление штрихкода карты" отвечает за формат отображения штрихкода;

- Флаг "Показывать раздел "Оценить сервис" отвечает за отправку показ раздела с оценкой сервиса пользователю;

- Флаг "Отображать правила бонусной программы" отвечает за отправку пользователю правил, введенных в реквизит "Правила бонусной программы";

- Флаг "Отображать представление карты" отвечает за отображение штрихкода карты (в Telegram) на фоне выбранной в реквизите "Изображение представления карты" картинки;

- Реквизит "Шаблон отображения карты Telegram-ботом" настраивается с помощью текста и параметров, которые выбираются в подменю справа (Параметры шаблона).

image-1709647984241.png

Настройки, относящиеся только к телеграм боту:

- Флаг "Запретить копирование в чат - боте" запрещает копирование сообщение в чате с телеграм ботом;

- Таблица список и порядок данных. С ее помощью настраивается список и порядок данных, которые будут необходимы при регистрации пользователя через Telegram.

image-1709648099712.png

 

4. Обзор Telegram-бота

После всех проведенных настроек переходим в бота.

Сразу будет отображаться окно авторизации. 

image-1678782347819.png

Для авторизации необходимо ввести почту или телефон (смотря что установлено в настройках СУЛ), а затем код подтверждения.

image-1678782462228.png

После этого становятся доступны функции бота в Reply-клавиатуре.

telegram1.jpg

1) Правила бонусной программы - настройка которая заполняется на вкладке "Коммуникации - Telegram"
- Представление в телеграм:

image-1678800080047.png
- Настройка в СУЛ:image-1678800138607.png

2) Описание карты - настройка которая заполняется на вкладке "Коммуникации - Telegram"
- Представление в телеграм:

image-1678800549284.png- Настройка в СУЛ:

image-1678800569861.png


3) Штрих-код карты - настройка, представление которой заполняется на вкладке "Коммуникации - Telegram"
- Представление в телеграм:

image-1678800608101.png- Настройка в СУЛ:

image-1678800629366.png

4) Оценить сервис - позволяет выставить оценку по пятибальной шкале от 1 до 5 и написать отзыв.

telegram2.jpg

После выбора оценки из Inline-клавиатуры необходимо ввести текст отзыва:

telegram3.jpg

 

 

5. Отправка данных в Telegram

В СУЛ Телеграм в качестве канала отправки оповещений могут использовать:

1). События. 

Для этого в форме элемента События необходимо перейти на страницу "Оповещения", установить флажок "Телеграм" и выбрать нужный шаблон оповещения:

image-1687270062710.png

2) Сценарии.

Из сценария отправка данных в Телеграм организована из узла с типом "Действие".

В форме узла необходимо добавить действие "Отправка Telegram". В качестве параметров используется следующие поля: "Значение" -  здесь можно ввести произвольный текст, который будет отправлен в Telegram.

"Шаблон" -  здесь можно выбрать предварительно подготовленный шаблон оповещения.

image-1687271058359.png

Поле "Значение" имеет более высокий приоритет над "Шаблон", то есть при если будут заполнены оба поля, то будет отправлен текст из поля "Значение".

 

1. Создание Telegram-бота

Для создания бота необходимо в телеграм найти аккаунт @BotFather.

Далее ему необходимо прописать следующие команды:
image-1678781088675.png

Красная команда - создание нового бота;
Зеленая команда - Имя бота, которое будет отображаться пользователю;
Желтая команда  - Логин бота для поиска в телеграм.

Синий прямоугольник с белой заливкой - место, в котором будет находится токен доступа к боту. Его нужно будет ввести в СУЛ.