В даному розділі надається можливість вносити додаткові налаштування до системи чат-боту. 

Щоб обрати необхідний розділ, потрібно натиснути Чат-бот – Налаштування.

Доступні налаштування наступних елементів: 

  1. Месенджери;
  2. Псевдоніми кроку;
  3. Крок мудьтимедіа;
  4. Логи месенджера;
  5. Чати;
  6. Скорочені відповіді;
  7. Сповіщення;
  8. По зовнішній події.

 

1. Месенджери. 

Щоб перейти до розділу «Месенджери» необхідно відкрити «Чат-бот – Налаштування – Псевдоніми кроку».

В даному розділі користувач здійснює налаштування всіх каналів зв’язку, месенджерів, за допомогою яких буде виконуватись функція комунікації з клієнтом. 

Детальна інструкція як вірно налаштувати канал зв’язку на прикладі Viber каналу показана в розділі «Налаштування месенджера.»

2. Псевдоніми кроку.

Щоб перейти до розділу «Псевдоніми кроку» необхідно відкрити «Чат-бот – Налаштування – Псевдоніми кроку».

В даному розділі знаходиться список всіх псевдонімів до кроків, які були створені при побудові діалогу в клієнтському чаті. Кожен псевдонім створюється автоматично при збережені кроку і оновлюється автоматично з оновленням кроку. Не потребує додаткових маніпуляцій зі сторони користувача. Несе інформаційний характер.


3. Крок мудьтимедіа.

Щоб перейти до розділу «Кроки медіа» необхідно відкрити «Чат-бот – Налаштування – Кроки медіа».

В даному розділі знаходиться список всіх кроків, до яких було додано медіа файли при побудові діалогу в клієнтському чаті. Кожен запис створюється автоматично при збережені кроку і оновлюється автоматично з оновленням кроку. Не потребує додаткових маніпуляцій зі сторони користувача. Несе інформаційний характер.

4. Логи месенджера.

В системі відбувається логування всіх дій, які виконуються під час комунікації. Це надає змогу при необхідності проаналізувати помилки і збої в системі комунікації.

Щоб перейти до розділу «Логи месенджеру» необхідно відкрити «Чат-бот – Налаштування – Логи месенджеру».


5. Чати.

В даному розділі розміщений список всіх чат-ботів, які працюють в системі. Щоб перейти до розділу «Чати» необхідно відкрити «Чат-бот – Налаштування – Чати». 



Натиснувши на запис чат-боту користувач переходить на форму налаштування цього боту. 


В полі «Месенджер» в випадаючому списку обираємо наш месенджер, через який буде відбуватись спілкування з клієнтом. В даному випадку, це буде ViberBot.

В полі «Діалог» по замовчуванню обрано клієнтський чат.  Обираємо той чат-бот, до якого  має приєднуватись месенджер.  У вас в системі може бути необмежена кількість чат-ботів з різною варіацією кроків, які будуть працювати з різними чат-ботами в Viber.

«Надсилати ім’я оператора» - якщо функція увімкнена, то клієнту буде надсилатись повідомлення, наприклад, «Юлія приєдналась до чату», в момент приєднання оператора до чату клієнта. Щоб в діалогах не відображалось ім’я оператора, необхідно вимкнути даний функціонал. По замовчуванню чек-бокс не встановлено. 

«Є автоматичне надсилання повідомлення» - якщо функція увімкнена, то клієнту буде надсилатись повідомлення про приєднання оператора до чату і можливість завершити діалог з налаштувань чат-боту. Наприклад, «Оператор Юлія приєднався до чату. Щоб завершити розмову, натисніть /end». 

«Is Send End Consultation» - якщо функція увімкнена, то після завершення консультації користувачу надсилається повідомлення про завершення діалогу з налаштувань чат-боту.

Нам необхідно в поле «Токен Viber» вставити наш скопійований токен для боту. Після цього натиснути кнопку «Оновити Hook».


Якщо на сервері знаходиться декілька баз і адреса сервера відрізняється від адреси бази чат-ботів,  необхідно увімкнути режим розробника та указати адресу бази, з якою працюємо:


