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

Матеріал з expertsolution
Перейти до навігації Перейти до пошуку

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

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

IIS Manager.png

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

Налаштування для Pool.png

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

Sites.png

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

Preload Enabled.png

Після виконання цих кроків сайт буде завжди завантажений у пам’яті сервера 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". Дане ім'я відображатиметься в назві чату.

Сторення назви для чат-боту.png

Після того, як користувач додав ім'я бота та надіслав його, @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

Ім'я боту.png

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

Повідомлення з токеном .png

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

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

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

Photo 2026-03-09 18-22-24.jpg

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

Photo 2026-03-09 18-22-49.jpg

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

Photo 2026-03-09 18-23-15.jpg
Photo 2026-03-09 18-23-51.jpg

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

Увімкнути телеграм ботів.png

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

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

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

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

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

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

Screenshot 1231.png

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

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

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

Screenshot 66546546.png

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

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

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

Registration11.png
Registration2.png

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

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

Screenshot 321321.png
Screenshot 43214123412.png

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

Screenshot 5у3242.png

Розсилка

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

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

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

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

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

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

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

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

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

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

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


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

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

PersonGHroupModal.png

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

  1. Через рядок пошуку:
    PersonGroupInput.png
  2. Через модальне вікно (дерево папок):
    Дозволяє обрати як окремих користувачів, так і відразу цілу папку з персонами.
    PersonGroupModalTree.png
Збереження та відображення

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

  • Елементи, щойно додані до списку, підсвічуються зеленим кольором.
PersonGroupResultList2.png
Примітка: При редагуванні фільтра папки, які обрані повністю, підсвічуватимуться синім кольором.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Кнопки Telegram-бота

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

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

TGButtons.png

Стандартні статичні кнопки

Стандартні статичні кнопки — це кнопки, які створюються системою автоматично під час створення бота. Їх не можна видалити, але можна вимкнути.

Список стандартних кнопок:

  • На головну: кнопка, натискання на яку повертає користувача до базового меню кнопок (маркапу). Відображається за замовчуванням.
  • Мої дані: дозволяє користувачу змінити свої особисті дані в системі безпосередньо через інтерфейс чат-бота. Відображається за замовчуванням.
  • Скасувати: дозволяє скасувати процес редагування даних. Відображається за замовчуванням.
  • Графік роботи: виводить у чат-бот графік роботи за послугами з планера (календаря) на кілька днів уперед. Кількість днів для відображення налаштовується у вікні редагування кнопки. За замовчуванням прихована.
  • Розклад на день: виводить розклад послуг з планера (календаря) на поточний день, які можна відзначити як виконані безпосередньо в чаті. За замовчуванням прихована.
StaticTGButtons.png

Детальніше про функціонал кожної кнопки описано нижче.

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

Щоб створити власну (кастомну) кнопку, натисніть на іконку плюса у правому верхньому куті.

Screenshot 15543.png

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

  • Ім'я — текст, який буде відображатися безпосередньо на кнопці (наприклад, «Графік роботи»).
  • Текст відповіді — інформація або дія, що відправляється у відповідь на натискання кнопки. Наприклад, тут можна вказати посилання на Google Документ із графіком роботи.
Screenshot 2245.png
Screenshot 3432.png

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

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

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

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

Screenshot 143242222.png

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

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

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

Screenshot 2659г8нг95804.png

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

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

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

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

PlannerBookingMsg.png

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

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

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

RemindAssign.png

Як працює розсилка зі SmartSpot

Отримання відгуку

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

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

Feedback.png

Бронювання столів

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

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

ReservationSmartSpot.png