Типы событий
FlowWorker поддерживает 21 тип webhook-событий, разбитых по доменам: задачи, проекты, файлы и события календаря. Каждое событие содержит общие поля (eventId, eventType, accountId) и специфичные для домена поля.
Все типы событий
Заголовок раздела «Все типы событий»| Тип | Когда отправляется | Ключевые поля payload |
|---|---|---|
task.created | Создана задача | taskId, projectId, title, createdByUserId |
task.updated | Обновлена задача | taskId, projectId, updatedByUserId |
task.deleted | Задача удалена | taskId, projectId, deletedByUserId |
task.completed | Задача переведена в «выполнено» | taskId, projectId, completedByUserId, completedAt |
task.reopened | Задача переоткрыта из «выполнено» | taskId, projectId, reopenedByUserId, reopenedAt |
task.commented | Добавлен комментарий | taskId, projectId, commentId, authorUserId, body |
task.assigned | Назначен исполнитель | taskId, projectId, assigneeUserId, assignedByUserId |
task.unassigned | Снят исполнитель | taskId, projectId, assigneeUserId, unassignedByUserId |
project.created | Создан проект | projectId, name, accountId |
project.updated | Обновлён проект | projectId, name, updatedByUserId, updatedAt |
project.deleted | Проект удалён | projectId, deletedByUserId, deletedAt |
project.member.added | Добавлен участник в проект | projectId, userId, role, byUserId, at |
project.member.removed | Удалён участник из проекта | projectId, userId, byUserId, at |
file.uploaded | Загружен файл (аккаунт-уровень) | fileId, fileName, sizeBytes, uploadedByUserId, projectId (null) |
file.deleted | Удалён файл | fileId, fileName, sizeBytes, deletedByUserId, projectId (null) |
attachment.uploaded | Прикреплён файл к задаче | attachmentId, taskId, projectId, fileName, sizeBytes, uploadedByUserId |
attachment.deleted | Откреплён файл от задачи | attachmentId, taskId, projectId, fileName, sizeBytes, deletedByUserId |
event.created | Создано событие календаря | calendarEventId, title, createdByUserId, createdAt |
event.updated | Обновлено событие календаря | calendarEventId, title, updatedByUserId, updatedAt |
event.deleted | Удалено событие календаря | calendarEventId, deletedByUserId, deletedAt |
event.cancelled | Событие отменено (IsCancelled false→true) | calendarEventId, title, cancelledByUserId, cancelledAt |
Примечание:
file.*события не привязаны к конкретному проекту -projectIdв них всегдаnull. Используйтеattachment.*для файлов, привязанных к задаче.
Примечание (calendar events):
event.*события имеют аккаунт-уровневый scope -projectIdотсутствует в payload. ФильтрprojectIdsв subscription для них не применяется.
Примеры payload
Заголовок раздела «Примеры payload»Задачи (Tasks)
Заголовок раздела «Задачи (Tasks)»task.created
Заголовок раздела «task.created»{ "eventId": "a1b2c3d4e5f60001", "eventType": "task.created", "accountId": 5, "projectId": 12, "taskId": 456, "title": "Подготовить отчёт", "createdByUserId": 7, "createdAt": "2026-05-17T10:30:00Z"}task.updated
Заголовок раздела «task.updated»{ "eventId": "a1b2c3d4e5f60002", "eventType": "task.updated", "accountId": 5, "projectId": 12, "taskId": 456, "updatedByUserId": 7, "updatedAt": "2026-05-17T11:00:00Z"}task.deleted
Заголовок раздела «task.deleted»{ "eventId": "a1b2c3d4e5f60003", "eventType": "task.deleted", "accountId": 5, "projectId": 12, "taskId": 456, "deletedByUserId": 7, "deletedAt": "2026-05-17T12:00:00Z"}task.completed
Заголовок раздела «task.completed»{ "eventId": "a1b2c3d4e5f60004", "eventType": "task.completed", "accountId": 5, "projectId": 12, "taskId": 456, "completedByUserId": 7, "completedAt": "2026-05-17T13:00:00Z"}task.reopened
Заголовок раздела «task.reopened»{ "eventId": "a1b2c3d4e5f60005", "eventType": "task.reopened", "accountId": 5, "projectId": 12, "taskId": 456, "reopenedByUserId": 7, "reopenedAt": "2026-05-17T14:00:00Z"}task.commented
Заголовок раздела «task.commented»{ "eventId": "a1b2c3d4e5f60006", "eventType": "task.commented", "accountId": 5, "projectId": 12, "taskId": 456, "commentId": 789, "authorUserId": 7, "body": "Нужно уточнить требования", "createdAt": "2026-05-17T10:45:00Z"}task.assigned
Заголовок раздела «task.assigned»{ "eventId": "a1b2c3d4e5f60007", "eventType": "task.assigned", "accountId": 5, "projectId": 12, "taskId": 456, "assigneeUserId": 9, "assignedByUserId": 7, "assignedAt": "2026-05-17T10:50:00Z"}task.unassigned
Заголовок раздела «task.unassigned»{ "eventId": "a1b2c3d4e5f60008", "eventType": "task.unassigned", "accountId": 5, "projectId": 12, "taskId": 456, "assigneeUserId": 9, "unassignedByUserId": 7, "unassignedAt": "2026-05-17T11:10:00Z"}Проекты (Projects)
Заголовок раздела «Проекты (Projects)»project.created
Заголовок раздела «project.created»{ "eventId": "a1b2c3d4e5f60009", "eventType": "project.created", "accountId": 5, "projectId": 12, "name": "Новый проект", "createdByUserId": 7, "createdAt": "2026-05-17T09:00:00Z"}project.updated
Заголовок раздела «project.updated»{ "eventId": "a1b2c3d4e5f60010", "eventType": "project.updated", "accountId": 5, "projectId": 12, "name": "Переименованный проект", "updatedByUserId": 7, "updatedAt": "2026-05-17T09:30:00Z"}project.deleted
Заголовок раздела «project.deleted»{ "eventId": "a1b2c3d4e5f60011", "eventType": "project.deleted", "accountId": 5, "projectId": 12, "deletedByUserId": 7, "deletedAt": "2026-05-17T16:00:00Z"}project.member.added
Заголовок раздела «project.member.added»{ "eventId": "a1b2c3d4e5f60012", "eventType": "project.member.added", "accountId": 5, "projectId": 12, "userId": 9, "role": "Member", "byUserId": 7, "at": "2026-05-17T10:00:00Z"}project.member.removed
Заголовок раздела «project.member.removed»{ "eventId": "a1b2c3d4e5f60013", "eventType": "project.member.removed", "accountId": 5, "projectId": 12, "userId": 9, "byUserId": 7, "at": "2026-05-17T10:30:00Z"}Файлы (Files)
Заголовок раздела «Файлы (Files)»
file.*- аккаунт-уровневые события.projectIdвсегдаnull(WorkFile не привязан к проекту).attachment.*- события файлов, прикреплённых к задаче; содержатtaskIdиprojectId.
file.uploaded
Заголовок раздела «file.uploaded»{ "eventId": "a1b2c3d4e5f60014", "eventType": "file.uploaded", "accountId": 5, "projectId": null, "fileId": 100, "fileName": "report.pdf", "sizeBytes": 204800, "uploadedByUserId": 7, "uploadedAt": "2026-05-17T10:00:00Z"}file.deleted
Заголовок раздела «file.deleted»{ "eventId": "a1b2c3d4e5f60015", "eventType": "file.deleted", "accountId": 5, "projectId": null, "fileId": 100, "fileName": "report.pdf", "sizeBytes": 204800, "deletedByUserId": 7, "deletedAt": "2026-05-17T11:00:00Z"}attachment.uploaded
Заголовок раздела «attachment.uploaded»{ "eventId": "a1b2c3d4e5f60016", "eventType": "attachment.uploaded", "accountId": 5, "projectId": 12, "taskId": 456, "attachmentId": 200, "fileName": "screenshot.png", "sizeBytes": 51200, "uploadedByUserId": 7, "uploadedAt": "2026-05-17T10:05:00Z"}attachment.deleted
Заголовок раздела «attachment.deleted»{ "eventId": "a1b2c3d4e5f60017", "eventType": "attachment.deleted", "accountId": 5, "projectId": 12, "taskId": 456, "attachmentId": 200, "fileName": "screenshot.png", "sizeBytes": 51200, "deletedByUserId": 7, "deletedAt": "2026-05-17T10:20:00Z"}События календаря (Calendar Events)
Заголовок раздела «События календаря (Calendar Events)»
event.*- аккаунт-уровневые события.projectIdотсутствует в payload. Срабатывают при изменении сущностей в разделе Календарь.
event.created
Заголовок раздела «event.created»{ "eventId": "a1b2c3d4e5f60018", "eventType": "event.created", "accountId": 5, "calendarEventId": 300, "title": "Встреча команды", "createdByUserId": 7, "createdAt": "2026-05-17T09:00:00Z"}event.updated
Заголовок раздела «event.updated»{ "eventId": "a1b2c3d4e5f60019", "eventType": "event.updated", "accountId": 5, "calendarEventId": 300, "title": "Встреча команды (обновлено время)", "updatedByUserId": 7, "updatedAt": "2026-05-17T10:00:00Z"}event.deleted
Заголовок раздела «event.deleted»{ "eventId": "a1b2c3d4e5f60020", "eventType": "event.deleted", "accountId": 5, "calendarEventId": 300, "deletedByUserId": 7, "deletedAt": "2026-05-17T11:00:00Z"}event.cancelled
Заголовок раздела «event.cancelled»{ "eventId": "a1b2c3d4e5f60021", "eventType": "event.cancelled", "accountId": 5, "calendarEventId": 300, "title": "Встреча команды", "cancelledByUserId": 7, "cancelledAt": "2026-05-17T11:30:00Z"}