Перейти до основного вмісту

Інтеграція з Viber-ботом

Viber-бот — це офіційний чат вашої компанії у Viber. Клієнт відкриває його і пише так само, як звичайному контакту. Коли бот підключений до Skynum, усе листування ведеться в розділі Месенджер: там видно повідомлення клієнта, а відповідь іде від імені бота.

Що описує ця стаття

Тут зібрано підключення бота і правила саме Viber: підписка клієнта, платні повідомлення, файли. Щоденна робота з переписками описана в розділі Месенджер, а порівняння з іншими каналами — у таблиці Можливості каналів.

Що потрібно підготувати​

  • чинний бот у Viber. Якщо бота ще немає, його створюють за заявкою — розділ Заявка на бота;
  • токен цього бота;
  • доступ адміністратора бота у Viber — токен бачить лише він.

Бот у Viber​

Заявка на бота​

Нових ботів Viber створює лише за заявкою, яку подає його офіційний партнер. Обслуговування бота платне: умови й ціну повідомляє партнер.

  1. Відкрийте перелік партнерів Viber.
  2. Відфільтруйте його: продукт Viber Chatbots, країна Ukraine.
  3. Оберіть партнера й залиште йому заявку на бота. Спершу спитайте, чи робить він чат-ботів: багато партнерів Viber займаються лише альфа-іменами й розсилками.
  4. Узгодьте з партнером назву, логотип і адресу бота. Назву й логотип клієнт бачить у Viber, адреса входить у посилання на бота.
  5. Після схвалення заявки бот з'явиться у Viber, і його налаштування, зокрема токен, відкриються адміністратору бота.

Токен бота​

Токен — це рядок із літер і цифр, за яким Viber упізнає вашого бота. Його показує застосунок Viber адміністратору бота, у налаштуваннях бота. В англійському інтерфейсі Viber шлях такий: More → Settings → Bots → Edit Info → Your app key.

Токен — це ключ до бота

Хто має токен, той може писати клієнтам від імені вашого бота. Передавайте токен лише тим, хто налаштовує інтеграцію, і не публікуйте його.

Бот, який працює з іншим сервісом, теж підходить: відключіть його в тому сервісі й підключіть у Skynum. Створювати другого бота не потрібно.

Що зробити в Skynum​

  1. Відкрийте Налаштування → Інтеграції → Месенджери.
  2. Натисніть Додати інтеграцію і виберіть Viber-бот.
  3. Введіть Назва інтеграції.
  4. Вставте токен бота в поле Токен.
  5. Увімкніть Інтеграція активна.
  6. Заповніть Канал продажу, Тип ціни, Виконавець за замовчуванням, Звук сповіщень, Відправляти сповіщення тільки і Філія, юридична особа. Призначення цих полів описане в статті Підключення інтеграцій.
  7. Поле Обліковий запис залиште порожнім: Skynum сам впише туди адресу бота.
  8. Натисніть Зберегти.
  9. Натисніть Перевірити підключення.

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

У верхній частині інтеграції стоїть нагадування про платні повідомлення Viber. Про них — у розділі Платні повідомлення.

Запит номера телефону​

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

  1. Відкрийте інтеграцію бота та увімкніть Запитувати номер телефону.
  2. Виберіть Мова повідомлень бота — цією мовою бот пише клієнтам: Українська, Русский або English.
  3. Натисніть Зберегти.

Запит отримує клієнт, який відкриває чат з ботом за посиланням або зі сторінки бота у Viber. Бот надсилає йому повідомлення з кнопкою Поділитися номером. Це повідомлення видно в чаті Skynum серед повідомлень компанії.

Після натискання кнопки в діалозі з'являється картка з номером клієнта. Що відбувається далі, залежить від картотеки:

  • номер належить одному контрагенту або його контактній особі — Skynum пов'язує діалог із цим контрагентом;
  • номер не знайдено або він є в кількох контрагентів — виберіть контрагента в полі Контрагент у правій панелі чату;
  • у діалозі вже вибрано контрагента — бот номер не запитує, вибір співробітника зберігається.

Зв'язок установлює лише номер, яким клієнт поділився кнопкою. Контакт із телефонної книги, який клієнт переслав у чат, залишається звичайною карткою.

Як клієнти пишуть боту​

Першим пише клієнт. Він відкриває бота у Viber і надсилає повідомлення — з цього моменту йому можна відповідати.

Посилання на бота:

viber://pa?chatURI= + Обліковий запис

Наприклад viber://pa?chatURI=myshop

Додайте посилання на сайт, у соцмережі й у розсилки.

У чаті Skynum видно, що клієнт робить зі своєю підпискою на бота:

  • Клієнт розпочав діалог — клієнт відкрив чат з ботом;
  • Клієнт відписався від повідомлень — клієнт вибрав у Viber Не отримувати повідомлення. Писати йому бот не може, доки клієнт не напише сам або не вибере Отримувати повідомлення;
  • Клієнт підписався на повідомлення — клієнт знову дозволив боту писати.

