# task.overdue

> O evento task.overdue (Tarefa vencida) do ByDomu: quando é emitido, como assinar, seus campos e o payload que chega por webhook.


Tarefa vencida

Objeto · task Inclui · contact Inclui · deal Programado

## Quando é emitido

Uma tarefa aberta passou do prazo. Emitido por uma varredura diária (uma vez por tarefa e dia).

É emitido por uma varredura programada do ByDomu, não pela ação de alguém: `actor.kind` diz quem foi: USER, NOA, SYSTEM, API, AUTOMATION ou INTEGRATION.

## Assine com

- `task.overdue` Só este evento
- `task.*` Todos os de Tarefa
- `*` O catálogo inteiro

## Campos que traz

caminhos para filtros e modelos

`task.id` Identificador da tarefa

`task.title` Título da tarefa

`task.type` Tipo de tarefa

`task.status` Status da tarefa

`task.priority` Prioridade

`task.dueDate` Data de vencimento

`task.assigneeId` Responsável

`task.dealId` Oportunidade

`task.contactId` Contato

`contact.id` Identificador do contato

`contact.code` Código do contato

`contact.firstName` Nome

`contact.lastName` Sobrenome

`contact.email` E-mail

`contact.phone` Telefone

`contact.source` Origem

`contact.status` Status

`contact.type` Tipo de contato

`contact.score` Pontuação

`contact.ownerId` Responsável

`contact.preferredCity` Cidade de interesse

`contact.preferredType` Tipo de imóvel que procura

`contact.budget` Orçamento

`contact.tags` Etiquetas

`deal.id` Identificador da oportunidade

`deal.code` Código da oportunidade

`deal.title` Título da oportunidade

`deal.value` Valor

`deal.currency` Moeda

`deal.probability` Probabilidade

`deal.status` Status

`deal.intent` Intenção

`deal.leadSource` Origem do lead

`deal.agentId` Corretor

`deal.contactId` Contato

`deal.pipelineId` Funil

`deal.stageId` Identificador da etapa

`deal.stageName` Etapa

`deal.previousStageId` Identificador da etapa anterior

`deal.previousStageName` Etapa anterior

`deal.lostReason` Motivo da perda

`deal.aiCreated` Criado pela Noa

`deal.saasPlanId`

`deal.saasMrrAmount`

`deal.trialStartedAt`

`deal.trialEndsAt`

Até 5 tentativas (0 s, 5 s, 30 s, 2 min e 10 min) em erro de rede, 429 ou 5xx. Responda 2xx em menos de 10 s.

Payload:

```
{
  "event": "task.overdue",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "task.overdue",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "SYSTEM",
    "userId": null
  },
  "data": {
    "task": {
      "id": "clx1tsk001",
      "title": "Enviar la promesa de compraventa",
      "description": "Con los datos del crédito aprobado.",
      "type": "SEND_CONTRACT",
      "status": "PENDING",
      "priority": "HIGH",
      "dueDate": "2026-09-21T17:00:00.000Z",
      "completedAt": null,
      "assigneeId": "clx1usr001",
      "dealId": "clx1deal001",
      "contactId": "clx1con001",
      "createdAt": "2026-09-22T14:30:00.000Z"
    },
    "contact": {
      "id": "clx1con001",
      "code": "C-0042",
      "firstName": "Laura",
      "lastName": "Restrepo",
      "fullName": "Laura Restrepo",
      "email": "laura.restrepo@example.com",
      "phone": "+573000000001",
      "source": "WEBSITE",
      "status": "QUALIFIED",
      "type": "CLIENT",
      "score": 72,
      "ownerId": "clx1usr001",
      "preferredCity": "Bogotá",
      "preferredType": "APARTMENT",
      "budget": 450000000,
      "currency": "COP",
      "tags": [
        "Compra",
        "Chapinero"
      ],
      "createdAt": "2026-09-20T15:04:00.000Z"
    },
    "deal": {
      "id": "clx1deal001",
      "code": "N-0042",
      "title": "Compra apartamento Chapinero · Laura Restrepo",
      "value": 450000000,
      "currency": "COP",
      "probability": 60,
      "status": "OPEN",
      "intent": "PURCHASE",
      "leadSource": "PORTAL",
      "lostReason": null,
      "aiCreated": false,
      "agentId": "clx1usr001",
      "contactId": "clx1con001",
      "pipelineId": "clx1pip001",
      "stageId": "clx1stg003",
      "stageName": "Negociación",
      "stageEnteredAt": "2026-09-22T14:30:00.000Z",
      "expectedCloseDate": "2026-10-31T00:00:00.000Z",
      "closedAt": null,
      "createdAt": "2026-09-20T15:05:00.000Z",
      "saasPlanId": null,
      "saasPlanName": null,
      "saasBillingPeriod": null,
      "saasMrrAmount": null,
      "trialStartedAt": null,
      "trialEndsAt": null
    }
  }
}
```

Cabeçalhos:

```
X-Domu-Event: task.overdue
X-Domu-Signature: t=1790610130,v1=9c1e…
User-Agent: Domu-Webhooks/2
```

Verificar assinatura:

```
import { createHmac, timingSafeEqual } from "node:crypto";

// header = X-Domu-Signature: t=<timestamp>,v1=<hmac>
function verifyWebhook(rawBody, header, secret, toleranceSec = 300) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const timestamp = Number(parts.t);
  if (!timestamp || !parts.v1) return false;
  if (Math.abs(Date.now() / 1000 - timestamp) > toleranceSec) return false;
  const expected = createHmac("sha256", secret)
    .update(`${timestamp}.${rawBody}`)
    .digest("hex");
  const a = Buffer.from(expected);
  const b = Buffer.from(parts.v1);
  return a.length === b.length && timingSafeEqual(a, b);
}
```

**Peça com seus dados de teste** GET /v1/webhooks/sample/task.overdue

[Testar](https://developers.bydomu.com/pt/referencia/get-webhook-sample?probar=1&type=task.overdue)