Skip to main content

Task events (task.*)

Manual tasks of the operation (created by operators or by the collection rule — e.g. negativation/protest review). In entity events, data is the task with the summarized person, assignedTo and charge.

taskType values: 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",
  "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
  "data": {
    "id": "9d1f3b5a-7c2e-4f6a-8b0d-5e7a9c1f3b5d",
    "public_id": "f6a7b8c9-d0e1-4f2a-3b4c-5d6e7f809102",
    "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
    "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
    "company_id": null,
    "business_unit_id": null,
    "person_id": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
    "charge_id": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
    "assigned_to_id": "3e5a7c9b-2d4f-4a6c-8e0b-7f9d1b3e5a7c",
    "title": "Ligar para negociar parcelamento",
    "description": "Cliente pediu retorno após o dia 25.",
    "task_type": "call",
    "priority": "high",
    "status": "pending",
    "due_at": "2026-07-25T17:00:00.000Z",
    "completed_at": null,
    "external_id": null,
    "custom_data": null,
    "tags": ["negociação"],
    "deleted_at": null,
    "metadata": {},
    "custom_metadata": null,
    "created_at": "2026-07-23T12:00:00.000Z",
    "updated_at": "2026-07-23T12:00:00.000Z",
    "person": {
      "id": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
      "name": "Padaria Pão Quente Ltda",
      "document_number": "12345678000190"
    },
    "assigned_to": {
      "id": "3e5a7c9b-2d4f-4a6c-8e0b-7f9d1b3e5a7c",
      "name": "Ana Souza",
      "email": "ana@empresa.com.br",
      "avatar_url": null
    },
    "charge": {
      "id": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
      "document_number": "NF-2026-0451",
      "original_amount": 1500.00,
      "due_date": "2026-07-31T00:00:00.000Z",
      "status": "overdue"
    }
  }
}

task.updated​

Fires when the task is changed. Same shape as task.created.

task.completed​

Fires on completion (status: "completed", completedAt filled in). Same shape; already-cancelled tasks cannot be completed (the event does not occur).

task.deleted​

Fires when the task is deleted in the dashboard (it moves to cancelled; the record stays). The API has no task DELETE: cancelling is PUT /v1/tasks/{id} with status: "cancelled", which emits task.updated.

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