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

Налаштування в ІІ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.

У службовому Telegram-боті можуть зареєструватися лише ті персони, які відповідають одній з наступних умов:

• Для них створені Користувачі або Виконавці послуг.
• Вони належать до груп персон «Персонал» або «Виконавці послуг».

Детальніше про це читайте за посиланням.

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

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

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

Розсилка

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

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

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

Основні поля

• Назва — обов'язкове поле для заповнення.
• Події-тригери — поле для вибору подій, що запускатимуть автоматичну розсилку.

Важливо: Вибір тригерів впливає на тип розсилки!

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

Фільтри подій-тригерів

За потреби можна додати додаткові обмеження (фільтри) для конкретних подій:

Подія-тригер «Створення рахунку»

• Термінал, на якому проводяться операції;
• Користувач, який відкрив рахунок.

Подія-тригер «Оплата рахунку»

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

Подія-тригер «Нагадування про послугу»

• Завчасність нагадування (хв).

Вкладка «Група персон»

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

Способи додавання персон
Існує два способи додати персон до списку:

1. Через рядок пошуку:

   

2. Через модальне вікно (дерево папок):

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

   

Збереження та відображення

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

• Елементи, щойно додані до списку, підсвічуються зеленим кольором.

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

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

Детальніше про створення шаблону розсилки читайте за посиланням.

Зверніть увагу: Шаблон вважається службовим лише в тому випадку, якщо в ньому обрано службовий Telegram-бот.

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

Шлях: WD → Лояльність та CRM → Сервіс розсилки → Розсилки

Щоб створити розсилку, натисніть на іконку плюса в правому верхньому куті та оберіть «Додати».

Налаштування службовості

Щоб зробити розсилку службовою, встановіть прапорець біля параметра Службовий, а потім оберіть відповідні фільтр та шаблон розсилки.

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

Вплив фільтра на тип розсилки:

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

Шаблони тексту тригерів

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

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

Підказка: При наведенні курсора на іконку «i» з'явиться контекстна підказка з інформацією щодо використання цього поля.

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

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

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

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

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

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

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

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

1. У вкладці «Фільтри для розсилки» оберіть подію-тригер «Створення рахунку».
2. Після створення нового рахунку в POS-системі, система автоматично надсилає повідомлення в Telegram-бот, яке містить інформацію про новий рахунок, зокрема:
   • Номер рахунку;
   • Користувача, який відкрив рахунок;
   • Місце надання послуги.

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

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

1. У панелі фільтрів оберіть подію-тригер «Оплата рахунку».
2. При оплаті рахунку система автоматично відправляє повідомлення в Telegram-бот, яке містить:
   • Номер рахунку;
   • Користувача, який закрив рахунок;
   • Суму до оплати.

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

Як працює розсилка з планером (календарем)

Бронювання послуги в шахматці

1. У панелі фільтрів виберіть подію-тригер «Бронювання послуги в шахматці».
2. При бронюванні послуги в планері система автоматично відправляє повідомлення в Telegram-бот, яке за замовчуванням містить:
   • Назва послуги (з уточненням: створення звичайної чи групової послуги, або додавання учасника до групи);
   • Виконавець послуги;
   • Час початку послуги;
   • Час завершення послуги;
   • Місце надання послуг;
   • Контрагент;
   • Учасники;
   • Додаткові виконавці;
   • Коментар.

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

Нагадування про послугу

1. У панелі фільтрів виберіть подію-тригер «Нагадування про послугу».
2. Система автоматично відправлятиме повідомлення в Telegram-бот за певний час до початку послуги (цей час налаштовується у фільтрі розсилки). Повідомлення за замовчуванням містить:
   • Назва послуги (з уточненням: створення звичайної чи групової послуги, або додавання учасника до групи);
   • Виконавець послуги;
   • Час початку послуги;
   • Час завершення послуги;
   • Місце надання послуг;
   • Контрагент;
   • Учасники;
   • Додаткові виконавці;
   • Коментар.

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