Після цього натиснути кнопку «Оновити hook».


6. Скорочені відповіді.

В чат-боті для підвищення ефективності та швидкості відповідей надається можливість використовувати заготовлені повідомлення. Щоб перейти до розділу налаштування заготовлених повідомлень необхідно відкрити «Чат-бот – Налаштування –Скорочені відповіді».

Щоб додати нове скорочення, потрібно натиснути кнопку «Створити»:

В новому рядку ввести скорочену назву повідомлення. В поле «Заміна» ввести текст повідомлення. 

Щоб визвати скорочення з консультаційного чату, необхідно в полі вводу повідомлення натиснути «:». Оператору відображається список всіх заготовлених відповідей. Якщо почати вводити назву скорочення, в списку залишаться лише ті повідомлення, які відповідають значенням фільтра. 




7. Сповіщення по події в Odoo.

Сповіщення досить об’ємна та важлива функціональність чат-бота. Вона дозволяє створювати та розсилати повідомлення підписникам бота при внесені певних змін в базу даних.

Сповіщення спрацьовує, якщо в налаштуваннях поля тригер вказані наступні значення: 

  • При створені – сповіщення спрацьовує при створені нового запису в базі;
  • При зміні – сповіщення спрацьовує на зміну запису в базі;
  • При створені і зміні – сповіщення спрацьовує на створення нового запису та зміну вже існуючого;
  • При видалені –сповіщення спрацьовує при видалені запису з бази даних;
  • На основі часових умов – сповіщення спрацьовує в налаштовані часові проміжки часу.

Якщо тригер спрацьовує по зовнішній події, сповіщення потрібно створювати в розділі «По зовнішній події». 

Якщо тригером являється подія в системі Odoo, то сповіщення створюємо в розділі «Сповіщення».

Щоб перейти до розділу «Сповіщення» необхідно відкрити «Чат-бот – Налаштування –Сповіщення».

Обов’язковими для заповнення полями є: 

  • Назва сповіщення, 
  • Бот;
  • Модель;
  • Тригер;
  • Повідомлення. 

Данна функціональність надає можливість створювати повідомлення а також опрацьовувати запити до бази даних по бажанням абонентів. 

7.1. Загальна інформація створення сповіщень.

Щоб створити сповіщення необхідно перейти в меню налаштувань чат-боту в розділ «Сповіщення»:

Натиснути кнопку «Створити»: 

Вносимо в поле «Назва» назву сповіщення. Наприклад, це буде сповіщення, яке сповіщатиме користувача, що для нього створена нова задача. Назвемо сповіщення «Створено нову задачу». 

Поле «Бот» - випадаючий список налаштованих в системі чат-ботів. В цьому полі ми задаємо значення підписникам якого саме боту ми будемо надсилати повідомлення. Одне сповіщення працює тільки для одного чат-боту. Неможливо обрати декілька чат-ботів. Також можна зробити окремий чат-бот для сповіщень.

Перемикач «Активний» - дозволяє включити/виключити сповіщення для роботи. Перемикач «Активний» перемикаємо в активну позицію в саму останню чергу, після закінчення всіх налаштувань.

Перемикач «Додати URL-адресу» дозволяє в текст сповіщення додати кнопку, для переходу по посиланню посилання, по якому користувач зможе перейти на потрібну сторінку сайту. Наприклад посилання на задачу, яку біло створено для користувача боту.

По замовчуванню посилання створюється в форматі: 

https://chatbot-demo.kitworks.systems/web#id=X&model=sale.order&view_type=form&cids=X

Перехід по даному посиланню виглядає наступним чином: 

Можна замість використання стандартного функціоналу генерування URL  в сповіщенні додавати  посилання на необхідну сторінку в самому сповіщенні. 

Для цього  в налаштуваннях  вмикаємо режим розробника і в поле «Url в режимі розробника» додаємо шаблон нової  адреси. Щоб створити шаблон нової адреси копіюємо  посилання на меню, куди має перенаправлятись користувач. Наприклад:  

