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

Helpdeskeddy

Это руководство поможет вам шаг за шагом настроить интеграцию между платформой «Лия» и сервисом Helpdeskeddy.

Этап 1: Подготовка в Helpdeskeddy​

Начнем с получения всех необходимых данных из вашего аккаунта Helpdeskeddy.

Шаг 1. Регистрация и получение API-ключа
  1. Если у вас еще нет аккаунта, зарегистрируйтесь на сайте Helpdeskeddy. Во время регистрации сохраните адрес вашей системы (например, mycompany.helpdeskeddy.ru) и email администратора — они понадобятся для настройки в «Лие».
  2. После входа в аккаунт перейдите в раздел Контакты.
  3. Найдите и откройте карточку пользователя-администратора.
  4. В строке API key нажмите «Сгенерировать» и скопируйте полученный ключ.
к сведению

На этом шаге у вас должны быть три компонента:

  • Адрес системы (точка доступа)
  • Email администратора
  • Сгенерированный API-ключ

Этап 2: Настройка в «Лие»​

Теперь создадим и настроим канал в «Лие», используя полученные данные.

Шаг 2. Создание и настройка канала
  1. В личном кабинете «Лия» перейдите в раздел Интеграции.
  2. Нажмите «Добавить» и выберите из списка Helpdeskeddy.
  3. Заполните форму:
    • Точка доступа: Вставьте адрес вашей системы Helpdeskeddy (не забудьте / в конце).
    • Почта: Укажите email администратора.
    • API key: Вставьте API-ключ, скопированный на предыдущем шаге.
  4. Активируйте «Включить канал» и нажмите «Сохранить».
warning

Скопируйте ссылку для Helpdeskeddy! После сохранения в настройках канала появится поле «Ссылка для Helpdeskeddy». Скопируйте этот URL — он понадобится нам на финальном этапе.

Этап 3: Финальная настройка в Helpdeskeddy​

Осталось настроить правило в Helpdeskeddy, которое будет отправлять все новые сообщения в «Лию».

Шаг 3. Создание правила в «Диспетчере»
  1. В Helpdeskeddy перейдите в Управление → Диспетчер.
  2. Нажмите «Добавить правило».
  3. Задайте имя (например, Отправка в Лию) и убедитесь, что правило активно.
  4. В разделе «Обязательные условия» добавьте два условия:
    • Новая заявка
    • Новый ответ в заявке
  5. В разделе «Действия» добавьте два действия:
    • Действие 1: Изменить исполнителя заявки
      • Выберите вашего пользователя-администратора, для которого генерировался API-ключ.
    • Действие 2: Отправить вебхук
      • Метод: POST
      • URL: Вставьте сюда полную ссылку, скопированную из «Лии» на предыдущем этапе.
      • API ключ: Укажите только сам ключ (часть ссылки после ?key=).
      • Тело запроса: Вставьте следующий 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}
}
  1. Нажмите «Сохранить правило».
к сведению

Готово! Интеграция полностью настроена. Теперь все новые заявки и ответы в Helpdeskeddy будут автоматически передаваться в «Лию» для обработки.