Текстовые шлюзы

1.Описание

Подключение к мессенджерам.

Состоит из таких элементов:

  1. Инструмент создания(Рис.1 (1));
  2. Поле поиска (Рис.1 (2));
  3. Инструмент обновления реестра записей (Рис.1 (3));
  4. Реестр записей (Рис.1 (4)) ;
  5. Пагинация (Рис.1 (5)).

Рис. 1. Страница "Текстовые шлюзы" 

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

1.1. Инструмент создания

Для создания нового текстового шлюза служит кнопка "Добавить" (Рис.1(1)), после  нажатия на которую открывается модальное окно "Новый текстовый шлюз" (Рис.2) в котором есть такие  варианты:

  • Telegram Бот;
  • Telegram Приложение;
  • Infobit;
  • Meta;
  • Viber;
  • Web chat;
  • Custom Chat Gateway.

После выбора и нажатии кнопки "Добавить" открывается деталь выбранного варианта.

Рис. 2. Модальное окно "Новый текстовый шлюз"

Для "Telegram Бот" доступы следующие детали:

Для "Telegram Приложение" доступы следующие детали:

Для "Infobit" доступы следующие детали:

Для "Meta" доступы следующие детали:

Для "Viber" доступы следующие детали:

Для "Web chat" доступы следующие детали:

Для "Custom Chat Gateway" доступы следующие детали:

1.2.Поле поиска

Поиск производится по колонке "Имя".

Состоит из поля ввода и кнопки закрытия (), которая отображается, когда в поле ввода установлен курсор.  Для поиска по части слова, или номера, используется символ "*". Можно использовать символ "*" и для замены любого количества символов.

1.3. Инструмент обновления реестра записей 

Обновление таблицы реестра записей выполняется нажатием на кнопку обновления -

 (Рис.1 (3)).

1.4. Реестр записей 

Реестр представляет собой список записей существующих объектов этого раздела, каждая из которых состоит из набора полей:

  1. Чекбокс;

  2. Колонка "Имя";

  3. Колонка "URI";

  4. Колонка "Схема";
  5. Колонка "Провайдер";
  6. Колонка "Состояние";
  7. Инструмент редактирования;
  8. Инструмент удаления.

Если на странице нет ни одной записи, то отображается дополнительная кнопка «Добавить», функционал которой дублирует кнопку «Добавить» в п. 1.1.

1.4.1. Чекбокс

Используется для выбора одной или нескольких записей объектов. После выбора одной или нескольких записей появляется дополнительный инструмент удаления. При наведении курсора на этот инструмент появляется информация о количестве выбранных для удаления записей.

1.4.2. Колонка "Имя"

Здесь отображаются название текстового шлюза. При нажатии на него открывается деталь данного текстового шлюза.

1.4.3. Колонка "URI"

Унифицированный идентификатор ресурсов — компактная строка букв, однозначно идентифицирующая отдельный абстрактный или физический ресурс. Задается при настройке текстового шлюза.

1.4.4. Колонка "Схема"

Здесь отображается схема, которая используется в данном текстовом шлюзе. Больше информации о схемах можно посмотреть здесь.

1.4.5. Колонка "Провайдер"

Здесь отображается эмблема выбранного мессенджера.

1.4.6. Колонка "Состояние"

Включает в себя переключатель, который отвечает за включение и отключения текстового шлюза, соответственно положению переключателя:

- текстовый шлюз включен;

- текстовый шлюз отключен.

1.4.7. Инструмент редактирования

Открывается нажатием на кнопку редактирования   при наведение курсором на которую отображается информация с названием инструмента. 

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

1.4.8. Инструмент удаления

Используется для удаления объекта с подтверждением через модальное окно. При наведении на кнопку удаления () отображается информация с названием инструмента.  После нажатия кнопки удаления появляется модальное окно с подтверждениемНажатие кнопки "Да" удаляет объект и запись о нем. Нажатие кнопки "Нет" закрывает модальное окно, объект не удаляется. 

Рис.3. Модальное окно подтверждения удаления 

1.5. Пагинация

Состоит из поля "Записей на странице", в котором указывается количество записей (возможно задать от 1 до 1000) на одну страницу и кнопок вперед  и назад  для переключения страниц. 

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

2.1. Создание нового текстового шлюза

Цель

Создать новый текстовый шлюз

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

Сценарий:


  1. Нажать кнопку "Добавить". Открывается модальное окно "Новый текстовый шлюз".
  2. Выбрать необходимый вариант.
  3. Нажать кнопку "Создать". Открывается страница детали соответственно выбранному мессенджеру.
  4. Внести данные в каждой из деталей (по необходимости).
  5. Нажать кнопку "Сохранить"

Результат

Данные сохранены. 

2.2. Удаление текстового шлюза

Цель

Удалить текстовый шлюз

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

Сценарий:


  1. Найти в реестре записей текстового шлюза, который необходимо удалить.
  2. Нажать на кнопку удаления - Открывается модальное окно для подтверждения удаления.
  3. Нажать кнопку "Да"

Результат

Модальное окно закрывается. Текстовый шлюз удален.

2.3. Удаление нескольких  текстовых шлюзов

Цель

Удалить несколько текстовый шлюзов

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

Сценарий:


  1. Найти в реестре записи текстовые шлюзы, которые необходимо удалить. Выбрать их с помощью чекбокса.
  2. Нажать на кнопку удаления вверху реестра записей. Открывается модальное окно для подтверждения удаления.
  3. Нажать кнопку "Да".

Результат

Модальное окно закрывается. Текстовые шлюзы удалены.

2.4. Редактирование текстового шлюза

Цель

Изменить параметры текстового шлюза

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

Сценарий:


  1. Найти в реестре записей текстового шлюза, которую необходимо редактировать.
  2. Нажать на кнопку редактирования в записи этой очереди. Открывается страница детали этого текстового шлюза.
  3. Открыть нужную деталь.
  4. Внести изменения.
  5. Нажать кнопку "Сохранить".

Результат

Данные сохранены.

2.5. Включение/отключение текстового шлюза

Цель

Включить текстовый шлюз

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

Сценарий:


  1. Найти в реестре записей очередь, которую необходимо включить.
  2. Перевести переключатель в колонке "Состояние" в активное положение.

Результат

Данные сохранены. Текстовый шлюз включен.

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

3.1. Бот на базе ChatGPT