Запрошення в чат через Viber-розсилку​

Розсилка у Viber приходить клієнту за номером телефону, навіть якщо він ще ніколи не відкривав вашого бота. Тому розсилкою зручно запрошувати клієнтів у чат: у повідомленні стоїть кнопка, яка веде прямо до бота.

  1. Відкрийте Контрагенти → SMS і натисніть Нова розсилка.
  2. У полі Провайдер виберіть інтеграцію розсилок із каналом Viber.
  3. У полі Месенджер напишіть, навіщо клієнту писати вам: наприклад, щоб уточнити замовлення або отримати консультацію.
  4. У полі Кнопка введіть напис на кнопці, наприклад «Написати нам».
  5. У поле Посилання вставте посилання на чат з ботом.
  6. Виберіть отримувачів.
  7. Натисніть Надіслати.

Клієнт отримує повідомлення від імені вашої компанії і натискає кнопку. У нього відкривається чат з ботом, а в Месенджері Skynum з'являється діалог із рядком Клієнт розпочав діалог. Якщо увімкнено Запитувати номер телефону, бот одразу просить клієнта поділитися номером.

Щойно клієнт написав боту, йому можна відповісти з чату. Наступні 24 години ці відповіді безкоштовні.

Поля розсилки для Viber описані в статті Ручне надсилання SMS, а підключення сервісів розсилок — у розділі SMS-розсилки.

Платні повідомлення​

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

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

Що можна надсилати​

Клієнту можна надіслати текст, фото, документи і товар із каталогу Skynum. Правила Viber:

  • текст повідомлення — до 5000 символів;
  • фото з текстом клієнт отримує одним повідомленням, текст стає підписом. Підпис — до 768 символів;
  • документ із текстом клієнт отримує двома повідомленнями: спочатку документ, потім текст;
  • документ клієнт може відкрити у Viber протягом 30 днів від надсилання. Пізніше надішліть документ ще раз;
  • товар із каталогу Skynum — кнопка з коробкою біля поля введення: клієнт отримає фото товару з ціною за полем Тип ціни інтеграції. Докладніше: Надсилання товару з картотеки.

Від клієнта в чат потрапляють текст, фото, відео, файли, стікери, геолокація і контакти. Фото, відео і файли розміром до 20 МБ Skynum зберігає у себе, тому вони відкриваються в чаті будь-коли.

Після надсилання під вашим повідомленням стоїть Відправлено. Коли повідомлення дійшло до телефона клієнта, позначка змінюється на Доставлено, а коли клієнт його прочитав — на Переглянуто.

Перевірка після підключення​

  1. Відкрийте у Viber на телефоні посилання на чат з ботом.
  2. Напишіть боту будь-яке повідомлення.
  3. Відкрийте розділ Месенджер у Skynum і знайдіть новий діалог зі значком Viber.
  4. Надішліть відповідь із чату Skynum і перевірте, що вона прийшла у Viber.

Типові ситуації​

«API токен порожній або недійсний» під час збереження​

Viber не прийняв токен. Скопіюйте токен у налаштуваннях бота у Viber заново і вставте в поле Токен без пробілів на початку і в кінці.

«Інтеграція з обліковим записом … вже існує»​

Бот із цим токеном уже є серед інтеграцій вашої компанії. Відкрийте наявну інтеграцію замість створення нової.

Клієнт пише боту, а діалог у Skynum не з'являється​

  • Перевірте перемикач Інтеграція активна в інтеграції.
  • З'ясуйте, чи не підключено того самого бота ще й до іншої системи. Viber надсилає повідомлення бота лише одній системі — тій, що підключила його останньою. Відключіть бота в іншій системі, вставте токен у поле Токен інтеграції ще раз і натисніть Зберегти.
  • Вимкніть Інтеграція активна, натисніть Зберегти, потім увімкніть перемикач і збережіть інтеграцію ще раз.

Під повідомленням стоїть «Клієнт відписався від повідомлень Viber-бота»​

Клієнт заборонив боту писати йому. Повідомлення дійде після того, як клієнт напише боту або вибере у Viber Отримувати повідомлення. Тоді натисніть Повторити під повідомленням.

Клієнт не може відкрити документ​

Viber показує клієнту повідомлення, що файл більше не доступний. Минуло понад 30 днів від надсилання. Надішліть документ у чат ще раз.

Файл клієнта стоїть у чаті без посилання​

Розмір файла перевищує 20 МБ. У чаті залишається його назва й розмір, а під назвою стоїть пояснення Файл завеликий: Skynum зберігає файли до 20 МБ. Попросіть клієнта надіслати менший файл або посилання на нього.

Підсумок​

Viber-бот підключається одним токеном: вставте його в інтеграцію, увімкніть її і перевірте підключення. Далі клієнти пишуть боту у Viber, а відповіді йдуть із розділу Месенджер Skynum. Пам'ятайте про два правила Viber: відповіді безкоштовні 24 години після повідомлення клієнта, а писати можна лише клієнту, який не вимкнув повідомлення бота.