Skip to main content

Webhook: TASK_EXPIRED

Описание​

Webhook TASK_EXPIRED срабатывает, когда задача не была завершена после истечения запланированного времени её выполнения. Этот webhook помогает убедиться, что системы или пользователи получают уведомления о просроченных задачах для более эффективного отслеживания и принятия мер.

Формат запроса​

Webhook отправляется в виде HTTP POST запроса с следующим пейлоадом:

{
   "entityId": "1d63907b-93ed-4188-8b5d-99292fceaae9",
   "type": "TASK_EXPIRED",
   "createdAt": "2024-12-16T09:43:01.347Z",
   "data": {
      "id": "1d63907b-93ed-4188-8b5d-99292fceaae9",
      "organizationId": "9864d894-699a-4a00-8d4c-ae181215d721",
      "locationId": "27b732ee-5921-475f-acd7-137fc4d5aa0f",
      "startAt": "2024-12-16T09:00:00.000Z",
      "endAt": "2024-12-16T09:43:00.000Z",
      "name": "Task 2",
      "assigneeIds": [
         "6ad1a95b-ea50-4e23-8495-ef82900ca98d"
      ],
      "recurrenceRule": null,
      "stepId": null,
      "actionId": null
   }
}

Ключевые свойства​

Верхний уровень​

  • entityId: Уникальный идентификатор просроченной задачи.
  • type: Указывает тип webhook (TASK_EXPIRED).
  • createdAt: Временная метка срабатывания webhook в формате ISO 8601.

Раздел данных​

Содержит подробную информацию о просроченной задаче:

  • id: Уникальный идентификатор задачи.
  • organizationId: Идентификатор организации, связанной с задачей.
  • locationId: Идентификатор местоположения, где была назначена задача.
  • startAt: Время начала задачи в формате ISO 8601.
  • endAt: Запланированное время завершения задачи в формате ISO 8601.
  • name: Название задачи.
  • assigneeIds: Список идентификаторов пользователей, назначенных на задачу.
  • recurrenceRule: Детали повторения задачи (если применимо).
  • stepId: Идентификатор конкретного шага в более крупном рабочем процессе (если применимо).
  • actionId: Идентификатор связанного действия (если применимо).

Пример ответа​

Ответ сервера на webhook подтверждает успешное получение. Типичный пейлоад ответа может выглядеть так:

{
   "entityId": "1d63907b-93ed-4188-8b5d-99292fceaae9",
   "type": "TASK_EXPIRED",
   "createdAt": "2024-12-16T09:43:01.347Z",
   "data": {
      "id": "1d63907b-93ed-4188-8b5d-99292fceaae9",
      "organizationId": "9864d894-699a-4a00-8d4c-ae181215d721",
      "locationId": "27b732ee-5921-475f-acd7-137fc4d5aa0f",
      "startAt": "2024-12-16T09:00:00.000Z",
      "endAt": "2024-12-16T09:43:00.000Z",
      "name": "Task 2",
      "assigneeIds": [
         "6ad1a95b-ea50-4e23-8495-ef82900ca98d"
      ],
      "recurrenceRule": null,
      "stepId": null,
      "actionId": null
   },
   "id": 201
}

Преимущества webhook TASK_EXPIRED​

  1. Улучшенный контроль: Обеспечивает проактивное управление просроченными задачами.
  2. Возможности автоматизации: Может запускать уведомления, эскалационные рабочие процессы или действия для последующего контроля.
  3. Обновления в реальном времени: Помогает поддерживать подотчетность и видимость задач.

Используя webhook TASK_EXPIRED, организации могут улучшить мониторинг задач и эффективно решать проблемы с просроченными задачами.