Viber

Максимальная длина текстового сообщения: 1000 символов

Viber не позволяет автоматически получать номер телефона клиента.

Как подключить Viber

Старая версия

Эта версия применима только к пользователям, создавшим своего чат-бота до 5 февраля 2024 года.

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

Сначала перейдите по ссылке ниже и войдите на сайт.

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

Затем создайте публичный аккаунт для вашего бота.

Выберите изображение и заполните все обязательные поля.

Поле Описание
Название аккаунта Имя бота. Его можно изменить позже.
Uri Имя пользователя бота. Используется для генерации ссылок на бота.
Категория Укажите категорию вашего бизнеса (например, Местный бизнес).
Подкатегория Укажите подкатегорию бизнеса (например, Автомобильный бизнес).
Язык Язык бота.
Описание аккаунта Описание бота, видимое всем подписчикам.
Адрес веб-сайта Ваш веб-сайт.
Адрес электронной почты Контактный адрес электронной почты.
Местоположение Местоположение бизнеса.

В регистрационной форме есть переключатель "Аккаунт содержит контент для взрослых."

НЕ ВКЛЮЧАЙТЕ ЭТУ ОПЦИЮ!

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

Примите лицензионное соглашение и нажмите Создать.

Если все было выполнено правильно, вы получите токен вашего бота.

Он понадобится вам для следующего шага.

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

Остался только один шаг — подключить его к Mavibot.

Перейдите в раздел Каналы и выберите Viber.

Введите полученный токен.

Нажмите Готово, чтобы подключить бота к Mavibot.

Вы получите уведомление в мобильном приложении 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