https://chatbot-demo.kitworks.systems/web#id=X&menu_id=383&action=609&model=sale.order&view_type=form

В повідомлення сповіщення додаємо посилання, але робимо заміну статичного номера ID на змінну в форматі ${object.id}, щоб переходило на запис з чат-боту наступним чином: 

https://chatbot.ct123.kitworks.systems/web#id=${object.id}&action=362&model=stock.picking&view_type=form&cids=&menu_id=224

В полі «Назва URL»  задається назва кнопки. По замовчуванню назва «Link».

Вигляд налаштованої кнопки в чат-боті: 


Перемикач «Персоналізований діалог» - можемо обирати визначеного користувача і відправляти повідомлення тільки йому. Після переведення перемикача в активний стан, з’являється додаткове поле «Особиста розмова», яке доступне для редагування. В ньому можна задати один або декілька користувачів, для яких буде спрацьовувати дане сповіщення: 

Чек-бокс «Обраний партнер» - дозволяє розсилати повідомлення партнерам, які визначені в полі «Партнер» вікна налаштування сповіщень. Якщо перемикач знаходиться вимкненим, поле «Партнер» недоступне для редагування. 

Працює або перемикач «Персоналізований діалог», або «Обраний партнер». Якщо обидва перемикачі вимкнені, то в полі «Всі діалоги» відображає список клієнтів, яким буде надсилатись повідомлення, якщо не задано обмеження на список партнерів чи користувачів.

Поле «Модель» дозволяє вказати з якою саме моделлю даних працює це сповіщення. 

В випадаючому списку моделей відображається сім перших значень з довідника. Щоб продовжити пошук, можна натиснути кнопку «Шукати ще…» або розпочати вводити назву моделі і в списку відобразяться всі відповідні фільтру значення. 

Поле «Тригер» - випадаючий список, який дозволяє обрати на зміну яких саме полів реагує і виконується сповіщення користувача. 

В системі налаштовані наступні види тригерів: 

  • При створені – сповіщення спрацьовує при створені нового запису в базі;
  • При зміні – сповіщення спрацьовує на зміну запису в базі;
  • При створені і зміні – сповіщення спрацьовує на створення нового запису та зміну вже існуючого;
  • При видалені –сповіщення спрацьовує при видалені запису з бази даних;
  • На основі часових умов – сповіщення спрацьовує в обмежені часові проміжки часу;
  • По зовнішній події – сповіщення спрацьовує при виклику певної зовнішньої події, наприклад, натискання відповідної кнопки в чат-боті. 

В даному розділі створюються сповіщення для всіх типів, окрім «По зовнішній події». В залежності від типу тригера змінюється набір полів, необхідних для заповнення. Розглянемо більш детально:

При використані типів «На оновлення» та «На створення та оновлення» потрібно додатково в полі «Поля тригеру» указати поля, при зміні яких відпрацьовує тригер і користувач отримує повідомлення в чат-боті.

При використані типу «На основі часових умов» в додаткових налаштуваннях приймають участь поля:

  • «Дата тригеру» - вказується поле, в якому налаштовано час відпрацювання сповіщення;
  • «Затримка після дати запуску» - дозволяє налаштувати через скільки годин з часу настання дати тригеру відпрацьовує подія. Якщо значення з мінусом, наприклад -10 хв, то сповіщення спрацює  за 10  хв до настання дати тригеру. Якщо значення з плюсом, наприклад, 10 хв, то спрацює через 10 хв після того, як настала Дата тригеру. 

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

По замовчуванню в полі «Домени Рівень всіх записів» стоїть фільтр, який повертає всі записи системи. Щоб налаштувати додаткові фільтри, необхідно натиснути на кнопку «Редагувати домен». 

У новому вікні редагування домену потрібно натиснути кнопку «Додати фільтр»:

Наприклад, ми бажаємо, щоб повідомлення надсилались для проектів конкретного керівника. В першому полі обрати назву поля моделі, по якому будемо здійснювати фільтрація. Наприклад, це буде поле «Керівник проекту». Значення можна знайти в випадаючому списку користуючись скролом або почати вводити в пошуковому рядку і обрати з значень, які будуть відповідати вашому фільтру. 

