Lalexi
РуководствоПодключения

Viber-бот

Как подключить бота Viber к Lalexi: заявка на бота через партнёра Rakuten Viber, что в ней спрашивают, и вставка токена аутентификации.

Viber подключается ботом: вы берёте токен аутентификации в админке своего бота и вставляете его в Lalexi.

Что нужно

  • Созданный Viber-бот и доступ к его токену. Бота не заводят самостоятельно: заявку подаёт официальный партнёр Rakuten Viber — у нас это Infobip, — а Viber проверяет компанию и сценарий. Если бота ещё нет, начните с раздела ниже.
  • Свободный слот в лимите подключений.

Если бота ещё нет: заявка через партнёра

Заявку заполняет партнёр, но все данные в ней — ваши. Собрать их лучше заранее, одним списком:

Что спрашиваютКаким оно должно быть
Имя ботаТо, что увидят пользователи в приложении. Уникально на весь Viber, до 40 символов.
URIИз него собирается ссылка-приглашение на бота. До 28 символов, латиница и цифры, без пробелов; обычно совпадает с именем.
Юридическое названиеПолное название компании из регистрационных документов, вместе с формой — LLC, LTD, «ООО».
Бенефициарный владелецФизлицо, которое прямо или косвенно контролирует компанию либо владеет долей от 25%. Владельцев двое и больше — партнёр проводит отдельную проверку.
КатегорияИз списка Viber: Companies, Local Businesses, Brands & Products, People, Places of Interest, Groups, Organizations & Institutions, Entertainment.
Описание ботаКороткая строка, которую видно пользователям в приложении.
СтраныГде бот будет работать.
СценарийЧто бот отвечает и чем полезен пользователю. Viber смотрит на это перед одобрением.

Бот у Rakuten Viber платный для владельца. Берётся ежемесячная плата за самого бота и отдельно — за сообщения, которые бот отправляет первым; ответы внутри диалога, начатого пользователем, в эту плату входят. Точные ставки называет партнёр, и согласовать их лучше до подачи заявки.

После одобрения у бота появляется токен аутентификации — с ним и подключаются.

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

  1. Откройте админку вашего Viber-бота и скопируйте токен аутентификации.
  2. В Lalexi откройте Настройки → Источники (Settings → Inboxes), нажмите Добавить источник (Add Inbox), выберите плитку Viber Bot и нажмите Подключить — откроется вкладка с формой.
  3. Вставьте токен и нажмите Connect.
  4. Когда появится «Connected», закройте вкладку и вернитесь в Lalexi: источник появится со статусом Подключено.

Форма вставки токена Viber-бота

Токен — это полный доступ к боту. Lalexi хранит его в зашифрованном виде, но сам токен никому не пересылайте. Если он утёк — перевыпустите его в админке бота и подключите бота заново.

Что бот умеет и чего не умеет

  • Отвечает только тем, кто написал первым. Канал недоступен в «Новое сообщение», рассылках и прогреве.
  • Нет списка чатов и истории — диалог появляется сам с первым входящим сообщением, настраивать синхронизацию нечего.
  • Только личные диалоги один-на-один.

Если что-то не так

СимптомЧто делать
Форма пишет, что ссылка больше не действуетСсылка живёт 30 минут. Вернитесь в «Добавить источник» и выберите Viber Bot заново.
Токен не принимаетсяПроверьте, что скопирован токен аутентификации бота целиком, без пробелов по краям.
Бот подключён, но диалогов нетТак и должно быть, пока клиент не написал боту первым.
Бота негде создатьТак и есть: самостоятельного создания у Rakuten Viber нет — заявку подаёт партнёр, см. выше.

Нужно писать клиентам первыми по номеру телефона — это другой канал Viber: Viber Business.

Содержание