Viber
Viber-бот компанії: повідомлення клієнтів вашому боту з'являються в «Переписках», а відповідь звідти йде тим самим ботом. Кожен бот — свій акаунт картки з токеном із панелі ботів Viber; адміністратор вводить токен і вмикає вебхук кнопкою, без розробника.
На цій сторінці
Можливості
- Бот за токеном із панелі ботів Viber; кілька ботів — окремі акаунти картки («+»).
- Повідомлення клієнтів у «Переписках» з підписом акаунта; відповідь із «Переписок» іде тим самим ботом від імені, яке ви задали.
- Текст, фото (до 5 МБ) і файли (до ліміту файлів організації) — у стрічці чату, відкриваються натиском; контакт, локація, стікер і посилання — позначкою в тексті.
- Вебхук вмикається й знімається кнопкою; кожну подію Viber підписує, і Helomi приймає лише підписані.
- Привітання, яке Viber показує клієнту, щойно той відкрив чат із ботом.
- «Перевірити» показує назву бота й кількість підписників.
- Відправка повідомлень у Viber з тригерів через сервіси розсилок — дією Webhook (шаблон «Viber (TurboSMS)», див. Webhook).
1Підключити бота
Viber надсилає повідомлення бота лише на адресу вебхука, тому підключення — це токен і одна кнопка «Увімкнути вебхук». Підключає адміністратор.
- Відкрийте панель ботів Viber (partners.viber.com) і увійдіть акаунтом, якому належить бот.
- Відкрийте свого бота й скопіюйте його токен (поле «Token»). Це ключ до бота: нікому його не пересилайте.
- Відкрийте Налаштування›Інтеграції й автоматизація›Повідомлення›Viber«Налаштування → Інтеграції й автоматизація → Повідомлення → Viber», вкладку «Підключення».
- У рядку ключа «VIBER_BOT_TOKEN» натисніть «Ввести», вставте токен і натисніть «Зберегти ключ».
- Натисніть «Увімкнути вебхук» — Viber перевірить адресу Helomi, і вебхук стане «увімкнено».
- Натисніть «Перевірити» — відповідь «акаунт <назва>, підписників N» означає, що все гаразд.
- Напишіть боту з Viber — повідомлення одразу з'явиться в «Переписках».
Нові бот-акаунти Viber з 2024 року видають через партнерів Viber. Якщо бота ще нема, зверніться до партнера Viber; уже наявний бот підключається цими кроками.
Іншого способу, ніж вебхук, Viber не дає: поки вебхук не ввімкнено, повідомлення не приходять. Кнопки «Отримати повідомлення зараз» у Viber нема — події приходять самі.
2Кілька ботів — для кожного бренду свій
Кожен бот — окремий акаунт картки зі своєю назвою, токеном, перемикачем, налаштуваннями й журналом. Розмови в «Переписках» підписані назвою акаунта, а відповідь іде саме тим ботом, що отримав повідомлення.
- У картці «Viber» натисніть «+» унизу праворуч.
- Вкажіть назву (наприклад, «Магазин сумок») і токен бота, натисніть «Додати акаунт».
- Увімкніть перемикач у шапці картки нового акаунта — акаунт створюється вимкненим і, доки вимкнений, повідомлень не записує.
- Натисніть «Увімкнути вебхук», потім «Перевірити».
3Привітати клієнта й підписати відповіді
«Налаштування бота» — що бот каже сам і як підписано відповіді: привітання, ім'я відправника, джерело угод, відповідальний, оператори.
- Відкрийте вкладку «Підключення» картки бота → «Налаштування бота».
- У полі «Привітання» напишіть текст, який Viber покаже клієнту, щойно той відкриє чат із ботом. Порожньо — без привітання.
- У полі «Ім'я відправника» вкажіть, від чийого імені йдуть відповіді (до 28 знаків). Порожньо — ім'я бота у Viber.
- У полях «Джерело угод», «Відповідальний» і «Оператори» оберіть значення зі списків.
- Натисніть «Зберегти».
4Відповісти клієнту
Відповідь пишуть у «Переписках»: вона йде тим самим ботом, що отримав повідомлення, від імені з поля «Ім'я відправника».
- Відкрийте «Переписки» і чат із підписом акаунта бота.
- Напишіть текст у полі внизу й натисніть «Надіслати».
- Фото й файли з відповіді клієнт отримає посиланнями в тексті.
Viber пропускає повідомлення бота лише підписникам; клієнт стає підписником, щойно напише боту. Клієнт, який відписався, відповіді не отримає — «Переписки» покажуть причину.
5Зняти вебхук
Вебхук знімають, коли бот переходить в іншу програму або більше не потрібен: Viber перестає надсилати події в Helomi.
- Відкрийте вкладку «Підключення» картки бота.
- Натисніть «Зняти вебхук».
- Щоб повернути — «Увімкнути вебхук».
6Зовнішній сервіс Viber (як було до ботів)
Організація, у якої переписки Viber надходили від окремого сервісу компанії, працює, як і раніше: такі розмови мають підпис без акаунта, а відповідь на них іде через чергу цього сервісу й доходить до клієнта після його наступного прогону. Основна картка «Viber» вважається підключеною, якщо введено токен бота або цей сервіс хоч раз звітував.
Можливі помилки
| Що ви бачите | Чому | Що зробити |
|---|---|---|
| «токен відхилено — скопіюйте чинний токен із панелі Viber» | Токен змінили в панелі або скопіювали не повністю | Скопіюйте токен заново й вставте через «Змінити» |
| «Viber не прийняв адресу вебхука — потрібна адреса https» | Сервер Helomi без захищеної адреси | Зверніться до підтримки Helomi |
| «Спершу введіть токен бота — кнопка «Ввести» в рядку ключа» | Токен не задано | «Підключення» → «Ввести» → вставте токен → «Зберегти ключ» |
| «вебхук не ввімкнено — натисніть «Увімкнути вебхук»» | Вебхук знято або не вмикали | Натисніть «Увімкнути вебхук» |
| «клієнт не підписаний на бота — дочекайтеся його повідомлення» | Клієнт відписався або давно не писав | Дочекайтеся, поки клієнт напише боту |
| «бота заблоковано у Viber — перевірте його в панелі Viber» | Viber обмежив бота | Перевірте стан бота в панелі Viber |
| «забагато запитів до Viber — спробуйте за хвилину» | Ліміт Viber | Зачекайте хвилину й повторіть |
| «Viber не відповів — спробуйте ще раз» | Збій мережі чи Viber | Повторіть дію |
| Повідомлення не з'являються | Вебхук не ввімкнено або акаунт вимкнено | Увімкніть перемикач акаунта й натисніть «Увімкнути вебхук» |
Для ШІ-співробітників
ШІ з доступом до «Інтеграцій» бачить стан бота інструментом viber_state (kind картки: viber або viber-<slug>): чи задано токен, назва бота й підписники, стан вебхука, привітання й ім'я відправника, скільки розмов без відповіді; картки всіх ботів — integrations_list, журнал — integrations_log. Токен вводить, вебхук вмикає й бота налаштовує лише людина-адміністратор — ШІ ключів не бачить і не вводить, адресу вебхука бачить без секрету. Розмови Viber ШІ бачить у «Переписках» разом з іншими каналами; відповідати в чатах ботів поки може лише людина. Статтю ШІ читає інструментом help("int-viber").
Додаткова інформація
Цю саму статтю читають ШІ-співробітники Helomi: help("int-viber")