Процес чат-бота є стандартним бізнес-процесом, створеним у дизайнері процесів Creatio.

Пакет, у якому ви створюєте бізнес-процес, повинен залежати від пакету BeesenderBotMaster.

Основні елементи чат-бота

При створенні чат-бота ви будете використовувати наступні основні елементи бізнес-процесу:

Стартова подія - використовуйте цей елемент як початок вашого процесу.

Beesender: Текстове повідомлення - використовуйте цей елемент для відправки повідомлень без кнопок (наприклад, вітання, прощання, деяка інформація, коли ви не очікуєте відповіді на це повідомлення).

Beesender: Повідомлення з кнопками - використовуйте цей елемент для відправки повідомлень з кнопками АБО коли ви хочете отримати відповідь на своє питання.

Beesender: Надіслати зображення - використовуйте цей елемент для відправлення зображення.

Beesender: Надіслати файл - використовуйте цей елемент для відправлення файлу.

Beesender: Надіслати місцезнаходження - використовуйте цей елемент для відправлення місцезнаходження.

Ексклюзивний шлюз (Виключне "АБО") - Ексклюзивний шлюз (АБО).

Підпроцес - створіть процес за допомогою підпроцесу для підвищення швидкості чат-бота та для виклику готових підпроцесів Beesender.

Кінцева подія - використовуйте цей елемент як закінчення вашого процесу.

Створення процесу чат-бота

Beesender_BotStep1.mp4

Перейдіть у розділ Бібліотека процесів та натисніть Додати процес.
Введіть назву вашого процесу та код.
Перейдіть на вкладку Параметри та створіть 3 необхідні параметри:

Назва	Код	Тип даних
ChatId	ChatId	Унікальний ідентифікатор
ClientId	ClientId	Унікальний ідентифікатор
OperatorId	OperatorId	Унікальний ідентифікатор

Створімо перше повідомлення чат-бота

Виберіть елемент Beesender: Текстове повідомлення з панелі дій користувача Виконати дію процесу.
Заповніть поля:

Поле	Значення
Повідомлення	Встановіть своє повідомлення, наприклад, Привіт.

Beesender_BotStep2.mp4

Поверніться до вашої системи Creatio та встановіть ваш процес для вашого чат-бота. Не забудьте додати канал у деталі Канали.

Відкрийте канал, який ви додали, і напишіть щось, щоб активувати чат-бота.

Beesender_BotStep3.mp4

Вітаю! Ви отримали своє перше повідомлення від чат-бота.

Тепер, коли ви зрозуміли принцип, давайте заглибимося в деталі.

Beesender: Текстове повідомлення

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

Як ви вже знаєте, у Beesender: Текстове повідомлення є наступні обов'язкові параметри:

Поле	Значення
Повідомлення	Встановіть своє повідомлення, наприклад, Привіт.

У полі Повідомлення ви можете не тільки писати текст, але й вводити параметри, прочитані з об'єкта. Це може бути, наприклад, ім'я контакту, сьогоднішня дата та інше. Параметри з типом даних, відмінним від тексту, необхідно конвертувати в текст.

Наприклад, давайте спробуємо надіслати деяку інформацію про Контакт:

