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

Матеріал з 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

Функціонал стандартних статичних кнопок

На головну

Ця кнопка виводить заданий текст відповіді та повертає користувачеві стандартне меню кнопок (маркап).

MainBtn.png

Мої дані

Дозволяє користувачу редагувати свої особисті дані безпосередньо через інтерфейс чат-бота.

Алгоритм дій:

  1. При натисканні кнопки «Мої дані» бот надсилає текст відповіді та картку з поточними даними, під якою розташована інлайн-кнопка «Змінити дані».
    MyDataBtn1.png
  2. Після натискання кнопки «Змінити дані», вона зникає, а на її місці з'являється перелік полів, доступних для редагування (у вигляді інлайн-кнопок). Натисніть на кнопку з назвою потрібного поля.
    MyDataBtn2.png
  3. Бот надішле повідомлення: «Введіть [Назва поля], щоб змінити:». Після відправки нового значення бот повідомить про успішне збереження змін і знову виведе оновлену картку даних.
    MyDataBtn4.png

Скасувати

Якщо під час редагування даних натиснути кнопку «Скасувати», процес переривається. Бот виводить відповідне повідомлення про скасування та повертає користувача до початкової картки даних.

MyDataBtn5.png

Графік роботи

Ця кнопка створена спеціально для виконавців послуг, які працюють із планером (календарем). У вікні редагування цієї кнопки необхідно активувати прапорець «Відображати» та вказати кількість днів для показу (в діапазоні від 1 до 10, за замовчуванням — 7).

ScheduleBtn1.png

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

ScheduleBtn2.png

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

ScheduleBtn3.png

Розклад на день

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

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

DailySchedule2.png

Якщо натиснути «Підтвердити виконання», текст повідомлення зміниться на запит: «Підтверджуєте виконання послуги '[Назва послуги]' [Час послуги]?», а замість однієї кнопки з'являться інлайн-кнопки «Так» і «Ні».

DailySchedule3.png
  • При натисканні «Ні» — повідомлення повертається до початкового стану.
  • При натисканні «Так» — інлайн-кнопки зникають, а текст змінюється на підтвердження:
Виконання послуги підтверджено.
[Інформація про послугу]