Что такое uri в вайбере
Контакт-центр: Viber
Канал Viber позволяет создать открытую линию c помощью чат-бота Viber.
Для подключения канала Viber к открытым линиям Битрикс24 нам понадобится специальный параметр – Ключ, который выдается при создании бота Viber.
Создание чат-бота Viber для Битрикс24 происходит в партнерском аккаунте. Основные плюсы партнерского аккаунта – это простота создания бота и бесплатность, минусом же является отсутствие вашего бота в поиске Viber.
Создание бота Viber
Нам понадобится аккаунт партнера Viber. Для этого нужно пройти регистрацию:
Регистрация аккаунта партнера Viber проста:
Если у вас уже есть партнерский аккаунт, то просто авторизуйтесь и переходите к пункту 2.
Не забудьте нажать кнопку Сохранить.
Как это работает
Клиент заходит к вам на сайт, где подключен виджет Битрикс24, и выбирает способ общения Viber:
Если у клиента установлен десктоп-приложение Viber или клиент заходит с мобильного телефона, то при клике на иконку Viber произойдет подключение бота в контакт-лист Viber и далее можно будет общаться через открытую линию.
Если у клиента не установлено десктоп-приложение Viber (что чаще всего бывает), то при при клике на иконку Viber в браузере ничего не произойдет. 🙁 В таком случае, мы рекомендуем заходить на сайт с мобильного устройства или установить десктоп-приложение Viber – клик на иконке Viber откроет мобильное приложение Viber, и ваш бот добавится в контакты клиента.
У оператора весь диалог также происходит в чате на портале (в десктоп- и в мобильном приложении Битрикс24):
Особенности использования канала Viber:
Как создать 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.
И зарегистрируем вебхук выполнив файл:
Теперь, когда пользователь отправит сообщение, или зайдет в чат, по адресу вебхука будут отправлены запросы. Создадим файл bot.php :
Можно немного улучшить функционал бота и добавить логгирование. Сделаем это с помощью monolog:
Как создать чат-бота для Viber
Поговорим о создании простого чат-бота Viber для пересылки сообщения.
Термины и определения
Чат-бот Viber – программа Viber, реализованная через паблик-аккаунт, с которой пользователь может взаимодействовать для достижения какой-либо цели.
Паблик-аккаунты – специально созданные публичные аккаунты для общения и взаимодействия с клиентами (в том числе с помощью чат-ботов). Частным случаем паблик-аккаунтов являются паблик-чаты, где общается какая-либо группа людей.
Viber-ссылка – специальная ссылка для открытия контакта, чат-бота или другого ресурса в приложении Viber. Начинается с особого префикса viber://. Например: viber://pa?chatURI=hello2bot.
Создаем чат-бота
Создадим самого простого чат-бота для Viber. Почему самого простого? Потому что у новичков обычно возникает уйма вопросов. Естественно, такой простой чат-бот нужен для проверки того, что все работает. Тем более функционал простого бота можно расширять дальше по своему усмотрению.
Цель: бот будет пересылать обратно наше сообщение.
Если вы сами хотите развернуть хостинг, то можно использовать связку: Apache + PHP + MySQL, но лучше воспользоваться услугами хостинг-провайдера, где установлено все необходимое, например, Timeweb.
Технология работы бота проста:
А теперь пошаговый процесс создания (из 13 шагов):
1. Переходим на сайт разработки. Предварительно у вас на смартфоне должно быть установлено приложение Viber.
2. Вводим номер телефона и авторизуемся.
3. Viber пришлет код подтверждения – вводим его и нажимаем «Дальше».
4. Нажимаем кнопку «Создать бот» и заполняем необходимые поля:
5. Ставим галочку о принятии соглашения и нажимаем «Create».
6. После этого вы получите токен для аутентификации Viber. Скопируйте и сохраните его.
7. Теперь загрузите к себе на компьютер заготовку для чат-бота: github.com/the-lans/bots/tree/master/Viberbot
8. Распакуйте и откройте файлы index.php и php из папки Viberbot.
9. В этих файлах необходимо изменить некоторые параметры.
В файле index.php необходимо изменить:
В файле set_webhook.php необходимо изменить:
10. По требованию Viber на вашем сайте должен быть установлен сертификат SSL. Такой сертификат можно заказать как платно (например, Sectigo Positive SSL), так и бесплатно (SSL Let’s Encrypt). Подробнее о SSL-сертификатах читайте в Справочном центре.
11. Когда SSL-сертификат станет активным, заходим в панель хостинга Timeweb через файловый менеджер:
12. Установим вебхук для нашего бота в Viber. Заходим в браузер и запускаем файл set_webhook.php. Если все хорошо, выдается следующее сообщение (см. ниже). Если у вас не получилось установить вебхук, внимательно проверьте URL-адрес (соблюдение регистра букв) или корректность PHP-файла.
13. Заходим в Viber на смартфоне. Последовательно нажимаем в меню: Еще –> Паблик аккаунты –> HelloBot.
Если паблик-аккаунт скрыт, нажимаем «Показать».
Проверяем результат
В паблик-аккаунте нажимаем кнопку «Сообщение» и начинаем взаимодействие с ботом. Пишем любую фразу, бот должен нам ответить тем же. Если бот отказывается отвечать, проверьте корректность PHP-файла, наличие SSL-сертификата и пр.
Нами был успешно создан и запущен чат-бот для Viber. Теперь можно подумать о расширении его функционала. Документацию Viber REST API можно прочитать на официальном сайте мессенджера.
Создайте полноценного бота Viber Chat за 6 простых шагов
Чат Bot очень популярен в наши дни. С Chat Bot вы можете подключаться к своим клиентам с помощью Deeper Interactions и развивать свой бизнес.
В этой статье я расскажу, как разработать Viber Chat Bot за 6 простых шагов с использованием PHP.
1. Создать публичный аккаунт в Viber
2. Получить токен аутентификации
Токен аутентификации генерируется при создании публичной учетной записи и может быть просмотрен администратором учетной записи на экране «Изменить информацию» публичной учетной записи.
Пример токена : 455a0f2c05b4fe54-cb4e33d3200fbbae-95f29ebc06af09a8
Пример страницы детализации аккаунта для редактирования Viber
3. Настройте webhook
Настройка webhook будет выполнена путем вызова API set_webhook с действительным и сертифицированным URL.
После отправки запроса set_webhook Viber отправит обратный вызов в webhook, чтобы проверить его доступность и вернет ответ пользователю.
Вызовите запрос POST к этому API:
https://chatapi.viber.com/pa/set_webhook
Параметры публикации:
auth_token = Строка токена, предоставленная Viber при создании PA.
url = URL веб-крючка PA для получения обратных вызовов и сообщений от пользователей (должен использовать SSL, например, https)
event_type = (необязательно) Указывает типы событий Viber, о которых владелец PA хотел бы получать уведомления. Значения по умолчанию: [«доставлено», «увидено»]
После того, как мы вызовем set_webhook api, Viber отправит обратный вызов на URL-адрес webhook, чтобы подтвердить его доступность, т.е. https://mysite.com/webhook_page в приведенном выше примере. Формат данных обратного вызова следующий:
событие = тип обратного вызова – какое событие вызвало обратный вызов. Возможное значение – webhook.
timestamp = время события, которое вызвало обратный вызов
message_token = уникальный идентификатор сообщения
Теперь нам нужно дать ответ как
status = результат действия (0 для успеха, номер ошибки для ошибок)
status_message = Ok или причина
ошибки event_types = доставлено или замечено (еще не реализовано)
Код для 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
Общие параметры клавиатуры:
– Тип : Обязательный. Тип отображения клавиатуры (в настоящее время доступна только «клавиатура»).
– Кнопки : обязательно. Это массив, содержащий все кнопки клавиатуры по порядку.
– 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. Более того, это отправная точка для построения сложных ботов. Вы должны попытаться реализовать свои собственные ответы на различные сообщения.
Что такое Вайбер бот
Вайбер бот – это виртуальный робот-собеседник (ВС), который имитирует действия обычного пользователя (ведет диалог, отвечает на вопросы). Разработку можно создать самому, скачать готовый вариант, либо заказать персонального ВС у специалистов. Большинство клиентов выбирает личное проектирование, что делает робота эффективным, удобным, уникальным в общении.
Создание публичного аккаунта
Чтобы спроектировать собеседника, необходимо сначала зарегистрировать публичный аккаунт.
Сделать это можно следующим способом:
Отправлять сообщения в паблике могут только администраторы.
Детальная информация видна на видео:
Варианты интеграции виртуального собеседника
Существует два основных варианта интеграции чат-программы: через партнерскую сеть и API. Рассмотрим каждый отдельно.
Через официальных партнеров
Для этого способа прежде всего нужно зарегистрировать аккаунт партнера Вайбер.
Сделать операцию можно следующим образом:
После регистрации партнерской учетной записи необходимо создать бота в вайбере.
Для этого стоит следовать списку действий ниже:
Ваш аккаунт появится в поиске только после того, как наберет минимум 6 подписчиков.
Через API
Апи позволяет создать данную программу через PHP (распространенный язык программирования).
Существует два способа регистрации робота:
Тем, кто «подкован» в этой сфере, стоит написать приложение самому – это сэкономит деньги, но займет немало времени. Пользователям, которые не знакомы с программированием, лучше доверить создание системы профессионалу.
Рекомендации для бота
Чтобы программа была эффективной, нужно определить ее будущее назначение и принцип работы.
За назначением различают такие типы ВС:
Чат-робот экономит как время пользователя, который получает моментальный ответ, так и администратора, ведь тот не тратит его на общение с клиентами.
За принципом работы можно выделить три типа ВС:
Продвижение
Созданный виртуальный собеседник прежде всего требует рекламы и потока новых пользователей.
Вот список самых популярных методов продвижения робота-собеседника:
Указанные варианты продвижения помогут увеличить охват аудитории, привлечь новых пользователей, развить аккаунт.
Примеры
Использование чат-робота в сообществах значительно упростит процесс ведения дел, общения, ускорит проведение операций.
Но вместе с этим возникает ряд вопросов: «С какой целью его создавать?», «Каким именно он должен быть?».
Рассмотрим самые распространенные примеры:
Чтобы определить, каким будет ваш ВС, проанализируйте конкурентов, другие подобные боты, возможные варианты их разработки.
Выводы
Viber бот – это практичное, а также технологичное решение для сообществ. Устанавливать программу нетрудно. Приложение поможет сделать аккаунт интересным, функциональным, удобным.
Детальная информация видна на видео: