Как настроить бот вайбере

Создание полноценного Viberbot. Часть вторая — первый контакт или «сonversation_started»

Отправка первого сообщения пользователю — приветствуем и подписываем

В первой части мы научились запускать стартер устанавливать webhook для нашего проекта botviber.

В этой 2-й мы научимся отправлять первое сообщение показываемое для наших пользователей, создавать ссылки для поиска и запуска нашего бота как внутри ViberURL так и NoViberURL

Сформируем ссылки на бота

1) Oффлайн QR — его можно скачать из партнерской админки viber

2) Ссылка для месcенджера и передачи по мессенджеру ViberURL

3) Ссылка редирект NoViberURL в интернете много таких сократителей URL — но все они похожи на спам, поэтому рекомендую создать свой код из трех строк PHP и положить файл себе на хостинг, вот содержимое файла foot.php

Приветствия botviber или «event»: «conversation_started»

После открытия QR или перехода по ссылке на адрес нашего приложения от серверов Viber (Jetty) прилетают POST запросы с событием («event»: «conversation_started») а их полное содержимое имеет следующий вид:

И, прошу заметить, что в телеге chat_id один по всей сети мессенджера во всех всех ботах — как мобильный номер, а у вайбер id — он как токен и уникален в пределах одного вашего бота. В другом боте ваш id станет другим…

Обработаем их и ответим, чтобы получить один из трех ответов как на скрине выше
а) type=«text»
б) а тут мы видим классический случай type=«rich_media»
в) на третьем скрине Type=«keyboard»

Детальнее на viber REST API, а ниже рассмотрим как получить первый вариант

Как мы уже видим botviber можно забрендировать под любой бизнес либо мини магазинчик, также подогнать стили под ваш основной сайт

1) для обработки пользовательских сообщений в файле проекта myviberbot/views.py внесем изменения:

Перезапустим наш проект Django.

К сожалению «Rakuten Viber» никому не дает официальные страницы на PA и сообщество, исключения крупные бренды и публичные личности, поэтому для SEO продвижения и PR по соцсетям и др. рекомендую создать минилендинг — мелкая страница на которую переходят все с основного сайта или др. ресурсов вот образец:

Удачного запуска botviber.

В следующей статье мы разберем event[«message»], для обработки пользовательских сообщений, вы узнаете, что сделать чтоб вести диалог, как отделять следующие сообщения, вообще как botviber научить понимать, что это следующие.

(Создание полноценного Viberbot на Django 2 и Viber REST API. Часть третья — Message)

Источник

Как создать Viber-бота с помощью PHP

В ноябре 2016 года Viber внедрил публичные аккаунты (Viber public account, или просто PA). С их выходом стало доступно и api, которое позволяет:

• вести переписку с пользователем
• проверять статус подписчиков (онлайн, оффлайн)
• получить информацию о конкретном подписчике
• вносить записи (посты) на свою страницу

Все это позволяет создать довольно неплохого бота, или же интегрировать бота в уже существующий проект, что вполне может улучшить качество взаимодействие с пользователями. Если вы уже создавали ботов для telegram или slack — то создать бота для Viber не составит большого труда.

Вступление

Еще некоторое время назад у меня появилась необходимость взаимодействовать с пользователями вайбера. Хотелось бы внедрить в свое приложение типовые диалоги с пользователями, а еще предоставлять «кнопочные диалоги» (в тех случаях когда пользователь видит несколько кнопок под чатом). Но на тот момент открытого (публичного) API для этого не было, и приходилось либо отказываться либо изворачиваться с граблями.

С релизом публичных аккаунтов (PA) ситуация изменилась, теперь мы можем создать более полноценное взаимодействие с «кнопочными диалогами» и нужными нам «конверсиями». Все это здорово, если не одно НО — нет SDK для PHP (ради справедливости, есть sdk для nodejs и python). Именно этот пробел я решил заполнить, и описать как можно создать простого бота на php, и за одно создать SDK.

Первые шаги

В форме вы указываете телефон, к которому будет выдан доступ к публичным аккаунтам, и спустя некоторое время вы получите сообщения формата «. You now have early access to Public Accounts. «. После чего вам необходимо перезапустить Viber-клиент и пройти следующие шаги:

Открыть раздел «Публичные аккаунты» (иконка вверху справа — )

Нажать на «создать аккаунт» (иконка внизу справа — )

Заполнить данные для вашего бота (необходима фоновая картинка, указанная категория, имя, описание и прочее)

На последнем шаге будет доступен выбор способа работы с сообщениями, выберите «api» и скопируйте ключ. (или его можно просто посмотреть на экране «редактирования информации» PA):

Для примера, мой ключ будет: 1111111111111111-2222222222222222-3333333333333333

Серверная часть

Для разработки бота и работы с Viber-API я использую небольшой SDK: https://github.com/Bogdaan/viber-bot-php. Он позволит опустить некоторые подробности взаимодействия c REST-api и построить некоторую логику нашего бота. Установим его:

Для начала нам необходимо зарегистрировать адрес вебхука — тот адрес по которому бекенд вибера будет доставлять нам сообщения от пользователей и некоторые другие события. Веб сервер, на котором будет расположен бот (и соотвественно вебхук) обязательно должен работать по https с корректным SSL сертификатом. Самоподписанный сертификат тут не подойдет, если его нет — попробуйте использовать letsencrypt.org.

Для примера, мой вебхук будет: https://viber.hcbogdan.com/bot.php . Создадим файл setup.php :

И зарегистрируем вебхук выполнив файл:

Теперь, когда пользователь отправит сообщение, или зайдет в чат, по адресу вебхука будут отправлены запросы. Создадим файл bot.php :

Далее остается разместить файл bot.php так, чтобы он был доступен по https://viber.hcbogdan.com/bot.php , и перейти в чат с ботом из вибер клиента. Если вы не видите ответов бота, то стоит проверить ваш error_log и access_log на предмет наличия ошибок.

Можно немного улучшить функционал бота и добавить логгирование. Сделаем это с помощью monolog:

Источник

Что такое Вайбер бот

Вайбер бот – это виртуальный робот-собеседник (ВС), который имитирует действия обычного пользователя (ведет диалог, отвечает на вопросы). Разработку можно создать самому, скачать готовый вариант, либо заказать персонального ВС у специалистов. Большинство клиентов выбирает личное проектирование, что делает робота эффективным, удобным, уникальным в общении.

Создание публичного аккаунта

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

Сделать это можно следующим способом:

1. Открыть вкладку чатов в мобильном приложении.
2. Нажать кнопку «+» снизу справа страницы.
3. Выбрать «Создать Сообщество».
4. Выделить контакты, которые будут добавлены в паблик.
5. Ввести информацию о будущем аккаунте (название, иконка, описание).
6. Нажать «Готово».

Отправлять сообщения в паблике могут только администраторы.

Детальная информация видна на видео:

Варианты интеграции виртуального собеседника

Существует два основных варианта интеграции чат-программы: через партнерскую сеть и API. Рассмотрим каждый отдельно.

Через официальных партнеров

Для этого способа прежде всего нужно зарегистрировать аккаунт партнера Вайбер.

Сделать операцию можно следующим образом:

• перейти по ссылке;
• указать свой мобильный номер, который уже подключен к системе;
• ввести код подтверждения;
• указать почту, придумать пароль в системе;
• для создания страницы нажать «Далее», перейти во вкладку управления аккаунтом, авторизоваться.

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

Для этого стоит следовать списку действий ниже:

1. После авторизации выбрать команду «Создать бот» во вкладке слева.
2. Ввести необходимые данные учетной записи, загрузить фото.
3. Указать описание аккаунта, почту.
4. Скопировать полученный апи-ключ.

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

Через API

Апи позволяет создать данную программу через PHP (распространенный язык программирования).

Существует два способа регистрации робота:

• самостоятельное программирование;
• создание системы специалистом на заказ.

Тем, кто «подкован» в этой сфере, стоит написать приложение самому – это сэкономит деньги, но займет немало времени. Пользователям, которые не знакомы с программированием, лучше доверить создание системы профессионалу.

Рекомендации для бота

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

За назначением различают такие типы ВС:

• информационный (предоставляет данные согласно запросу пользователя о товаре, услуге, проекте);
• развлекательный (общение с клиентами);
• консультационный (онлайн-консультант, помогающий при выборе товара/услуги, отвечающий на вопросы);
• вспомогательный (для внутренних нужд или для помощи клиентам при проведении операций);
• искусственный интеллект (анализирует информацию, может заменить обычного работника или консультанта).

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

За принципом работы можно выделить три типа ВС:

• работающие с помощью кнопок или команд (просто создаются);
• текстовые ВС (дают пользователю больше информации, нежели предыдущие);
• роботы с распознаванием речи человека (сложный алгоритм создания, более удобное использование).

Продвижение

Созданный виртуальный собеседник прежде всего требует рекламы и потока новых пользователей.

Вот список самых популярных методов продвижения робота-собеседника:

• скопировать ссылку на программу, прикрепить ее на своих страницах в соцсетях, сайтах, пабликах;
• опубликовать робота в каталоге Viber (на данный момент функция приостановлена);
• сделать QR-код программы, поместить его на улицах города, на собственных товарах и т.д.;
• заказать рекламу у блогеров, сайтов, сообществ.

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

Примеры

Использование чат-робота в сообществах значительно упростит процесс ведения дел, общения, ускорит проведение операций.

Но вместе с этим возникает ряд вопросов: «С какой целью его создавать?», «Каким именно он должен быть?».

Рассмотрим самые распространенные примеры:

• робот-собеседник Comedy Club. Эта программа позволяет за несколько кликов найти нужный выпуск шоу и просмотреть его, уведомляет о выходе новой серии;
• чат-робот Зоряна. Это бот мобильного оператора Киевстар, который отвечает на вопросы, помогает разобраться в системе, устраняет неполадки сети;
• ВС футбольного клуба «Барселона». Помогает болельщикам узнавать все новости из жизни ФК, найти нужную информацию, уведомляет о предстоящих играх;
• GorodRabot. Помогает находить вакансии на рынке труда, предоставляет данные о новых свободных должностях;
• бот Почты России. Дает информацию о прибытии, отправке, доставке посылки, отслеживает ее, рассчитывает стоимость услуг.

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

ВАЖНО! С 1 апреля 2019 года Viber начал взимать плату с владельцев виртуальных собеседников: $4500 ежемесячно за отправку до 500 тысяч сообщений, $6500 – за возможность отправки до 1 миллиона сообщений.

Выводы

Viber бот – это практичное, а также технологичное решение для сообществ. Устанавливать программу нетрудно. Приложение поможет сделать аккаунт интересным, функциональным, удобным.

Детальная информация видна на видео:

Источник

Создайте полноценного бота Viber Chat за 6 простых шагов

Чат Bot очень популярен в наши дни. С Chat Bot вы можете подключаться к своим клиентам с помощью Deeper Interactions и развивать свой бизнес.

В этой статье я расскажу, как разработать Viber Chat Bot за 6 простых шагов с использованием PHP.

1. Создать публичный аккаунт в Viber

Чтобы начать, прежде всего, вы должны иметь учетную запись Viber Public. Если у вас нет публичной учетной записи, подайте заявку на публичную учетную запись на странице публичных учетных записей Viber .
Как только ваша заявка будет одобрена, вам будет отправлено сообщение с приглашением, чтобы начать создание вашей публичной учетной записи. Чтобы создать учетную запись, вам необходимо:
• Перезагрузить устройство.
• Войдите на главный экран Публичных счетов. Вы увидите кнопку Создать публичные аккаунты .
• Нажмите на кнопку, и начните!

