# webhook.received

> O evento webhook.received (Chamada recebida de outra ferramenta) do ByDomu: quando é emitido, como assinar, seus campos e o payload que chega por webhook.


Chamada recebida de outra ferramenta

Objeto · webhook Na hora

## Quando é emitido

Outra ferramenta chamou o webhook de entrada de uma automação. webhook traz o corpo, os cabeçalhos seguros e a query.

Na hora, quando acontece no ByDomu: pelo app, pela API, pela Noa, por uma automação ou uma integração. `actor.kind` diz quem foi: USER, NOA, SYSTEM, API, AUTOMATION ou INTEGRATION.

## Assine com

- `webhook.received` Só este evento
- `webhook.*` Todos os de Chamada de outra ferramenta
- `*` O catálogo inteiro

## Campos que traz

caminhos para filtros e modelos

`webhook.hookId` Identificador do link

`webhook.body` Conteúdo recebido

`webhook.headers` Cabeçalhos recebidos

`webhook.query` Parâmetros do endereço

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": "webhook.received",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "webhook.received",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "INTEGRATION",
    "userId": null
  },
  "data": {
    "webhook": {
      "hookId": "hk_EXAMPLE0000000000",
      "automationId": "clx1aut001",
      "body": {
        "nombre": "Laura Restrepo",
        "inmueble": "P-0042"
      },
      "headers": {
        "content-type": "application/json",
        "user-agent": "Zapier"
      },
      "query": {},
      "receivedAt": "2026-09-22T14:30:00.000Z"
    }
  }
}
```

Cabeçalhos:

```
X-Domu-Event: webhook.received
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/webhook.received

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