Перейти к основному содержимому

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>.

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

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