В другому полі обрати умову, яка буде накладатися на обране поле моделі. Якщо обрана «Вказано» чи «Не вказано», то ніяких додаткових значень для фільтрації не потрібно вносити. Якщо обрана функція не відповідає значенням «Вказано» чи «Не вказано», то ввести значення в третє поле:

Редактор дозволяє налаштовувати багатоступінчату структуру фільтрації. Наприклад, до фільтрації по керівнику проєкту, ми можемо додати фільтр по даті завершення проекту. Для цього натискаємо «+», в новому рядку по аналогії шукаємо необхідне значення, налаштовуємо фільтр, де, наприклад, дата завершення після 16 березня. 

Після завершення зберігаємо налаштування натиснувши на кнопку «Зберегти». Наш фільтр відразу застосовується до обраної моделі даних і відображається кількість записів, які відповідають умовам.


Поле «Тип повідомлення» дозволяє обрати яким саме чином буде будуватися відповідь абоненту в чат-боті:

  • Необроблене повідомлення – текстовий рядок; 
  • Конструктор повідомлення – конструктор значень полів моделі даних. 

Якщо нам потрібно клієнту надіслати інформаційне повідомлення про зміну статусу його замовлення довільної текстової структури, то має сенс використати тип повідомлення «Необроблене повідомлення». 

В полі «Необроблене повідомлення» вводимо наше текстове повідомлення та поля моделі, дані яких повинні відобразитись в сповіщенні абонента. Щоб в повідомлені відображалось коректне значення, а не назва поля, його необхідно заключити в подвійні фігурні дужки: {{ object.body }}.Текст повідомлення буде виглядати наступним чином: 

Вкладка «Шаблон не знайшов записів» - містить відповідь, яку отримує користувач, якщо з певних причин неможливо виконати сповіщення. По замовчуванню стоїть стандартна відповідь: «Sorry, I don't understand you».Текст відповіді можливо змінити. 

Якщо ж сповіщення потребує виводити повідомлення в певному форматі, наприклад, назва проекту, назва задачі, текст задачі, відповідальний по задачі та кінцева дата, то використовуємо конструктор повідомлень. 

В полі «Генерувати номер для рядка повідомлення» можливо ввімкнути нумерований список для рядків відповіді. Якщо перемикач неактивний, то рядки виводяться без додаткової нумерації.

Конструктор містить в собі наступні поля: 

Поле «Текст до» - текст, який відображається перед указаним полем. Наприклад, «Проект:» перед назвою проекту;

Поле «Новий рядок після тексту» - чек-бокс, який дозволяє при необхідності установити перенос на наступний рядок;

Поле «Поля по замовчуванню» - поля, значення яких має відобразитись в повідомлені чат-боту. Наприклад, проект;

Поле «Підполя» - виводить значення дочірнього поля для поля «Поля по замовчуванню». Наприклад, поле проект це код і потрібно вивести по коду його назву для відображення;

Поле «Текст після» - текст, який відображається після значення поля;

Поле «Частина повідомлення» - системне поле, заповнюється після збереження сповіщення. Містить в собі шаблон, як буде відображатись весь рядок разом. 

Після завершення всіх налаштувань натиснути кнопку «Зберегти», щоб зберегти та застосувати налаштування.–Приклад сповіщення при створені нової задачі.

7.2. Приклад сповіщення при створені нової задачі. 

Потрібно створити сповіщення, яке буде надсилатися всім відповідальним по задачі, якщо задача новостворена або були внесені зміни відповідального по вже створеній задачі. 

Наприклад, ми хочемо отримувати сповіщення у вигляді: 

Вам призначили задачу REQ 2478-64

Створив задачу: Іванов Микита Серафимович

Зміст задачі: Необхідно зробити переадресацію замовлення S000012 з Нова пошта, Київ, відділення №15 на відділення №10.

Дата виконання: 13.03.2023

