JAICP

Vonage как входящий канал


Vonage — платформа облачных коммуникаций, которая предоставляет API-интерфейсы для реализации телефонных номеров, отправки и приема SMS, отправки сообщений в мессенджерах WhatsApp и Facebook Messenger, а также для совершения звонков.

Для использования Vonage как входящего канала:

  1. Настройте сервис Vonage.
  2. Создайте канала в JAICP.
  3. Создание приложения.
  4. Тестирование бота.

Настройка сервиса

Авторизуйтесь в сервисе Vonage.

На странице Getting started скопируйте значения токенов Key и Secret. Токены понадобятся на этапе подключение бота к каналу.

Создание канала в JAICP

Перейдите в платформу, нажмите на панели управления Каналы > Создать канал. В разделе Мессенджеры и соцсети выберите Vonage.

Заполните поля:

  • Название — укажите название для канала или оставьте по умолчанию.
  • Токен — оставьте пустым.
  • Тип аутентификации — выберите способ аутентификации.

Bearer Token тип аутентификации для тестирования сервиса, запросите токен у представителей Vonage. Basic Autorization используется для активного подключения.

Для Basic Autorization:

  • API Key — укажите токен Key, который вы скопировали ранее на странице Getting started сервиса Vonage.
  • API Secret — укажите токен Secret, который вы скопировали ранее на странице Getting started сервиса Vonage.

Для Bearer Token:

  • Bearer Token — укажите Bearer Token.

После заполнения полей аутентификации:

  • Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
  • Оператор — выберите операторский канал или оставьте поле пустым.
  • Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).

Публикацию или деплой сценария нужно выполнять перед запуском чат-бота. На этом этапе происходит сборка чат-бота, проверка синтаксиса сценариев и скриптов, а также проверка прохождения тестов.

Нажмите Создать.

Нажмите на иконку Перейдите в настройки канала > Редактировать. Теперь вы находитесь в настройках канала.

Скопируйте Status URL и Inbound URL, данные понадобятся на этапе подключения приложения.

Создание приложения

Вернитесь в сервис Vonage. На панели управления нажмите Messages and Dispatch > Create an application.

Заполните поля:

  • Application name — укажите название для приложения.
  • Status URL — укажите токен Status URL, который вы скопировали ранее из настроек канала.
  • Inbound URL — укажите токен Status URL, который вы скопировали ранее из настроек канала.

Нажмите Create application.

На странице Numbers добавьте номера, чтобы связать их с приложением > Next. Далее свяжите внешние учетные записи мессенджеров с приложением, чтобы использовать их в качестве канала связи. Нажмите Done.

Тестирование бота

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