Интеграция с Viber

 

Создание Viber бота

 

Внимание! С 05.02.2024 для создания чат-ботов в Viber, необходимо напрямую подать заявку у них на сайте. После того, как заявка будет одобрена, вы сможете приступить к подписанию контракта и согласию с положениями и условиями.

Есть два способа подать заявку на чат-бота:

  1. Самый простой и быстрый вариант — обратиться к одному из проверенных официальных партнеров Viber. Партнеры не только помогут вам подать заявку на чат-бота, но также предложат свой обширный опыт и консультации.
  2. Кроме того, вы также можете напрямую связаться напрямую с командой Viber по ссылке. Они вручную проверят заявку и посоветуют вам дальнейшие действия, а также ответят на любые вопросы.

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

 

После того, как вашу заявку рассмотрят и одобрят, вы получите API-ключ (API-key) бота, который сможете использовать для подключения бота к HelpDeskEddy, чтобы принимать обращения от пользователей или инициировать переписку с ними.

 

Для подключения бота к HelpDeskEddy необходимо:

  • перейти из Управления в раздел "Настройка каналов связи" и нажать на кнопку "Добавить канал":

 

 

  • выбрать канал "Viber", департамент к которому он будет подключен и ввести ключ бота (API token):

 

 

  • нажмите на кнопку "Синхронизировать и сохранить". При успешном подключении, вы получите сообщение об успешном сохранении настроек:

 

 

После подключения бота к системе, для проверки его работоспособности перейдите по ссылке: 

viber://pa?chatURI=*

где * - имя Вашего бота (Account Name/URI). Для этого на устройстве, где открывается ссылка, должен быть установлен Viber.

 

Особенности работы

 

Обращаем внимание: чат-боты, созданные до 05.02.2024, в настоящее время работают на основе предыдущей коммерческой модели, описанной в этой статье.

Для чат-ботов, созданных начиная с 05.02.2024, действует новая коммерческая модель, и именно о ней пойдет речь ниже.

 

Для начала разберемся с общими положениями. Сообщения, которыми обмениваются чат-боты, делятся на три категории:

  • Приветственное сообщение: чат-боты могут отправить одно приветственное сообщение пользователю сразу после открытия беседы, прежде чем пользователь подпишется. Приветственные сообщения не тарифицируются. Используйте это сообщения для представления чат-бота, ознакомления пользователя с пользовательским интерфейсом и функциями вашего чат-бота, предоставления информации и поощрения пользователя подписаться на чат-бота.
     
  • Сообщение сессии чат-бота: сообщение, которым обмениваются чат-бот и его подписчики во время сессии диалога. Количество сообщений в сессии не ограничено.
     
  • Сообщение, инициированное чат-ботом: платное исходящее сообщение, отправленное владельцем чат-бота своему подписчику.

 

Сессия

Сессия - это 24-часовое временное окно, которое активируется, когда подписчик чат-бота отправляет сообщение чат-боту. Сессия также активируется, когда подписчик отвечает на сообщение, инициированное чат-ботом. По истечении 24 часов сессия автоматически завершается. Следующая сессия активируется, как только подписчик отправит новое сообщение.

 

Сообщение, инициированное чат-ботом

Сообщение, отправленное чат-ботом своему подписчику, классифицируется как инициированное чат-ботом, если в этот момент между чат-ботом и подписчиком нет активной сессии. 

Сообщения, инициированные чат-ботом, - это платная функция, которая помогает чат-ботам активно привлекать своих подписчиков. Обратите внимание, что если подписчик отвечает на инициированное сообщение, то активируется сессия, и впоследствии все сообщения, обмен которыми происходит в течение этой сессии (24 часа), не тарифицируются.

Чтобы начать разговор с абонентом, чат-бот может отправлять полный набор типов и форматов сообщений: текст, картинки, видео, файлы, стикеры и т.д. Чтобы отправлять такие сообщения, владельцы чат-ботов должны согласиться с коммерческими условиями Rakuten Viber для чат-ботов.


Внимание! Каждый календарный месяц с владельцев чат-ботов взимается плата за обслуживание в размере 100 евро за каждого бота, а также отдельно тарифицируются сообщения инициированные чат-ботом. Стоимость, применяемая к каждому сообщению, инициированному чат-ботом, зависит от кода страны номера телефона, под которым подписчик чат-бота зарегистрировался в Rakuten Viber.

Обязательно ознакомьтесь с тарифами перед началом работы с чат-ботом Viber!


 

Обработка обращений из Viber

 

При поступлении обращения к подключённому боту, запрос поступит в Вашу систему и отобразится как в интерфейсе "Омни", так и в разделе "Заявки" в виде обычного обращения с темой  , а также будет добавлен контакт Viber в карточку пользователя:

 

 

Для клиента общение будет происходить внутри мессенджера как обычный чат, например: