Viber

Максимальна довжина текстового повідомлення: 1000 символів

Viber не дозволяє автоматично отримувати номер телефону клієнта.

Як підключити Viber

Стара версія

Ця версія застосовна лише для користувачів, які створили свого чат-бота до 5 лютого 2024 року.

Якщо ви ще не створили бота Viber (після 5 лютого 2024 року), перейдіть до розділу Нова версія.

Спочатку перейдіть за посиланням нижче та увійдіть на веб-сайт.

https://partners.viber.com/login?returnUrl=%2Faccount

Далі створіть публічний акаунт для вашого бота.

Виберіть зображення та заповніть усі обов'язкові поля.

Поле Опис
Назва акаунта Ім'я бота. Його можна змінити пізніше.
Uri Ім'я користувача бота. Використовується для генерації посилань на бота.
Категорія Вкажіть категорію вашого бізнесу (наприклад, Місцевий бізнес).
Підкатегорія Вкажіть підкатегорію бізнесу (наприклад, Автомобільний бізнес).
Мова Мова бота.
Опис акаунта Опис бота, видимий усім підписникам.
Веб-сайт Ваш веб-сайт.
Електронна пошта Контактна електронна адреса.
Місцезнаходження Місцезнаходження бізнесу.

У формі реєстрації є перемикач "Акаунт містить контент для дорослих."

НЕ ВМИКАЙТЕ ЦЮ ОПЦІЮ!

Інакше всі користувачі бачитимуть попередження перед відкриттям вашого бота про те, що він містить контент для дорослих.

Прийміть ліцензійну угоду та натисніть Створити.

Якщо все виконано правильно, ви отримаєте токен вашого бота.

Він знадобиться вам для наступного кроку.

Ваш бот готовий.

Залишився лише один крок — підключити його до Salebot.

Перейдіть до розділу Канали та виберіть Viber.

Введіть отриманий токен.

Натисніть Готово, щоб підключити бота до Salebot.

Ви отримаєте сповіщення в мобільному додатку Viber про те, що бота створено разом з інформацією, наданою під час реєстрації.

Нова версія (доступна з 5 лютого 2024 року)

Починаючи з 5 лютого 2024 року, Viber змінив умови створення та підключення чат-ботів.

Тепер послуга є платною.

Чат-боти, створені до цієї дати, продовжують працювати на попередніх умовах.

Докладніше тут.

Згідно з комерційною пропозицією Viber, плата в розмірі €100 стягується за кожного створеного або підключеного чат-бота.

Кожне повідомлення, надіслане ботом, входить до щомісячної плати, яку сплачує клієнт.

Ціна кожного повідомлення залежить від країни призначення.

Наприклад:

  • Росія — €0.0196
  • Білорусь — €0.0138
  • Україна — €0.0196
  • Казахстан — €0.0137

Якщо кількість повідомлень перевищує ліміт, покритий щомісячною платою в €100, можуть застосовуватися додаткові збори.

Для отримання додаткової інформації див. розділи Тарифна картка та Збори документації Viber.

Щоб підключити чат-бота до Viber, необхідно подати заявку на комерційних умовах.

Форма заявки виглядає наступним чином.

Форму заявки необхідно заповнювати англійською мовою.

Перекладений приклад форми (Рисунок 2 вище) наведено лише для довідки.

У полі Ваш запит вкажіть, що ви хотіли б підключити вже створеного чат-бота.

Після подання заявки фахівці Viber розглянуть її індивідуально та нададуть інструкції щодо подальших кроків інтеграції.

Перед поданням заявки, будь ласка, ознайомтеся з комерційною пропозицією Viber щодо створення та підключення чат-ботів.

Як отримати посилання на вашого бота Viber

Посилання на бота стає доступним одразу після підключення бота.

Через обмеження Viber ботів не можна знайти через пошук Viber.

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

Внутрішні посилання viber:// не розпізнаються багатьма браузерами або додатками.

Якщо ви хочете поширювати свого бота, ви можете:

  • використовувати міні-лендінги MaviBot;
  • скоротити посилання за допомогою сервісу, наприклад:

https://tinyurl.com/

Як створити карусель у Viber

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

Підтримувані формати зображень

  • JPEG
  • PNG

Максимальний розмір зображення

  • 500 КБ

Розглянемо приклад каруселі, що містить 3 картки.

Щоб створити картки, введіть наступний код у полі Калькулятор:

p =[{"title":"TITLE 1", "description": "DESCRIPTION ", "image": "IMAGE LINK 1", "buttons":[{"text":"BUTTON TEXT 1","color":"#4BB34B"}]}, {"title":"TITLE 1", "description": "DESCRIPTION ", "image": "IMAGE LINK 1", "buttons":[{"text":"BUTTON TEXT 1"}]}, {"title":"TITLE 2", "description": "DESCRIPTION ", "image": "IMAGE LINK 2", "buttons":[{"text":"BUTTON TEXT 2", "url":"LINK"}]}, {"title":"TITLE 3", "description": "DESCRIPTION", "image": "IMAGE LINK 3", "buttons":[{"text":"BUTTON TEXT 3"}]}]

r = send_carousel(p, '')

Спочатку збережіть масив, що містить title, description, image та buttons, у змінну p (ви можете використовувати будь-яке ім'я змінної). Потім використовуйте його в методі send_carousel(p, '').

Щоб зробити кнопку кольоровою, додайте додатковий параметр "color":"#4BB34B" до масиву buttons.

Колір потрібно вказувати у шістнадцятковому форматі, що починається з #.

Ви можете вибрати будь-який колір за допомогою палітри кольорів, наприклад:

https://htmlcolorcodes.com/

Ви можете вставляти URL-адреси в кнопки карток каруселі за допомогою параметра url. Коли клієнт натискає кнопку, він буде перенаправлений за вказаним посиланням, і посилання також буде отримано як повідомлення.

Кнопки карток каруселі також можуть містити параметр payload. Цей параметр не відображається клієнту, але дозволяє аналізувати вибір клієнта.

[
{
"title":"TITLE 1",
"description":"DESCRIPTION",
"image":"IMAGE LINK 1",
"buttons":[
{
"text":"BUTTON TEXT 1",
"color":"#4BB34B",
"url":"BUTTON LINK",
"payload":"1"
}
]
}
]

Якщо ви використовуєте кнопки з однаковим текстом, ви можете використовувати параметр payload. Він не видимий для клієнта, але дозволяє аналізувати вибраний користувачем варіант.

Поради та найкращі практики для ботів Viber

Під час створення ботів Viber слід знати кілька важливих особливостей.

Розуміння цих особливостей заощадить ваш час і допоможе повною мірою використовувати можливості Viber.

Як встановити перше повідомлення та створити кнопку заклику до дії

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

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

У цьому повідомленні ви повинні попросити клієнта:

  • натиснути кнопку; або
  • надіслати будь-яке повідомлення.

Інакше жодне з ваших наступних повідомлень не буде доставлено.

Після того, як користувач відповість, ви можете надсилати йому необмежену кількість повідомлень.

Мотиваційне перше повідомлення для Viber налаштовується в налаштуваннях проекту.

Кнопки, вбудовані в текст повідомлення, не надсилаються, коли користувач відкриває бота.

Слід використовувати лише кнопки клавіатури.

Після першої дії користувача ви можете надсилати будь-який контент без обмежень.

Приклад того, як виглядає перше повідомлення після відкриття бота:

Як знову протестувати перше повідомлення

Виконуйте ці кроки щоразу, коли тестуєте перше повідомлення.

Для цього:

  1. Видаліть розмову з розділу Клієнти в конструкторі.
  2. Видаліть розмову з ботом, натиснувши Видалити та відписатися.

Після цього повторне відкриття бота за посиланням знову викличе вітальне повідомлення.

Можливі помилки Viber

Якщо ви бачите наступне сповіщення в розмові з клієнтом у розділі Клієнти, це може означати одне з наступного:

  • Користувач відписався від ваших повідомлень (заблокував бота у своєму акаунті Viber).
  • Ви надіслали друге (або наступне) повідомлення до того, як користувач відповів на ваше перше повідомлення.
  • Ваше перше повідомлення містить кнопки всередині тексту.

Побудуйте потік розмови таким чином, щоб після першого повідомлення користувач або відповів, або налаштуйте поле Відповідь на перше повідомлення користувача в налаштуваннях конструктора.

Попросіть користувача надіслати вам відповідь або натиснути кнопку.

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

Кнопки всередині тексту повідомлення не допускаються.

Як правильно розпочати розмову

Блок, що містить #{none}, є обов'язковим.

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

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

Для Viber:

client_type = 2