JAICP

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


Zendesk Chat — программное обеспечение онлайн-чата.

Подключить бота к каналу Zendesk Chat можно только на тарифном пакете для предприятий.

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

  1. Настройте сервис Zendesk Chat.
  2. Создайте канал в JAICP.
  3. Разработайте сценарий.
  4. Протестируйте бота.

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

Зарегистрируйтесь или авторизуйтесь в сервисе Zendesk Chat. Вы попадете на страницу Support — рабочее пространство агента Zendesk Chat.

Затем в правом верхнем углу нажмите    и выберите Chat. Здесь вы сможете подключить бота и настроить обмен сообщениями.

Клиент API

Нажмите на панели управления Настройки > Аккаунт. Выберите вкладку API и SDK и нажмите Добавить клиента API.

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

  • Клиентское имя — имя, которое видят пользователи при запросе доступа от вашего приложения или при просмотре списка приложений, к которым предоставлен доступ.
  • Компания — название компании, которое будет отображаться, когда пользователей просят разрешить доступ к вашему приложению.
  • URL для перенаправления — URL-адреса, на которые служба Zendesk Chat должна перенаправлять пользователей, когда они разрешат или запретят вашему приложению доступ к Zendesk Chat.

Нажмите Создать клиент API.

Скопируйте ID и секретный ключ клиента. Они понадобятся вам далее при получении токена.

Токен

Для получения токена пройдите авторизацию по протоколу OAuth.

Введите в поисковой строке следующий адрес:

https://www.zopim.com/oauth2/authorizations/new?response_type=token&redirect_uri={URL для перенаправления}&client_id={ID клиента}&scope=read%20write%20chat&subdomain={поддомен}

Здесь:

  • redirect_uri — URL-адрес для перенаправления. Прежде чем вставить адрес, его необходимо преобразовать в кодировку ASCII.
  • client_id — ID клиента, который вы скопировали ранее.
  • subdomain — поддомен вашего аккаунта. Вы можете скопировать поддомен из адресной строки браузера: https:/{subdomain}.zendesk.com/.

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

https://{URL для перенаправления}/#access_token={значение токена}&token_type=bearer&scope=read+write+chat

Оператор

Создайте аккаунты для операторов. Для этого нажмите на панели управления Настройки > Агенты > Добавить агента, введите данные оператора.

Для добавления аккаунтов в отдел нажмите на панели управления Настройки > Отделы > Создать отдел.

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

Перейдите в платформу JAICP, нажмите на панели управления Каналы > Создать канал. В разделе Другие выберите Zendesk Chat.

Укажите настройки:

  • Название — название канала.

  • Токен — токен, который вы скопировали ранее.

  • Ветка — ветка проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.

  • Публикация — способ публикации проекта:

    • Автоматически после каждого сохранения изменений в проект;
    • Вручную с помощью кнопки Опубликовать в строке с описанием канала.

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

Нажмите Создать. Дождитесь всплывающего окна с результатом деплоя.

Разработка сценария

При разработке сценария обратите внимание на следующие особенности:

  • Вы можете указать отдел, на который будет осуществлен перевод. Например:
state: Transfer to agent
    intent!: /agent
    a: Секунду, перевожу вас на оператора!
    script:
        $response.zopim = {
            needResponse: true,
            departmentName: 'Just AI'
        };
        # ...
  • Вы можете добавить определенные теги на диалог:
state: Tags
    # ...
    script:
        $response.zopim = {
            tags: ["tag1", "tag2"]
        };
        # ...
  • При добавлении кнопок необходимо обязательно добавить текстовое сообщение. Например:
state: Authorization key
    # ...
    a: Вы получили ключ авторизации?
    buttons:
        "Да"
        "Нет"
    # ...

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

Чтобы протестировать работу бота, измените статус чата на Онлайн. Для этого в правом верхнем углу нажмите    и выберите Support. Затем в правом верхнем углу нажмите    и выберите Онлайн. Теперь ваш бот сможет получать сообщения от клиентов.

Далее вернитесь на вкладку    > Chat. На панели управления откройте Настройки > Виджет > Встроить Web Widget. Скопируйте скрипт и вставьте его в HTML-код вашего веб-сайта между тегами <head>.

Скрипт необходимо вставить на каждую страницу, на которой должен отображаться виджет.

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