2. Получить токен аутентификации

Токен аутентификации генерируется при создании публичной учетной записи и может быть просмотрен администратором учетной записи на экране «Изменить информацию» публичной учетной записи.

Пример токена : 455a0f2c05b4fe54-cb4e33d3200fbbae-95f29ebc06af09a8

Пример страницы детализации аккаунта для редактирования Viber

3. Настройте webhook

Как только токен будет получен, вы сможете настроить webhook своей учетной записи . Этот веб-крючок будет использоваться для получения обратных вызовов и пользовательских сообщений от Viber.

Настройка webhook будет выполнена путем вызова API set_webhook с действительным и сертифицированным URL.

После отправки запроса set_webhook Viber отправит обратный вызов в webhook, чтобы проверить его доступность и вернет ответ пользователю.

Примечание . Перед отправкой запроса в API set_webhook нам необходимо иметь код для обработки обратного вызова из Viber по нашему URL-адресу webhook. Пример кода PHP приведен в этой статье.

Вызовите запрос POST к этому API:
https://chatapi.viber.com/pa/set_webhook
Параметры публикации:

auth_token = Строка токена, предоставленная Viber при создании PA.
url = URL веб-крючка PA для получения обратных вызовов и сообщений от пользователей (должен использовать SSL, например, https)
event_type = (необязательно) Указывает типы событий Viber, о которых владелец PA хотел бы получать уведомления. Значения по умолчанию: [«доставлено», «увидено»]

Чтобы сделать запрос POST к API set_webhook , мы можем использовать cURL или такие инструменты, как POSTMAN. Вот пример кода PHP:

После того, как мы вызовем set_webhook api, Viber отправит обратный вызов на URL-адрес webhook, чтобы подтвердить его доступность, т.е. https://mysite.com/webhook_page в приведенном выше примере. Формат данных обратного вызова следующий:

событие = тип обратного вызова – какое событие вызвало обратный вызов. Возможное значение – webhook.
timestamp = время события, которое вызвало обратный вызов
message_token = уникальный идентификатор сообщения

Теперь нам нужно дать ответ как

status = результат действия (0 для успеха, номер ошибки для ошибок)
status_message = Ok или причина
ошибки event_types = доставлено или замечено (еще не реализовано)

Это установит URL-адрес webhook . Теперь, когда происходит событие, связанное с публичной учетной записью, обратный вызов отправляется на URL-адрес webhook, и нам нужно обрабатывать события в URL-адресе webhook, которые обсуждаются ниже.

Код для URL веб-крючка:

4. Получить сообщение

Всякий раз, когда пользователь отправляет сообщение в общедоступную учетную запись в чате 1-к-1, в URL-адрес webhook отправляются следующие данные обратного вызова.

событие = в случае сообщения, отправленного пользователем, значением события будет
отметка времени сообщения = время события, вызвавшего обратный вызов
message_token = уникальный идентификатор
отправителя сообщения = сведения об отправителе (идентификатор, имя, аватар)
сообщение = подробности сообщения, такие как текст, медиа ( если есть) и так далее

Таким образом, мы можем получить сообщение от пользователя и соответствующее сообщение может быть отправлено пользователю, что будет обсуждаться ниже.

5. Отправить сообщение

Чтобы отправить сообщение пользователю, нам нужно вызвать запрос Post на send_message api, как показано ниже:

Отправка текстового сообщения:
URL: https://chatapi.viber.com/pa/send_message
Параметры публикации:

auth_token = Строка токена, предоставленная Viber при создании публичной учетной записи.
получатель = уникальный идентификатор пользователя viber, которому отправляется сообщение.
тип = тип сообщения («текст» для текстовых сообщений)
текст = текстовое сообщение для отправки

