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

1

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

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

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

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

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

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

Можно выбрать пункт Посылать ответ как заметку, тогда ответы бота будут видеть только агенты, пользователи видеть их не будут.

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

2

Скопируйте Webhook

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

hde webhook
3

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

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

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

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

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

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

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

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

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

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

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

Действие:

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

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

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

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

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

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

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

Действие:

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

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

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

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