Helpdeskeddy

Шаг 1. Создание аккаунта Helpdeskeddy

Для начала интеграции необходимо создать аккаунт в Helpdeskeddy:

  1. Перейдите на страницу регистрации Helpdeskeddy.

  2. Заполните регистрационную форму, указав данные на ваше усмотрение.

Важно:

  • Указанная почта потребуется для настройки Канала в Лия.

  • Обратите внимание на адрес системы (точка доступа). Этот адрес понадобится на следующих этапах настройки.

После активации аккаунта выполните следующие действия, чтобы получить API key — третий реквизит для настройки интеграции:

  1. Перейдите в раздел Контакты, который находится на левой боковой панели Helpdeskeddy.

  2. Найдите в списке созданного пользователя при регистрации.

  3. Откройте карточку пользователя.

  4. В строке API key нажмите кнопку Сгенерировать. Ключ доступен только главному администратору — подробнее.

  5. Скопируйте сгенерированный ключ.

Шаг 2. Настройка в Лия

Теперь, когда аккаунт в Helpdeskeddy создан, нужно настроить интеграцию в Лия:

  1. Войдите в аккаунт Лия под учетной записью администратора.

  2. Перейдите в раздел Интеграции.

  3. Нажмите кнопку Добавить.

  4. В выпадающем списке выберите Helpdeskeddy.

  1. После выбора канала отобразится форма настроек. Внесите в нее следующие данные из созданного ранее аккаунта Helpdeskeddy:

    • Точка доступа — укажите адрес системы, который был задан при регистрации. Проверьте, что в поле после домена указан "/".

    • Почта — введите адрес, использованный при создании аккаунта.

    • API key — вставьте ранее скопированный ключ из карточки пользователя.

  1. Не забудьте Включить и Сохранить канал

  1. Сохраните ссылку для Helpdeskeddy:

    • Найдите поле Ссылка для Helpdeskeddy.

    • Нажмите кнопку Скопировать, чтобы сохранить ссылку. Эта ссылка понадобится на следующем этапе настройки.

Шаг 3. Настройка правил передачи сообщений в Лия

Чтобы настроить передачу сообщений в Лия, выполните следующие действия:

  1. На левой панели интерфейса Helpdeskeddy выберите пункт Управление.

  2. В открывшемся меню нажмите на раздел Диспетчер (он может находиться в списке или на центральной панели).

  1. Чтобы добавить новое правило, нажмите кнопку Добавить правило.

В открывшейся форме укажите:

  • Название правила — произвольное, удобное для идентификации.

  • Описание — короткое пояснение, что делает это правило.

  • Группа правил — выберите или создайте новую, чтобы структурировать ваши правила.

  • Активность — переведите слайдер в активное состояние, чтобы правило начало работать.

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

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

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

Раздел Дополнительные условия — заполнять по необходимости вашего сервиса.

В разделе Действия выполните следующие настройки:

  • Выберите действие Изменить исполнителя заявки и укажите исполнителя, используемого для интеграции с Лия (на скриншоте, “Danil”).

  • Добавьте дополнительное действие Отправить вебхук.

  • Метод: выберите POST.

  • Укажите API ключ — это часть Ссылки для Helpdeskeddy, которая идёт после key=.

Например, в полной ссылке: https://test.lia.chat/channels/helpdeskeddy?key=pQxKKBiZ5Cui API ключ — это pQxKKBiZ5Cui

  • Укажите полный URL, скопированный из настроек канала Helpdeskeddy в Лия, включая https и весь токен.

В поле “Тело” запроса вставляем этот json:

{
  "ticket_id": {ticket_id},
  "answer_last_without_html": "{answer_last_without_html}",
  "last_answer": "{answer_last}",
  "user_id": {user_id},
  "last_post_user_id": {last_post_user_id}
}

Примерно так это будет выглядеть после заполнения:

Пояснения к параметрам:

  • ticket_id — идентификатор заявки.

  • answer_last_without_html — последний ответ без HTML-разметки.

  • last_answer — последний ответ.

  • user_id — идентификатор пользователя, связанного с заявкой.

  • last_post_user_id — идентификатор пользователя, сделавшего последнее сообщение.

После того как вы настроили все необходимые параметры, завершите процесс настройки — кнопка Сохранить правило.

Last updated