Виконавці: Сидоренко Василь


Заходимо в Чат-бот - Налаштування – Сповіщення. Натискаємо кнопку «Створити».

В поле «Назва» вводимо назву сповіщення «Створено нову задачу».

Вмикаємо перемикач «Додати URL-адресу», щоб користувач швидко міг перейти на потрібну йому задачу.

Так як сповіщення повинні отримувати не всі користувачі, а тільки ті, які є відповідальними по задачі, то необхідно обрати модель та обмежити партнера. 

Для цього вмикаємо перемикач «Обраний партнер» та в полі «Партнер» вказуємо поле з моделі Завдання – Уповноважені. 

В полі «Тригер» встановлюємо значення «На створення та оновлення». Якщо необхідно, щоб спрацьовувало тільки на новостворені задачі, то обираємо просто «На створення». 

В полі «Поля тригеру» обираємо поле моделі Завдання – Відповідальний користувач, Уповноважені.

Для створення кінцевого повідомлення користувачу використовуємо конструктор повідомлень. 

В полі «Тип повідомлення» обираємо тип «Конструктор повідомлення». 

В полі «Дизайнер повідомлень» відображується шаблон кінцевого повідомлення користувачу після додавання всіх необхідних полів.

Таблицю «Дизайнер повідомлень» налаштовуємо наступним чином: 

Поле «Текст до» може залишатися пустим. В нашому прикладі вводимо в поле значення «Вам призначили задачу». В полі «Поля по замовчуванню» обираємо поле, в якому зберігається назва задачі - «Відобразити назву (project.task)». 

Якщо ви не знаєте яке саме поле вам потрібно використовувати, там потрібно перейти в модуль, з яким працюємо. Ввімкнути редагування задачі і подивитися як називається поле, якщо його назва не задана як, наприклад, у поля проект: 

Подібним чином задаємо всі необхідні для повідомлення поля.

Після внесення всіх налаштувань ввімкнути перемикач «Активний»:



7.3. Приклад сповіщення при оновлені статусу замовлення на продаж.

Потрібно створити сповіщення, яке буде надсилатися всім партнерам та підписникам задачі повідомлення при додаванні нової інформації до задачі.. 

Наприклад, ми бажаємо отримувати сповіщення у вигляді: 

В задачі з’явився новий коментар.

Текст коментаря: {{object.body}}

Задача: посилання на задачу.

Заходимо в Чат-бот - Налаштування – Сповіщення. Натискаємо кнопку «Створити».

В поле «Назва» вводимо назву сповіщення «Нові коментарі в задачі».

Вмикаємо перемикач «Додати URL-адресу», щоб користувач швидко міг перейти на потрібну йому задачу. Посилання на задачу буде додаватись внизу повідомлення.

В полі «Бот» обираємо чат-бот, для якого буде спрацьовувати сповіщення:

Так як сповіщення повинні отримувати не всі користувачі, а тільки ті, які є партнерами або підписники по задачі, то необхідно обрати модель та обмежити партнера. 

Так як нам потрібно відслідковувати появи нових повідомлень, то в полі «Модель» обираємо «Повідомлення» і тригер буде спрацьовувати на створення нового повідомлення.

Вмикаємо перемикач «Обраний партнер» та в полі «Партнер» вказуємо поле з моделі Повідомлення – Партнер, що потребує дії, для якого буде надходити нове повідомлення. 

В полі «Тригер» встановлюємо значення «На створення». 

Так як нас цікавлять тільки повідомлення з завдань, то в полі «Модель поштового повідомлення» обираємо модель «Завдання». Після цього з’являється додаткове поле «Дочірній партнер». 

В ньому задаємо поле з моделі Завдання – Підписники(Партнери), щоб підключити розсилку повідомлень всім підписникам задачі, до якої додалися зміни.

Для створення кінцевого повідомлення користувачу використовуємо тип повідомлення - необроблене повідомлення.

В поле «Необроблене повідомлення» вводимо текст нашого повідомлення користувачу. Якщо потрібно в текст додати поле, вираз заповнювача поля можна отримати на вкладці «Динамічний генератор заповнювачів».

