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