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 в Лия.

В поле “Тело” запроса вставляем этот 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 — идентификатор пользователя, сделавшего последнее сообщение.

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