Телеграм-бот (Службовий)

Налаштування в ІІS

Щоб сайт на сервері працював постійно і не засинав, коли ніхто ним не користується, потрібно зробити певні налаштування:
1. Відкрити IIS Manager
2. Вибрати потрібний Application Pool- у лівій панелі знайти розділ Application Pools. Вибрати пул додатку, який використовує сайт.
3. Відкрити Advanced Settings - Клацнути правою кнопкою миші на обраному пулі. Вибрати Advanced Settings з контекстного меню.

4. Змінити наступні параметри:
Start Mode → AlwaysRunning
(Це означає, що пул додатку буде завантажуватись одразу після запуску IIS)
Idle Time-out (minutes) → 0
(Це вимикає автоматичне вимкнення додатку при бездіяльності)

5. Налаштувати параметри сайту
Перейти у Sites, обрати сайт.
Клацнути правою кнопкою → Manage Website → Advanced Settings

Знайти параметр Preload Enabled і встановити його в значення True.

Після виконання цих кроків сайт буде завжди завантажений у пам’яті сервера IIS і не буде "засинати" під час простою.

Створення чат-боту в Telegram

Як створити чат-бот в телеграмі

Щоб підключити функцію отриманная/надсилання повідомлень до сервісу через телеграм необхідно виконати наступні операції: Створити бота та отримати його токен. Відправити повідомлення @BotFather, за допомогою команди /newbot. Після відправлення команди /newbot, @BotFather надсилатиме наступні команди для реєстрації нового бота: Alright, a new bot. How are we going to call it? Please choose a name for your bot. - дана команда вимагає, щоб користувач ввів назву для створюваного боту, наприклад "Working_bot". Дане ім'я відображатиметься в назві чату.

Після того, як користувач додав ім'я бота та надіслав його, @BotFather надсилає нову команду:
Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.
Користувачеві необхідно вказати користувацьке ім'я для бота. В користувацькому імені обов'язково має бути слово bot, назва має бути вказана без використання пробілів, розділення слів виконувати краще за допомогою символу нижнього підкоеслення або без розділення, наприклад TetrisBot або tetris_bot

Після створення боту, в чаті @BotFather надішле повідомлення, яке міститиме токен вашого бота.

Створений токен потрібно додати в налаштуваннях чат-боту у Work Desk

Налаштування чат-боту у Work Desk

1. У розділ “Лояльність та CRM” відкрити розділ "Телеграм Боти"
2. Натиснути кнопку "Плюс" (+) — відкриється форма створення нового чат-бота
3. Обрати "Додати новий службовий Телеграм-бот."

3. У формі потрібно вказати:
Обов'язкові поля - Токен, Мова інтерфейсу
За потребою можна вказати такі поля як:
- Вітальне повідомлення
- Повідомлення з проханням поділитись контактом
- Повідомлення про успішну реєстрацію

4. Після створення бота, ім'я бота автоматично підтягнеться з назви бота в @BotFather.

Обов'язково має бути увімкнене налаштування "Увімкнути телеграм ботів"
Шлях: WD - НАлаштування - Реєстр налаштувань - Лояльність та CRM - Telegram - Увімкнути телеграм ботів (telegramBotEnabled)

Створення персони та реєстрація в Telegram-боті

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

Шлях: WD - Довідники - Персони.

- Натисніть кнопку + для створення нової персони.

- Заповніть поля, такі як ім’я, прізвище та інші необхідні дані.

Обов'язково вказати Мобільний номер для подальшої реєстрації користувача в Telegram.

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

- Виберіть вже існуючу персону.

- У полі "Мобільний номер" введіть номер телефону, який буде використаний для реєстрації в Telegram.

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

Для цього потрібно натискати кнопку "Поділитися контактом" в чаті з ботом.

Після того, як користувач поділиться своїм номером телефону, бот надішле повідомлення з підтвердженням "Користувача додано".

Створення розсилки

Для того, щоб створити розсилку, спочатку треба створити фільтр для розсилки і шаблон розсилки

