Інтеграція з Viber-ботом
Viber-бот — це офіційний чат вашої компанії у Viber. Клієнт відкриває його і пише так само, як звичайному контакту. Коли бот підключений до Skynum, усе листування ведеться в розділі Месенджер: там видно повідомлення клієнта, а відповідь іде від імені бота.
Тут зібрано підключення бота і правила саме Viber: підписка клієнта, платні повідомлення, файли. Щоденна робота з переписками описана в розділі Месенджер, а порівняння з іншими каналами — у таблиці Можливості каналів.
Що потрібно підготувати
- чинний бот у Viber. Якщо бота ще немає, його створюють за заявкою — розділ Заявка на бота;
- токен цього бота;
- доступ адміністратора бота у Viber — токен бачить лише він.
Бот у Viber
Заявка на бота
Нових ботів Viber створює лише за заявкою, яку подає його офіційний партнер. Обслуговування бота платне: умови й ціну повідомляє партнер.
- Відкрийте перелік партнерів Viber.
- Відфільтруйте його: продукт Viber Chatbots, країна Ukraine.
- Оберіть партнера й залиште йому заявку на бота. Спершу спитайте, чи робить він чат-ботів: багато партнерів Viber займаються лише альфа-іменами й розсилками.
- Узгодьте з партнером назву, логотип і адресу бота. Назву й логотип клієнт бачить у Viber, адреса входить у посилання на бота.
- Після схвалення заявки бот з'явиться у Viber, і його налаштування, зокрема токен, відкриються адміністратору бота.
Токен бота
Токен — це рядок із літер і цифр, за яким Viber упізнає вашого бота. Його показує застосунок Viber адміністратору бота, у налаштуваннях бота. В англійському інтерфейсі Viber шлях такий: More → Settings → Bots → Edit Info → Your app key.
Хто має токен, той може писати клієнтам від імені вашого бота. Передавайте токен лише тим, хто налаштовує інтеграцію, і не публікуйте його.
Бот, який працює з іншим сервісом, теж підходить: відключіть його в тому сервісі й підключіть у Skynum. Створювати другого бота не потрібно.
Що зробити в Skynum
- Відкрийте Налаштування → Інтеграції → Месенджери.
- Натисніть Додати інтеграцію і виберіть Viber-бот.
- Введіть Назва інтеграції.
- Вставте токен бота в поле Токен.
- Увімкніть Інтеграція активна.
- Заповніть Канал продажу, Тип ціни, Виконавець за замовчуванням, Звук сповіщень, Відправляти сповіщення тільки і Філія, юридична особа. Призначення цих полів описане в статті Підключення інтеграцій.
- Поле Обліковий запис залиште порожнім: Skynum сам впише туди адресу бота.
- Натисніть Зберегти.
- Натисніть Перевірити підключення.
Після збереження в полі Обліковий запис стоїть адреса бота у Viber, а нижче — його назва й фото. Якщо токен правильний, перевірка завершується повідомленням Підключення успішно пройшло перевірку.
У верхній частині інтеграції стоїть нагадування про платні повідомлення Viber. Про них — у розділі Платні повідомлення.
Запит номера телефону
За номером телефону Skynum знаходить клієнта у вашій картотеці й пов'язує з ним діалог. З'ясовувати, хто саме написав, не потрібно.
- Відкрийте інтеграцію бота та увімкніть Запитувати номер телефону.
- Виберіть Мова повідомлень бота — цією мовою бот пише клієнтам: Українська, Русский або English.
- Натисніть Зберегти.
Запит отримує клієнт, який відкриває чат з ботом за посиланням або зі сторінки бота у Viber. Бот надсилає йому повідомлення з кнопкою Поділитися номером. Це повідомлення видно в чаті Skynum серед повідомлень компанії.
Після натискання кнопки в діалозі з'являється картка з номером клієнта. Що відбувається далі, залежить від картотеки:
- номер належить одному контрагенту або його контактній особі — Skynum пов'язує діалог із цим контрагентом;
- номер не знайдено або він є в кількох контрагентів — виберіть контрагента в полі Контрагент у правій панелі чату;
- у діалозі вже вибрано контрагента — бот номер не запитує, вибір співробітника зберігається.
Зв'язок установлює лише номер, яким клієнт поділився кнопкою. Контакт із телефонної книги, який клієнт переслав у чат, залишається звичайною карткою.
Як клієнти пишуть боту
Першим пише клієнт. Він відкриває бота у Viber і надсилає повідомлення — з цього моменту йому можна відповідати.
Посилання на бота:
viber://pa?chatURI=+Обліковий записНаприклад
viber://pa?chatURI=myshop
Додайте посилання на сайт, у соцмережі й у розсилки.
У чаті Skynum видно, що клієнт робить зі своєю підпискою на бота:
- Клієнт розпочав діалог — клієнт відкрив чат з ботом;
- Клієнт відписався від повідомлень — клієнт вибрав у Viber Не отримувати повідомлення. Писати йому бот не може, доки клієнт не напише сам або не вибере Отримувати повідомлення;
- Клієнт підписався на повідомлення — клієнт знову дозволив боту писати.
Запрошення в чат через Viber-розсилку
Розсилка у Viber приходить клієнту за номером телефону, навіть якщо він ще ніколи не відкривав вашого бота. Тому розсилкою зручно запрошувати клієнтів у чат: у повідомленні стоїть кнопка, яка веде прямо до бота.
- Відкрийте Контрагенти → SMS і натисніть Нова розсилка.
- У полі Провайдер виберіть інтеграцію розсилок із каналом Viber.
- У полі Месенджер напишіть, навіщо клієнту писати вам: наприклад, щоб уточнити замовлення або отримати консультацію.
- У полі Кнопка введіть напис на кнопці, наприклад «Написати нам».
- У поле Посилання вставте посилання на чат з ботом.
- Виберіть отримувачів.
- Натисніть Надіслати.
Клієнт отримує повідомлення від імені вашої компанії і натискає кнопку. У нього відкривається чат з ботом, а в Месенджері Skynum з'являється діалог із рядком Клієнт розпочав діалог. Якщо увімкнено Запитувати номер телефону, бот одразу просить клієнта поділитися номером.
Щойно клієнт написав боту, йому можна відповісти з чату. Наступні 24 години ці відповіді безкоштовні.
Поля розсилки для Viber описані в статті Ручне надсилання SMS, а підключення сервісів розсилок — у розділі SMS-розсилки.
Платні повідомлення
Viber рахує час від останнього повідомлення клієнта. Протягом 24 годин відповіді бота безкоштовні. Повідомлення, надіслане пізніше, Viber тарифікує власнику бота за своїми тарифами.
Skynum надсилає повідомлення в будь-який час, тож рішення, чи писати клієнту після 24 годин, ухвалює співробітник. Час останнього повідомлення клієнта видно в чаті.
Що можна надсилати
Клієнту можна надіслати текст, фото, документи і товар із каталогу Skynum. Правила Viber:
- текст повідомлення — до 5000 символів;
- фото з текстом клієнт отримує одним повідомленням, текст стає підписом. Підпис — до 768 символів;
- документ із текстом клієнт отримує двома повідомленнями: спочатку документ, потім текст;
- документ клієнт може відкрити у Viber протягом 30 днів від надсилання. Пізніше надішліть документ ще раз;
- товар із каталогу Skynum — кнопка з коробкою біля поля введення: клієнт отримає фото товару з ціною за полем Тип ціни інтеграції. Докладніше: Надсилання товару з картотеки.
Від клієнта в чат потрапляють текст, фото, відео, файли, стікери, геолокація і контакти. Фото, відео і файли розміром до 20 МБ Skynum зберігає у себе, тому вони відкриваються в чаті будь-коли.
Після надсилання під вашим повідомленням стоїть Відправлено. Коли повідомлення дійшло до телефона клієнта, позначка змінюється на Доставлено, а коли клієнт його прочитав — на Переглянуто.
Перевірка після підключення
- Відкрийте у Viber на телефоні посилання на чат з ботом.
- Напишіть боту будь-яке повідомлення.
- Відкрийте розділ Месенджер у Skynum і знайдіть новий діалог зі значком Viber.
- Надішліть відповідь із чату Skynum і перевірте, що вона прийшла у Viber.
Типові ситуації
«API токен порожній або недійсний» під час збереження
Viber не прийняв токен. Скопіюйте токен у налаштуваннях бота у Viber заново і вставте в поле Токен без пробілів на початку і в кінці.
«Інтеграція з обліковим записом … вже існує»
Бот із цим токеном уже є серед інтеграцій вашої компанії. Відкрийте наявну інтеграцію замість створення нової.
Клієнт пише боту, а діалог у Skynum не з'являється
- Перевірте перемикач Інтеграція активна в інтеграції.
- З'ясуйте, чи не підключено того самого бота ще й до іншої системи. Viber надсилає повідомлення бота лише одній системі — тій, що підключила його останньою. Відключіть бота в іншій системі, вставте токен у поле Токен інтеграції ще раз і натисніть Зберегти.
- Вимкніть Інтеграція активна, натисніть Зберегти, потім увімкніть перемикач і збережіть інтеграцію ще раз.
Під повідомленням стоїть «Клієнт відписався від повідомлень Viber-бота»
Клієнт заборонив боту писати йому. Повідомлення дійде після того, як клієнт напише боту або вибере у Viber Отримувати повідомлення. Тоді натисніть Повторити під повідомленням.
Клієнт не може відкрити документ
Viber показує клієнту повідомлення, що файл більше не доступний. Минуло понад 30 днів від надсилання. Надішліть документ у чат ще раз.
Файл клієнта стоїть у чаті без посилання
Розмір файла перевищує 20 МБ. У чаті залишається його назва й розмір, а під назвою стоїть пояснення Файл завеликий: Skynum зберігає файли до 20 МБ. Попросіть клієнта надіслати менший файл або посилання на нього.
Підсумок
Viber-бот підключається одним токеном: вставте його в інтеграцію, увімкніть її і перевірте підключення. Далі клієнти пишуть боту у Viber, а відповіді йдуть із розділу Месенджер Skynum. Пам'ятайте про два правила Viber: відповіді безкоштовні 24 години після повідомлення клієнта, а писати можна лише клієнту, який не вимкнув повідомлення бота.