auth_token = Строка токена, предоставленная Viber при создании публичной учетной записи.
получатель = уникальный идентификатор пользователя viber, которому отправляется сообщение
тип = тип сообщения («картинка» для изображения)
текст = описание фотографии (может быть нулевым, если не требуется)
media = URL-адрес изображения (поддерживается только JPEG)
thumbnail = уменьшенное изображение URL (поддерживается только JPEG)

Точно так же мы также можем отправлять файловые сообщения.

6. Отправить клавиатуру (Меню)

API общедоступной учетной записи позволяет отправлять пользовательскую клавиатуру с помощью API send_message, чтобы предоставить пользователю набор предопределенных ответов или действий. Клавиатура может быть прикреплена к любому типу сообщения или отправлена ​​на него. После получения клавиатура будет отображаться пользователю вместо родной клавиатуры устройства.

К сообщению можно прикрепить клавиатуру следующим образом:
URL: https://chatapi.viber.com/pa/send_message
Параметры публикации:

Изображение для клавиатуры может быть:

Пример меню чата Viber

Все параметры такие же, как и при отправке обычного текстового сообщения, за исключением клавиатуры param .
Массив кнопок содержит массив кнопок согласно требованию.

Общие параметры клавиатуры:
– Тип : Обязательный. Тип отображения клавиатуры (в настоящее время доступна только «клавиатура»).
– Кнопки : обязательно. Это массив, содержащий все кнопки клавиатуры по порядку.
– BgColor : необязательно. Цвет фона клавиатуры должен быть задан шестнадцатеричным значением.
– DefaultHeight : необязательно. Возможные значения: true или false.
Параметры массива кнопок
Следующие параметры могут быть определены для каждой кнопки в массиве «кнопок» отдельно. Каждая кнопка должна содержать хотя бы один из следующих необязательных параметров: текст, BgMedia, изображение, BgColor.
– Столбцы: ширина кнопки в столбцах. возможные значения 1-6.
– Rows: высота кнопки в строках. возможные значения 1 и 2.
– BgColor: цвет фона для предоставления шестнадцатеричного значения.
– BgMediaType: тип фонового носителя. Возможные значения: картинка или гифка.
– BgMedia: URL-адрес для фонового мультимедиа (изображение или рисунок)
– BgLoop: возможные значения: true или false.
– ActionType: тип действия при нажатии на кнопку. Возможные значения: reply или open-url. reply отправит ответ как обычное сообщение, а open-url откроет ссылку.
– ActionBody: текст для ответа, если ActionType является ответом, и ссылка для открытия, если ActionType имеет открытый URL-адрес.
– Изображение: URL-адрес изображения для размещения поверх фона.
– Текст: текст для отображения в кнопке.
– TextVAlign: вертикальное выравнивание текста. Возможные значения: верх или середина, или снизу.
– TextHAlign: горизонтальное выравнивание текста. Возможные значения: слева или по центру или справа.
– TextOpacity: непрозрачность текста. Возможные значения 1-100.
– TextSize: размер текста. Возможные значения: маленький или обычный или большой.

Текст кнопки может поддерживать некоторые теги HTML:

Получение информации об общедоступной учетной записи
Чтобы получить информацию об общедоступной учетной записи, вам нужно вызвать get_account_info api следующим образом:
url: https://chatapi.viber.com/pa/get_account_info
Параметры публикации:

где auth_token – строка токена, предоставленная Viber при создании публичной учетной записи.

Таким образом, вы можете разработать простой чат-бот для Viber, используя PHP. Более того, это отправная точка для построения сложных ботов. Вы должны попытаться реализовать свои собственные ответы на различные сообщения.

Обновления . Получив множество запросов от читателей, мы расширили чат-бота Viber, добавив в него такие структурные сообщения, как меню клавиатуры, изображения, ссылки и так далее. Пожалуйста, просмотрите статью ниже, чтобы найти живой пример.

Источник