Телеграм-бот (Службовий): відмінності між версіями
| Рядок 193: | Рядок 193: | ||
[[Файл:TextTriggersTemplatesInfo.png|800px|міні|без]] | [[Файл:TextTriggersTemplatesInfo.png|800px|міні|без]] | ||
===== Змінні для шаблонів тексту ===== | |||
Змінні — це один з основних інструментів службової розсилки. Це спеціальні теги (закодовані слова), які автоматично підставляють у повідомлення реальні дані елемента, щодо якого спрацювала розсилка (наприклад, суму рахунку, час послуги тощо). | |||
Щоб відкрити список змінних, натисніть кнопку '''«Змінні»''' у лівому верхньому куті вікна редагування розсилки. Зліва з'явиться бічна панель (модальне вікно) з доступним переліком. | |||
[[Файл:MailingVariables1.png|800px|міні|без]] | |||
'''Як додати змінну в текст:''' | |||
# Встановіть курсор у текстовому полі в тому місці, де хочете розмістити змінну. | |||
# Знайдіть потрібну змінну у списку та натисніть кнопку '''«Додати»''' поруч із нею. | |||
# Після цього у текст буде вставлено спеціальний код (тег) відповідної змінної. | |||
[[Файл:MailingVariables2.png|800px|міні|без]] | |||
= Кнопки Telegram-бота = | = Кнопки Telegram-бота = | ||
Поточна версія на 10:36, 20 квітня 2026
Налаштування в ІІ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 - сервіс розсилки - Фільтри для розсилки.
Щоб створити фільтр для розсилки, потрібно натиснути плюс в правому куті зверху і обрати "Створення службового фільтра розсилки".
Основні поля
- Назва — обов'язкове поле для заповнення.
- Події-тригери — поле для вибору подій, що запускатимуть автоматичну розсилку.
- Важливо: Вибір тригерів впливає на тип розсилки!
- Якщо тригери не обрані: розсилці, до якої приєднано цей фільтр, можна буде призначити лише тип «Одноразова» або «Періодична».
- Якщо обрано хоча б один тригер: розсилка автоматично отримує тип «По тригеру», а всі обрані події переносяться до неї. Змінити тип у самій розсилці буде неможливо — для цього потрібно редагувати налаштування самого фільтра.
Фільтри подій-тригерів
За потреби можна додати додаткові обмеження (фільтри) для конкретних подій:
Подія-тригер «Створення рахунку»
- Термінал, на якому проводяться операції;
- Користувач, який відкрив рахунок.
Подія-тригер «Оплата рахунку»
- Сума замовлення (від/до);
- Термінал, на якому проводяться операції;
- Вид оплати (наприклад, картка або готівка);
- Користувач, який відкрив або закрив рахунок.
Подія-тригер «Нагадування про послугу»
- Завчасність нагадування (хв).
Вкладка «Група персон»
У цій вкладці необхідно обрати персон, яким буде відправлятися розсилка.
Способи додавання персон
Існує два способи додати персон до списку:
- Через рядок пошуку:
- Через модальне вікно (дерево папок):
- Дозволяє обрати як окремих користувачів, так і відразу цілу папку з персонами.
Збереження та відображення
Після додавання необхідних персон обрані файли та папки відображатимуться у вигляді дерева. Натисніть кнопку «Готово», щоб зберегти налаштування:
- Елементи, щойно додані до списку, підсвічуються зеленим кольором.
- Примітка: При редагуванні фільтра папки, які обрані повністю, підсвічуватимуться синім кольором.
Шаблон розсилки
Детальніше про створення шаблону розсилки читайте за посиланням.
- Зверніть увагу: Шаблон вважається службовим лише в тому випадку, якщо в ньому обрано службовий Telegram-бот.
Створення розсилки
Шлях: WD → Лояльність та CRM → Сервіс розсилки → Розсилки
Щоб створити розсилку, натисніть на іконку плюса в правому верхньому куті та оберіть «Додати».
Налаштування службовості
Щоб зробити розсилку службовою, встановіть прапорець біля параметра Службовий, а потім оберіть відповідні фільтр та шаблон розсилки.
- Примітка: Після позначення розсилки як службової, у полях вибору фільтра та шаблону відображатимуться лише службові варіанти. Якщо прибрати прапорець — для вибору будуть доступні всі варіанти, окрім службових.
Вплив фільтра на тип розсилки:
- Якщо у фільтрі обрані події-тригери, розсилці автоматично присвоюється тип «По тригеру». Всі тригери переносяться у поле нижче, і ці поля стають недоступними для редагування.
- Якщо у фільтрі не обрані події-тригери, для розсилки можна буде обрати лише тип «Одноразова» або «Періодична». Детальніше про ці типи читайте за посиланням.
Шаблони тексту тригерів
Це спеціальні тексти, які будуть відправлені замість основного тексту з шаблону розсилки при спрацьовуванні відповідного тригера. Щоб це спрацювало, для тригера має бути заданий текст та активований прапорець надсилання.
Варто зазначити, що не всі тригери можуть мати власний шаблон тексту. При першому створенні такі шаблони деактивовані та містять лише стандартні приклади для ознайомлення.
- Підказка: При наведенні курсора на іконку «i» з'явиться контекстна підказка з інформацією щодо використання цього поля.
Змінні для шаблонів тексту
Змінні — це один з основних інструментів службової розсилки. Це спеціальні теги (закодовані слова), які автоматично підставляють у повідомлення реальні дані елемента, щодо якого спрацювала розсилка (наприклад, суму рахунку, час послуги тощо).
Щоб відкрити список змінних, натисніть кнопку «Змінні» у лівому верхньому куті вікна редагування розсилки. Зліва з'явиться бічна панель (модальне вікно) з доступним переліком.
Як додати змінну в текст:
- Встановіть курсор у текстовому полі в тому місці, де хочете розмістити змінну.
- Знайдіть потрібну змінну у списку та натисніть кнопку «Додати» поруч із нею.
- Після цього у текст буде вставлено спеціальний код (тег) відповідної змінної.
Кнопки Telegram-бота
Шлях: WD → Лояльність та CRM → Телеграм боти → Кнопки боти
Щоб переглянути або відредагувати кнопки конкретного службового бота, оберіть його у списку зверху.
Стандартні статичні кнопки
Стандартні статичні кнопки — це кнопки, які створюються системою автоматично під час створення бота. Їх не можна видалити, але можна вимкнути.
Список стандартних кнопок:
- На головну: кнопка, натискання на яку повертає користувача до базового меню кнопок (маркапу). Відображається за замовчуванням.
- Мої дані: дозволяє користувачу змінити свої особисті дані в системі безпосередньо через інтерфейс чат-бота. Відображається за замовчуванням.
- Скасувати: дозволяє скасувати процес редагування даних. Відображається за замовчуванням.
- Графік роботи: виводить у чат-бот графік роботи за послугами з планера (календаря) на кілька днів уперед. Кількість днів для відображення налаштовується у вікні редагування кнопки. За замовчуванням прихована.
- Розклад на день: виводить розклад послуг з планера (календаря) на поточний день, які можна відзначити як виконані безпосередньо в чаті. За замовчуванням прихована.
Детальніше про функціонал кожної кнопки описано нижче.
Кастомні кнопки
Щоб створити власну (кастомну) кнопку, натисніть на іконку плюса у правому верхньому куті.
Поля, які потрібно заповнити:
- Ім'я — текст, який буде відображатися безпосередньо на кнопці (наприклад, «Графік роботи»).
- Текст відповіді — інформація або дія, що відправляється у відповідь на натискання кнопки. Наприклад, тут можна вказати посилання на Google Документ із графіком роботи.
Демонстрація основного функціоналу
Розсилки
Як працює розсилка створення та оплати рахунку
Створення нового рахунку
- У вкладці «Фільтри для розсилки» оберіть подію-тригер «Створення рахунку».
- Після створення нового рахунку в POS-системі, система автоматично надсилає повідомлення в Telegram-бот, яке містить інформацію про новий рахунок, зокрема:
- Номер рахунку;
- Користувача, який відкрив рахунок;
- Місце надання послуги.
Приклад повідомлення в Telegram-боті:
Оплата рахунку
- У панелі фільтрів оберіть подію-тригер «Оплата рахунку».
- При оплаті рахунку система автоматично відправляє повідомлення в Telegram-бот, яке містить:
- Номер рахунку;
- Користувача, який закрив рахунок;
- Суму до оплати.
Приклад повідомлення в Telegram-боті:
Як працює розсилка з планером (календарем)
Бронювання послуги в шахматці
- У панелі фільтрів виберіть подію-тригер «Бронювання послуги в шахматці».
- При бронюванні послуги в планері система автоматично відправляє повідомлення в Telegram-бот, яке за замовчуванням містить:
- Назва послуги (з уточненням: створення звичайної чи групової послуги, або додавання учасника до групи);
- Виконавець послуги;
- Час початку послуги;
- Час завершення послуги;
- Місце надання послуг;
- Контрагент;
- Учасники;
- Додаткові виконавці;
- Коментар.
Приклад повідомлення в Telegram-боті:
Нагадування про послугу
- У панелі фільтрів виберіть подію-тригер «Нагадування про послугу».
- Система автоматично відправлятиме повідомлення в Telegram-бот за певний час до початку послуги (цей час налаштовується у фільтрі розсилки). Повідомлення за замовчуванням містить:
- Назва послуги (з уточненням: створення звичайної чи групової послуги, або додавання учасника до групи);
- Виконавець послуги;
- Час початку послуги;
- Час завершення послуги;
- Місце надання послуг;
- Контрагент;
- Учасники;
- Додаткові виконавці;
- Коментар.
Приклад повідомлення в Telegram-боті:
Як працює розсилка зі SmartSpot
Отримання відгуку
- У панелі фільтрів виберіть подію-тригер «Отримання відгуку».
- При отриманні відгуку зі SmartSpot система автоматично відправляє повідомлення в Telegram-бот, яке за замовчуванням містить:
- Час;
- Рахунок;
- Заклад ;
- Клієнт ;
- Номер телефону ;
- Виконавець;
- Відповідь клієнта на оцінювальне опитування;
- Коментар;
- Фото при наявності.
Приклад повідомлення в Telegram-боті:
Бронювання столів
- У панелі фільтрів виберіть подію-тригер «Бронювання столів».
- При отриманні бронюванню столика зі SmartSpot система автоматично відправляє повідомлення в Telegram-бот, яке за замовчуванням містить:
- Час;
- Заклад;
- Місце надання послуг;
- Приміщення для надання послуг;
- Клієнт;
- Номер телефону;
- Коментар.
Приклад повідомлення в Telegram-боті:
Функціонал стандартних статичних кнопок
На головну
Ця кнопка виводить заданий текст відповіді та повертає користувачеві стандартне меню кнопок (маркап).
Мої дані
Дозволяє користувачу редагувати свої особисті дані безпосередньо через інтерфейс чат-бота.
Алгоритм дій:
- При натисканні кнопки «Мої дані» бот надсилає текст відповіді та картку з поточними даними, під якою розташована інлайн-кнопка «Змінити дані».
- Після натискання кнопки «Змінити дані», вона зникає, а на її місці з'являється перелік полів, доступних для редагування (у вигляді інлайн-кнопок). Натисніть на кнопку з назвою потрібного поля.
- Бот надішле повідомлення: «Введіть [Назва поля], щоб змінити:». Після відправки нового значення бот повідомить про успішне збереження змін і знову виведе оновлену картку даних.
Скасувати
Якщо під час редагування даних натиснути кнопку «Скасувати», процес переривається. Бот виводить відповідне повідомлення про скасування та повертає користувача до початкової картки даних.
Графік роботи
Ця кнопка створена спеціально для виконавців послуг, які працюють із планером (календарем). У вікні редагування цієї кнопки необхідно активувати прапорець «Відображати» та вказати кількість днів для показу (в діапазоні від 1 до 10, за замовчуванням — 7).
При натисканні на цю кнопку бот виводить розклад послуг на найближчий робочий день (сьогоднішній або наступний, у який є заплановані послуги для цього виконавця). Під повідомленням відображаються інлайн-кнопки з датами інших днів (у межах встановленого ліміту), на які також є записи.
При натисканні на інлайн-кнопку з іншою датою, поточне повідомлення оновлюється і відображає розклад на обраний день.
Розклад на день
Ця кнопка також створена спеціально для виконавців послуг. Для її активації потрібно встановити прапорець «Відображати» у налаштуваннях кнопки.
При натисканні кнопки бот виводить список повідомлень. Кожне повідомлення містить інформацію про окрему послугу на сьогоднішній день для поточного виконавця, а також інлайн-кнопку «Підтвердити виконання».
Якщо натиснути «Підтвердити виконання», текст повідомлення зміниться на запит: «Підтверджуєте виконання послуги '[Назва послуги]' [Час послуги]?», а замість однієї кнопки з'являться інлайн-кнопки «Так» і «Ні».
- При натисканні «Ні» — повідомлення повертається до початкового стану.
- При натисканні «Так» — інлайн-кнопки зникають, а текст змінюється на підтвердження:
- Виконання послуги підтверджено.
- [Інформація про послугу]






