Фільтр для розсилки

Шлях: WD - Лояльність та CRM - сервіс розсилки - Фільтри для розсилки.
Щоб створити фільтр для розсилки, потрібно натиснути плюс в правому куті зверху і обрати "Створення службового фільтра розсилки".

Поля які потрібно заповнити:
- Назва
- Події-тригери, виберіть один або кілька тригерів, які будуть визначати, які операції запускатимуть розсилку (наприклад, "Оплата рахунку", "Створення рахунку").

За потреби можна додати обмеження (фільтри) для тригерів, такі як:
- Сума замовлень від/до
- Термінал, на якому будуть проводитися операції
- Вид оплати (наприклад, картка або готівка)
- Користувач, який відкрив/закрив рахунок

У вкладці "Група персон" потрібно обрати персон від яких будуть йти операції по тригерам

Можна обрати як одного-двох юзерів, так і цілу папку з персонами, для прикладу папка "Персонал"

Після додання потрібних юзерів потрібно натиснути на кнопку "Готово", щоб зберегти налаштування

Шаблон розсилки

Шлях: WD - Лояльність та CRM - сервіс розсилки - Шаблони розсилки - Користувацькі.
Щоб створити шаблон розсилки, потрібно натиснути плюс в правому куті зверху.

У формі створення шаблону необхідно заповнити кілька обов'язкових полів:
- Найменування (наприклад, "Створення і оплата")
- Опис

Перейдіть до вкладки "Телеграм бот"
Виберіть створеного раніше службового бота, з яким буде працювати шаблон
Після цього натисніть кнопку "Готово".

Розсилки

Шлях: WD - Лояльність та CRM - сервіс розсилки - розсилки.
Щоб створити розсилку, потрібно натиснути плюс в правому куті зверху.

Поля які потрібно заповнити:
- Назва (наприклад, "Створення і оплата")
- Обов'язково натиснути галку "Службовий"
- Обрати створений "Фільтр розсилки" і "Шаблон розсилки"

Натиснути на галки "Надсилати текстове повідомлення згідно з цим шаблоном при активації тригера Оплата рахунку" і "Надсилати текстове повідомлення згідно з цим шаблоном при активації тригера Створення рахунку"

При необхідності ці 2 шаблони можна змінювати, додавати нові змінні, змінювати текст повідомлення або додавати смайлики

Кастомні кнопки

Шлях: WD - Лояльність та CRM - Телеграм боти - Кнопки боти.

Щоб створити кнопки ботів, потрібно натиснути плюс в правому куті зверху і обрати потрібного Телеграм-бота.

Поля які потрібно заповнити:

Ім'я - Введіть текст, який буде відображатися на кнопці (наприклад, "Графік роботи").

Текст відповіді - Для прикладу вкажіть посилання, яке буде відкриватися при натисканні на кнопку (наприклад, посилання на Google Docs для графіку роботи).

Як працює розсилка створення та оплати рахунку

Створення нового рахунку

1) У вкладці "Фільтри для розсилки" потрібно обрати подію-тригер "Створення рахунку".

2) Після створення нового рахунку у ПОС, система автоматично надсилає повідомлення в Telegram-бот, яке містить всю інформацію про новий рахунок, включаючи:

- Номер рахунку

- Користувача, який відкрив рахунок

- Місце надання послуги

Приклад повідомлення в Telegram-боті:

Рахунок №35084

Користувач: Антон Житомирський

Місце надання послуги: Спа

Оплата рахунку

1) У панелі фільтрів виберіть подію-тригер "Оплата рахунку".

2) При оплаті рахунку система автоматично відправляє повідомлення в Telegram-бот, яке містить:

- Номер рахунку

- Користувача, який закрив рахунок

- Сума до оплати

- Приклад повідомлення в Telegram-боті:

- Рахунок №35084

- Користувач: Антон Житомирський

- Сума: 20,00 грн

- Місце надання послуги: №2