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

Типы событий

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 для них не применяется.

{
"eventId": "a1b2c3d4e5f60001",
"eventType": "task.created",
"accountId": 5,
"projectId": 12,
"taskId": 456,
"title": "Подготовить отчёт",
"createdByUserId": 7,
"createdAt": "2026-05-17T10:30:00Z"
}
{
"eventId": "a1b2c3d4e5f60002",
"eventType": "task.updated",
"accountId": 5,
"projectId": 12,
"taskId": 456,
"updatedByUserId": 7,
"updatedAt": "2026-05-17T11:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60003",
"eventType": "task.deleted",
"accountId": 5,
"projectId": 12,
"taskId": 456,
"deletedByUserId": 7,
"deletedAt": "2026-05-17T12:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60004",
"eventType": "task.completed",
"accountId": 5,
"projectId": 12,
"taskId": 456,
"completedByUserId": 7,
"completedAt": "2026-05-17T13:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60005",
"eventType": "task.reopened",
"accountId": 5,
"projectId": 12,
"taskId": 456,
"reopenedByUserId": 7,
"reopenedAt": "2026-05-17T14:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60006",
"eventType": "task.commented",
"accountId": 5,
"projectId": 12,
"taskId": 456,
"commentId": 789,
"authorUserId": 7,
"body": "Нужно уточнить требования",
"createdAt": "2026-05-17T10:45:00Z"
}
{
"eventId": "a1b2c3d4e5f60007",
"eventType": "task.assigned",
"accountId": 5,
"projectId": 12,
"taskId": 456,
"assigneeUserId": 9,
"assignedByUserId": 7,
"assignedAt": "2026-05-17T10:50:00Z"
}
{
"eventId": "a1b2c3d4e5f60008",
"eventType": "task.unassigned",
"accountId": 5,
"projectId": 12,
"taskId": 456,
"assigneeUserId": 9,
"unassignedByUserId": 7,
"unassignedAt": "2026-05-17T11:10:00Z"
}
{
"eventId": "a1b2c3d4e5f60009",
"eventType": "project.created",
"accountId": 5,
"projectId": 12,
"name": "Новый проект",
"createdByUserId": 7,
"createdAt": "2026-05-17T09:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60010",
"eventType": "project.updated",
"accountId": 5,
"projectId": 12,
"name": "Переименованный проект",
"updatedByUserId": 7,
"updatedAt": "2026-05-17T09:30:00Z"
}
{
"eventId": "a1b2c3d4e5f60011",
"eventType": "project.deleted",
"accountId": 5,
"projectId": 12,
"deletedByUserId": 7,
"deletedAt": "2026-05-17T16:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60012",
"eventType": "project.member.added",
"accountId": 5,
"projectId": 12,
"userId": 9,
"role": "Member",
"byUserId": 7,
"at": "2026-05-17T10:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60013",
"eventType": "project.member.removed",
"accountId": 5,
"projectId": 12,
"userId": 9,
"byUserId": 7,
"at": "2026-05-17T10:30:00Z"
}

file.* - аккаунт-уровневые события. projectId всегда null (WorkFile не привязан к проекту). attachment.* - события файлов, прикреплённых к задаче; содержат taskId и projectId.

{
"eventId": "a1b2c3d4e5f60014",
"eventType": "file.uploaded",
"accountId": 5,
"projectId": null,
"fileId": 100,
"fileName": "report.pdf",
"sizeBytes": 204800,
"uploadedByUserId": 7,
"uploadedAt": "2026-05-17T10:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60015",
"eventType": "file.deleted",
"accountId": 5,
"projectId": null,
"fileId": 100,
"fileName": "report.pdf",
"sizeBytes": 204800,
"deletedByUserId": 7,
"deletedAt": "2026-05-17T11:00:00Z"
}
{
"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"
}
{
"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"
}

event.* - аккаунт-уровневые события. projectId отсутствует в payload. Срабатывают при изменении сущностей в разделе Календарь.

{
"eventId": "a1b2c3d4e5f60018",
"eventType": "event.created",
"accountId": 5,
"calendarEventId": 300,
"title": "Встреча команды",
"createdByUserId": 7,
"createdAt": "2026-05-17T09:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60019",
"eventType": "event.updated",
"accountId": 5,
"calendarEventId": 300,
"title": "Встреча команды (обновлено время)",
"updatedByUserId": 7,
"updatedAt": "2026-05-17T10:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60020",
"eventType": "event.deleted",
"accountId": 5,
"calendarEventId": 300,
"deletedByUserId": 7,
"deletedAt": "2026-05-17T11:00:00Z"
}
{
"eventId": "a1b2c3d4e5f60021",
"eventType": "event.cancelled",
"accountId": 5,
"calendarEventId": 300,
"title": "Встреча команды",
"cancelledByUserId": 7,
"cancelledAt": "2026-05-17T11:30:00Z"
}