Для цього переходимо на вкладку «Динамічний генератор заповнювачів». В полі «Поле» обираємо необхідне поле. В полі «Значення по замовчуванню» вводимо значення, яке буде відображатись в повідомлення, якщо поле буде пустим. В рядку «Вираз заповнювача» відобразиться готовий шаблон виразу. Натиснути кнопку «и» і поле буде додане до тексту на вкладці «Необроблене повідомлення»: 

Після внесення всіх налаштувань ввімкнути перемикач «Активний»:



7.4. Приклад сповіщення на основі часових умов.

Розглянемо приклад створення сповіщення, де тригером виступає деяка дата. Наприклад, кінцевий термін виконання задачу. 

Заходимо в Чат-бот - Налаштування – Сповіщення. Натискаємо кнопку «Створити».

В поле «Назва» вводимо назву сповіщення «Прострочені задачі».

Вмикаємо перемикач «Додати URL-адресу», щоб користувач швидко міг перейти на потрібну йому задачу. Посилання на задачу буде додаватись внизу повідомлення.

В полі «Бот» обираємо чат-бот, для якого буде спрацьовувати сповіщення:

Так як сповіщення повинні отримувати не всі користувачі, а тільки ті, які є відповідальними по задачі, то необхідно обрати модель та обмежити партнера. 

Для цього вмикаємо перемикач «Обраний партнер» та в полі «Партнер» вказуємо поле з моделі Завдання – Уповноважені. 

В полі «Тригер» встановлюємо значення «На основі часових умов».

В поле «Дата тригеру» встановлюємо поле типу дата або дата-час, яке являється тригером для запуску розсилки сповіщень. 

В додаткових полях «затримка після дати запуску» є можливість налаштування відкладеного або попереджуючого сповіщення. 

Наприклад, кінцевий термін, це поле формату дата без годин. Якщо в першому полі замість нуля ми установимо від’ємне значення, наприклад -2, то сповіщення спрацює за дві години до вказаної дати 00:00:00годин. Якщо установити додатнє значення, то тригер спрацює вказаної дати о 02:00:00. 

Окрім годин є можливість задати затримку в хвилинах, днях та місяцях. 

Для створення кінцевого повідомлення користувачу використовуємо тип повідомлення - необроблене повідомлення.

В поле «Необроблене повідомлення» вводимо текст нашого повідомлення користувачу. Якщо потрібно в текст додати поле, вираз заповнювача поля можна отримати на вкладці «Динамічний генератор заповнювачів».

Для цього переходимо на вкладку «Динамічний генератор заповнювачів». В полі «Поле» обираємо необхідне поле. В полі «Значення по замовчуванню» вводимо значення, яке буде відображатись в повідомлення, якщо поле буде пустим. В рядку «Вираз заповнювача» відобразиться готовий шаблон виразу. Натиснути кнопку «Додати динамічне поле до повідомлення» і поле буде додане до тексту на вкладці «Необроблене повідомлення»: 

Після внесення всіх налаштувань ввімкнути перемикач «Активний»:


7.5. Сповіщення по зовнішній події

Даний розділ присвячений сповіщенням, які необхідно відображати користувачам в чат-боті в залежності від тих чи інших зовнішніх подій. Зокрема це стосується запитів, які виникають після натискання кнопок в телеграм боті під час здійснення діалогу в форматі Питання-Відповідь. 

Загальна інформація щодо методики введення полів описана в розділі «Загальна інформація створення сповіщень.»

Сповіщення бувають декількох рівнів вкладеності: однорівневі та дворівневі. Розглянемо кожен тип більш детально. 

Однорівневе сповіщення.

Однорівневим сповіщенням можна назвати сповіщення, яке надає деталізовану інформацію по поточній моделі даних, не звертаючись до пов’язаних додаткових моделей даних, для створення поглибленої деталізації. Таким прикладом може виступати сповіщення, про список всіх лідів. Інформація відображається тільки з моделі ліди, без звернення до додаткових дочірніх моделей: 



