HelpDeskEddy

Подключите бота к HelpDeskEddy и начните обрабатывать обращения пользователей

Вы можете самостоятельно настроить интеграцию с HelpDeskEddy и начать обрабатывать обращения пользователей с использованием нашего бота.

Настройте интеграцию

На портале перейдите в раздел Настройки --> Подключения своего бота и включите интеграцию HelpDeskEddy. Заполните API секцию:

  • Домен – Ваш домен HelpDeskEddy.
  • Почта – почта сотрудника в HelpDeskEddy.
  • API ключ – создаётся по пути: Контакты → выбор сотрудника → API key
    (на странице https://<ваш домен>.helpdeskeddy.com/ru/contacts/).

Если все три параметра заполнены верно, появится возможность выбрать агента:

  • Агент (опционально) – сотрудник, на которого будут переводиться обращения, в случае если бот не нашел ответа, либо пользователь позвал оператора.

  • Также придумайте название метки, на которую будет реагировать Wikibot, например wikibot

Дополнительные настройки

Вы можете включить следующие опции в зависимости от нужного сценария работы:

  • Посылать ответ как заметку — ответы бота будут видны только агентам, пользователи их не увидят.

  • Вести отдельные беседы для каждого пользователя — предотвращает смешивание сообщений от разных пользователей в одном тикете. В журнале сообщений бота тикет будет в формате {hde-ticket-id}-{hde-user-id}.

  • Отправлять сообщения как ответ — связывает ответ бота с конкретным сообщением пользователя.

    ⚠️ Обратите внимание: если канал HelpDeskEddy не поддерживает ответы на сообщения, включение этой опции приведёт к тому, что ответы будут содержать технический префикс {hde-reply-cn:MessageId} из-за особенностей реализации в HelpDeskEddy.

Нажмите Добавить, чтобы сохранить интеграцию.

Скопируйте Webhook

В настройках интеграции скопируйте в буфер обмена Webhook URL Вашего бота.
Image

Настройте правило для добавления метки Wikibot

Wikibot будет обрабатывать только те заявки, которые содержат метку. Если метка сбрасывается, Wikibot перестает реагировать на заявку.

Для создания правила, перейдите по пути: «Управление» → «Диспетчер» и нажмите кнопку «Добавить правило».

Нужно задать обязательное условие:

  • Новая заявка.

Также задайте действие:

  • Добавить метки - используйте название, которое вы придумали в пункте 1.

Image

Настройте правило для новых заявок

На странице правил, добавьте новое правило для входящих заявок.

Нужно задать обязательное условие:

  • Новая заявка.

Также опционально можно задать дополнительное условие:

  • Автор последнего ответа - Равно - Клиент

Действие:

  • Отправить вебхук, тип запроса POST, формат JSON, без авторизации.
  • Укажите URL, который вы скопировали в пункте 2.
  • Укажите тело запроса:
{
  "id": {ticket_id},
  "message": "{answer_last}",
  "tags": "{ticket_tags}",
  "userId": {user_id},
  "files": "{last_answer_attachments_links}"
}

Image

Настройте правило на изменение заявки

На странице правил, добавьте новое правило для изменения заявок. Правило будет срабатывать, когда в заявке появляются новые ответы.

Нужно задать обязательное условие:

  • Новый ответ в завке.

Также нужно задать два дополнительных условия:

  • Автор последнего ответа - Равно - Клиент
  • Метки заявки - Содержит - wikibot (название метки, которое вы придумали в пункте 1)

Действие:

  • Отправить вебхук, тип запроса POST, формат JSON, без авторизации.
  • Укажите URL, который вы скопировали в пункте 2.
  • Укажите тело запроса:
{
  "id": {ticket_id},
  "message": "{answer_last}",
  "tags": "{ticket_tags}",
  "userId": {user_id},
  "files": "{last_answer_attachments_links}"
}

Image

Проверьте работу бота

Ваш чат-бот для обработки обращений готов! Проверьте его работу в любом из каналов HelpDeskEddy.

Если у вас остались вопросы по интеграции, напишите нам.