Saltar al contenido principal

Eventos de tarea (task.*)

Tareas manuales de la operación (creadas por operadores o por la regla de cobranza — ej.: revisión de negativación/protesto). En los eventos de entidad, data es la tarea con person, assignedTo y charge resumidos.

Valores de taskType: call · email · visit · review · follow_up. priority: low · medium · high · urgent. status: pending · in_progress · completed · cancelled.

task.created​

{
  "event": "task.created",
  "timestamp": "2026-07-23T12:00:00.000Z",
  "organizationId": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "data": {
    "id": "9d1f3b5a-7c2e-4f6a-8b0d-5e7a9c1f3b5d",
    "publicId": "f6a7b8c9-d0e1-4f2a-3b4c-5d6e7f809102",
    "organizationId": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
    "workspaceId": null,
    "companyId": null,
    "businessUnitId": null,
    "personId": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
    "chargeId": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
    "assignedToId": "3e5a7c9b-2d4f-4a6c-8e0b-7f9d1b3e5a7c",
    "title": "Ligar para negociar parcelamento",
    "description": "Cliente pediu retorno após o dia 25.",
    "taskType": "call",
    "priority": "high",
    "status": "pending",
    "dueAt": "2026-07-25T17:00:00.000Z",
    "completedAt": null,
    "externalId": null,
    "customData": null,
    "tags": ["negociação"],
    "deletedAt": null,
    "metadata": {},
    "createdAt": "2026-07-23T12:00:00.000Z",
    "updatedAt": "2026-07-23T12:00:00.000Z",
    "person": {
      "id": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
      "name": "Padaria Pão Quente Ltda",
      "documentNumber": "12345678000190"
    },
    "assignedTo": {
      "id": "3e5a7c9b-2d4f-4a6c-8e0b-7f9d1b3e5a7c",
      "name": "Ana Souza",
      "email": "ana@empresa.com.br",
      "avatarUrl": null
    },
    "charge": {
      "id": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
      "documentNumber": "NF-2026-0451",
      "originalAmount": "1500.00",
      "dueDate": "2026-07-31T00:00:00.000Z",
      "status": "overdue"
    }
  }
}

task.updated​

Se dispara cuando la tarea se modifica. Mismo shape que task.created.

task.completed​

Se dispara en la conclusión (status: "completed", completedAt lleno). Mismo shape; las tareas ya canceladas no pueden completarse (el evento no ocurre).

task.deleted​

Se dispara en la eliminación (la tarea pasa a cancelled con soft delete):

{
  "event": "task.deleted",
  "timestamp": "2026-07-23T12:00:00.000Z",
  "organizationId": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "data": { "id": "9d1f3b5a-7c2e-4f6a-8b0d-5e7a9c1f3b5d" }
}