Як підключити бота до KWIGA

У KWIGA можна підключити ботів і канали комунікації через Telegram, WhatsApp, Facebook Messenger, Instagram Direct та Viber.

Щоб підключити бота, відкрийте відповідний розділ налаштувань у кабінеті KWIGA, виберіть потрібний месенджер, заповніть обов'язкові поля та натисніть «Зберегти бота».

1. Telegram

Для підключення Telegram-бота потрібно вказати:

• Назва — назва бота в KWIGA.

• Token — токен, отриманий у Telegram через @BotFather після створення бота.

Важливо:

• Не передавайте токен стороннім особам. Він надає доступ до керування ботом.

• Якщо токен було скомпрометовано, його потрібно відкликати та створити новий через BotFather.

2. WhatsApp

Для підключення WhatsApp потрібно вказати:

• Назва — назва підключення в KWIGA.

• Токен доступу — постійний токен системного користувача.

• Phone Number ID — ідентифікатор номера телефону.

• WhatsApp Business Account ID (WABA ID) — ідентифікатор облікового запису WhatsApp Business.

• App Secret застосунку Meta — секретний ключ застосунку Meta.

Важливо перед підключенням

• Номер телефону не повинен залишатися підключеним до звичайного застосунку WhatsApp або WhatsApp Business. Перед підключенням його потрібно від'єднати відповідно до інструкції інтеграції.

• Якщо номер використовується іншим провайдером, перевірте вимоги до перенесення номера та двофакторної перевірки.

• Застосунок Meta має бути в режимі Live та містити посилання на політику конфіденційності.

• До завершення перевірки бізнесу Meta в інтерфейсі KWIGA зазначено обмеження на надсилання повідомлень не більш ніж 250 новим клієнтам на добу. Перед публікацією потрібно підтвердити актуальність і точну сферу застосування цього ліміту.

• Після завершення 24-годинного вікна з моменту останнього повідомлення клієнта можна надсилати лише шаблони повідомлень, схвалені Meta.

• Для першого контакту з клієнтом необхідно дотримуватися правил WhatsApp щодо згоди одержувача на повідомлення.

Додатково враховуйте, що Meta встановлює тарифи на повідомлення та може застосовувати обмеження залежно від статусу й якості облікового запису.

3. Facebook Messenger

Для підключення Facebook Messenger потрібно вказати:

• Назва — назва підключення в KWIGA.

• Токен доступу сторінки (Page Access Token) — токен доступу до сторінки Facebook.

• Page ID — ідентифікатор сторінки Facebook.

• App Secret застосунку Meta — секретний ключ застосунку Meta.

Важливо перед підключенням

• Застосунок Meta має бути в режимі Live та містити посилання на політику конфіденційності.

• Відповідати клієнту звичайним повідомленням можна протягом 24 годин після його останнього повідомлення.

• Після завершення цього періоду стандартне надсилання повідомлень обмежується правилами Meta. Спеціальні механізми надсилання доступні лише за умов, визначених Meta.

• Для роботи інтеграції потрібні відповідні дозволи застосунку та доступ до сторінки Facebook.

4. Instagram Direct

Для підключення Instagram Direct потрібно вказати:

• Назва — назва підключення в KWIGA.

• Токен доступу Instagram (довготривалий) — токен доступу.

• Instagram User ID — ідентифікатор професійного акаунта Instagram.

• Instagram App Secret застосунку Meta — секретний ключ застосунку Meta.

Важливо перед підключенням

• Для інтеграції потрібен професійний акаунт Instagram — Business або Creator. Особисті акаунти не підтримують цей API-сценарій.

• Застосунок Meta має бути в режимі Live та містити посилання на політику конфіденційності.

• Відповідати клієнту звичайним повідомленням можна протягом 24 годин після його останнього повідомлення.

• Можливість почати діалог, надіслати повідомлення або продовжити спілкування залежить від правил Instagram Messaging API.

• Для роботи інтеграції необхідно надати застосунку потрібні дозволи на роботу з повідомленнями.

5. Viber

Для підключення Viber потрібно вказати:

• Назва — назва бота в KWIGA.

• Токен бота Viber — токен, отриманий у Viber Admin Panel.

Важливо перед підключенням

• Створення чат-бота потребує реєстрації та погодження відповідно до актуальних комерційних умов Rakuten Viber.

• За чинною комерційною моделлю Viber стандартна плата за обслуговування нового бота становить 115 € на місяць. Додатково оплачуються доставлені повідомлення, ініційовані ботом. Остаточну вартість потрібно перевірити у Viber перед підключенням.

• Повідомлення в межах активної 24-годинної сесії не оплачуються окремо за кожне повідомлення в межах описаної моделі.

• Сесія починається, коли підписник надсилає повідомлення боту або відповідає на повідомлення, ініційоване ботом.

• Для надсилання повідомлень поза активною сесією застосовуються комерційні умови Viber.

Налаштування бота в KWIGA

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

Доступні налаштування залежать від підключеного месенджера.

Вхідні

Налаштування обробки вхідних діалогів і робочого часу бота.

• Автопризначення діалогів — автоматичний розподіл діалогів між співробітниками по черзі.

• Робочі години — налаштування часового поясу та графіка роботи.

• Автовідповідь поза робочими годинами — автоматичне повідомлення підписнику, який звернувся поза встановленим графіком.

Повідомлення

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

Залежно від доступних функцій можна налаштувати привітання під час першого контакту, відповіді на типові звернення та повідомлення, пов'язані з доступом до закритих груп.

Команди

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

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

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

Також доступні системні команди, зокрема /help, /menu, /stop, /unsubscribe та /subscribe, які використовуються для стандартних дій бота.

Кнопки

Налаштування кнопок, за допомогою яких підписник взаємодіє з ботом.

Залежно від доступних можливостей можна налаштувати клавіатуру під полем введення та кнопки під повідомленнями.

Посилання

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

Наприклад, якщо ви розміщуєте посилання на бота на сайті, в Instagram та рекламних оголошеннях, створіть для кожного джерела окреме посилання з відповідною назвою: «Сайт», «Instagram», «Facebook Ads» тощо.

Щоб створити посилання:

1. Введіть назву джерела.

2. Натисніть «Створити посилання».

3. Скопіюйте згенероване посилання або завантажте QR-код.

4. Розмістіть його у відповідному місці.

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

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

Діагностика

Перевірка зв'язку між ботом і KWIGA, перегляд статусу підключення та використання доступних інструментів діагностики.

Набір інструментів залежить від інтеграції.