В налаштуваннях фінального повідомлення приймають участь тільки дані поточної моделі без звертання до дочірнього сповіщення: 


Дворівневе сповіщення. 

Дворівневим сповіщенням можна назвати сповіщення, яке складається з декількох однорівневих сповіщень, приєднаних до батьківської моделі даних. Таким чином вони надають більш розгорнуту деталізовану інформацію. Прикладом виступає сповіщення, яке надає інформацію про всі замовлення клієнта з детальним відображенням рядків замовлення: 


Дане сповіщення складається з двох моделей: батьківська модель «Замовлення» та дочірня модель «Рядки замовлення». Для кожної моделі створене окреме сповіщення, яке формує своє деталізоване інформаційне повідомлення:

Об’єднуються окремо побудовані сповіщення в налаштуваннях сповіщення для батьківської моделі даних, «Замовлення», в вкладці «Дизайнер повідомлень». 

Для цього обираємо відповідне поле в батьківській моделі даних і для нього підключаємо дочірнє сповіщення в колонці «Дочірнє сповіщення». 


Більш детально налаштування дворівневого сповіщення розглянемо в розділах «Приклад Рівень 1. Сповіщення «Всі замовлення на продаж»» та «Приклад Рівень2. Сповіщення «Рядки замовлення» для «Всі замовлення на продаж».»

Як створити різного типу Telegram кнопки, які використовуються в сповіщеннях, описано в документації по Automated Actions.

7.5.1. Приклад Рівень 1. Сповіщення «Всі замовлення на продаж». 

Створимо сповіщення, яке після натискання в чат-боті кнопки «Всі замовлення на продаж», буде повертати нам список замовлень в форматі: 

Замовлення № номер_замовлення 

Клієнт: ПІБ_клієнта 

Статус замовлення Статус_замовлення 

Статус рахунка: Статус_рахунка 

Рядки замовлення:

 № рядка. Назва товару Кількість товару.Вартість товару.Загалом Сума_товару.

Загалом: Сума_замовлення. 

URL: посилання_на_ замовлення 

Необхідно перейти в додаток Чат-бот – Налаштування – По зовнішній події. Натиснути кнопку «Створити». 

В полі «Назва» вводимо назву сповіщення: «Всі замовлення на продаж». 

Якщо необхідно в сповіщені виводити посилання на сторінку, то ставимо перемикач «Додати URL-адресу» активним. 

В полі Домени «Рівень всіх записів» нічого не міняємо, так як в даному прикладі нас цікавлять всі замовлення на продаж без виключення.

Фінальне повідомлення користувачу в нашому випадку не довільного характеру, а містить в собі певну структурованість даних. Для його створення використовуємо конструктор повідомлень. В полі «Тип повідомлення» обираємо «Конструктор повідомлень».

В вкладці дизайнер повідомлень натискаємо кнопку «Додати» рядок і по черзі згідно нашому стартовому шаблону додаємо всі необхідні поля з моделі Замовлення:

Натискаємо кнопку «Зберегти» та підключаємо створене сповіщення в налаштуваннях кроку до потрібної кнопки: 

В чат-боті, після натискання кнопки «Всі замовлення» отримуємо повідомлення в наступному вигляді: 


Як ми можемо помітити, замість розвернутої деталізації по рядкам замовлення ми отримуємо значення, яке зберігається в полі «Рядки замовлення». Потрібно створити сповіщення «Рядки замовлення», яке буде повертати список рядків кожного замовлення з деталізацією по товару. (Розділ «Рівень2. Сповіщення «Рядки замовлення» для «Всі замовлення на продаж».»).

Відкрити налаштування сповіщення «Всі замовлення на продаж» і в колонку «Дочірнє сповіщення» додати новостворене сповіщення «Рядки замовлення»: 


Натиснути кнопку «Зберегти» і налаштуваннях і перейти до боту. В боті повторно натиснути кнопку «Всі замовлення» і отримаємо список замовлень з детальною інформацією по кожному замовленому товару: 