Спочатку додайте елемент Читання данi та виберіть Контакт у полі “З якого об'єкту читати дані?“.
Далі виберіть елемент Виконати дію процесу.
Виберіть Beesender: Текстове повідомлення зі списку.
Заповніть поля:
1. ChatId;
2. ClientId;
3. OperatorId
Клацніть на поле Повідомлення та виберіть Формула.
- Текст, який ви пишете без використання параметра, повинен бути взятий у лапки, наприклад: "Інформація про контакт: ".
- Щоб з'єднати параметри разом у один текст, використовуйте знак +.
- Щоб додати новий рядок, використовуйте "\n".
- Щоб конвертувати параметр, тип даних якого не є рядком, конвертуйте його. Для цього, після дужок параметра, напишіть: .ToString(), наприклад: [#Date#].ToString().

Наприклад, давайте вкажемо інформацію про контакт у тексті повідомлення, таку як повне ім'я, дата народження та номер телефону, і наша формула буде виглядати так:

"Інформація про контакт:"+"\n"+"\n"+"Ім'я: "+[#Читати Контакт.Перший елемент результуючої колекції.ПІБ#]+"\n"+"Дата народження: "+[#Читати Контакт.Перший елемент результуючої колекції.Дата народження#].ToString()+"\n"+"Телефонний номер: "+[#Читати Контакт.Перший елемент результуючої колекції.Мобільний телефон#]

6. Натисніть Зберегти, щоб закрити викно Формула.

7. І натисніть Зберегти, щоб зберегти ваш процес.

8. Відкрийте ваш канал і напишіть нове повідомлення, щоб активувати чат-бота.

Інформація про контакт:

Ім'я: Повне ім'я з картки контакту;
Дата народження: дата/час з картки контакту;
Номер мобільного телефону: мобільний телефон з картки контакту.

Перейдіть за посиланням, щоб дізнатися більше про роботу з елементом процесу [Формула].

Beesender: Повідомлення з кнопками

Використовуйте елемент Beesender: Повідомлення з кнопками для відправлення повідомлень з кнопками АБО коли ви хочете отримати відповідь на своє питання.

У Beesender: Повідомлення з кнопками є наступні обов'язкові параметри:

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

Наприклад, давайте спробуємо створити наступний випадок:

Чат-бот відправляє інформацію про контакт (ми використаємо вже налаштовану логіку).
Чат-бот питає: "Будь ласка, підтвердіть, що надана інформація вірна" і показує 2 кнопки:
- Підтвердити
- Відхилити
Якщо клієнт натиснув Підтвердити, бот пише: "Дякуємо, інформація підтверджена".
Якщо клієнт натиснув Відхилити, бот пише: "Будь ласка, введіть дійсне повне ім'я" і замінює повне ім'я у картці контакту на інформацію, яку вводить клієнт.

Схема цього випадку:

Дотримуйтесь наступних кроків, щоб побудувати цей випадок:

Виберіть елемент Виконати дію процесу.
Виберіть Beesender: Повідомлення з кнопками зі списку.
Заповніть поля:
- ChatId, ClientId, OperatorId
- Повідомлення: Будь ласка, підтвердіть, що надана інформація вірна
- Кнопка 1: Підтвердити
- Кнопка 2: Відхилити
Додайте елемент Виключне "АБО".
Клацніть на потоці та встановіть умову:
- потік Підтвердження - параметр Відповідь з елемента Beesender: Повідомлення з кнопками == параметр Кнопка 1 з елемента Beesender: Повідомлення з кнопками.
Додайте ще один потік від елемента Виключне "АБО" та встановіть умову:
- потік Відхилення - параметр Відповідь з елемента Beesender: Повідомлення з кнопками == параметр Кнопка 2 з елемента Beesender: Повідомлення з кнопками.
Додайте останній потік від елемента АБО до елемента Beesender: Повідомлення з кнопками та виберіть тип потоку = Тип за замовчуванням – це необхідно, щоб якщо клієнт не вибирає кнопки, але пише щось, процес не зламався, і повторив попереднє питання
Додайте елемент Beesender: Повідомлення з кнопками на потік Підтвердження та заповніть поля:
- ChatId, ClientId, OperatorId
- Повідомлення: Дякуємо, інформація підтверджена
Додайте елемент Beesender: Повідомлення з кнопками на потік Відхилення та заповніть поля:
- ChatId, ClientId, OperatorId
- Повідомлення: Будь ласка, введіть дійсне повне ім'я
- Залиште всі інші поля порожніми
Додайте елемент Змінити дані, виберіть об'єкт Контакт, де Id = Id з елемента Читати дані Контакту.
Виберіть колонку Повне ім'я та встановіть у це поле параметр Відповідь з попереднього елемента Beesender: Повідомлення з кнопками.
Збережіть ваш процес.
Поверніться до вашого каналу та напишіть нове повідомлення, щоб активувати чат-бота
Виберіть кнопки, щоб побачити результат.