7.5.2. Приклад Рівень 2. Сповіщення «Рядки замовлення» для «Всі замовлення на продаж». 

Розглянемо приклад створення дочірнього сповіщення, яке входить в склад сповіщення першого рівня і надає деталізовану інформацію щодо його компонентів. 

Переходимо в Налаштування – По зовнішній події та натискаємо кнопку «Створити». 

В поле «Назва» вводимо «Рядки замовлення».

Перемикач «Додати URL-адресу» не активуємо так як нас не цікавить посилання на кожен окремий рядок замовлення. 

В полі «Модель» обираємо «Рядок замовлення на продаж».

В полі «Тригер» встановлюємо «По зовнішній події», тому що інформацію ми будемо запитувати після натискання кнопки в чат-боті. 

Для того, щоб кожен рядок замовлення мав свій унікальний номер в повідомлення в розділі «Додайте серійний номер до рядка повідомлення» вмикаємо перемикач «генерувати номер для рядка повідомлення»:

За допомогою конструктору повідомлень формуємо структуру відповіді, яка буде відображуватися кінцевому користувачу наступним чином: 


7.5.3. Сповіщення для створення запиту.

Розглянемо другий варіант створення сповіщення на запит. Наприклад, при виборі кнопки «Всі проекти» користувачу необхідно відобразити список всіх його проектів та надати дивитися список всіх задач по проектам. 

Щоб створити нове сповіщення необхідно натиснути кнопку «Створити».

Відкривається вікно створення нового сповіщення.

В полі «Назва» вводимо назву нашого сповіщення, наприклад, «Всі проекти». 

Перемикач «Активний» дозволяє включити/виключити сповіщення. Перемикач «Активний» перемикаємо в активну позицію в саму останню чергу, після закінчення всіх налаштувань.

Перемикач «Додавання URl» дозволяє в текст сповіщення додати посилання, по якому користувач зможе перейти на потрібну сторінку сайту. Вмикаємо перемикач «Додавання URl», щоб для кожного замовлення додавалось посилання. 

Поле «Модель» дозволяє вказати з якою саме моделлю даних працює це сповіщення. 

В випадаючому списку моделей відображається сім перших значень з довідника. Щоб продовжити пошук, можна натиснути кнопку «Шукати ще…» або розпочати вводити назву моделі і в списку відобразяться всі відповідні фільтру значення. 


Обираємо значення «Проекти».

Поле «Тригер» - випадаючий список, який дозволяє обрати на зміну яких саме полів реагує і виконується сповіщення користувача. 

В системі налаштовані наступні види тригерів: 

  • При створені;
  • При зміні;
  • При створені і зміні;
  • При видалені;
  • На основі часових умов;
  • По зовнішній події.

В нашому прикладі ми обираємо значення «По зовнішній події», тому що сповіщення має спрацювати тільки після відповідного запита користувача. 

Так як наше сповіщення надає відповідь, а саме список проектів на запит клієнта в боті, то в полі «Тригер» установлюємо значення «По зовнішній події». 

По замовчуванню в полі «Match all records» стоїть фільтр, який повертає всі записи системи. Щоб налаштувати інші значення необхідно натиснути на кнопку «Редагувати домен». В нашому прикладі нам потрібно вивести всі значення, тому ми не будемо змінювати фільтр. Як налаштовувати фільтр можна переглянути в розділі «9.10.1 Сповіщення для створення повідомлень.».


Поле «Type Message» дозволяє обрати яким саме чином буде будуватися відповідь абоненту в чат-боті:

  • Raw Message – текстовий рядок; 
  • Construct Message – конструктор значень полів моделі даних. 

Якщо нам потрібно клієнту надіслати інформаційне повідомлення, наприклад, про зміну статусу його замовлення, то має сенс використати тип повідомлення «Raw Message». 

Якщо клієнту необхідно надати структуровану відповідь по кожному елементу запита, наприклад, деталі по кожному проекту, то використовується конструктор повідомлень «Construct Message».

Щоб додати новий рядок, необхідно натиснути кнопку «Додати рядок»: