> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Receba no seu servidor um aviso assinado quando algo acontece no script.

## Eventos

| Evento | Quando |
| - | - |
| `repo.commit` | Um commit foi gravado no repositório do script. |
| `functions.deploy` | O backend (funções e coleções) foi publicado. |
| `access.granted` | Alguém recebeu acesso ao script. |
| `ping` | Teste enviado pelo botão ou pela rota de teste. |

O endereço precisa ser `https://` público. IP privado e `localhost` são recusados. O segredo aparece **uma única vez**, ao criar o webhook.

![Captura de tela: Token do Webhook DoglyTdc](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/scripts/scripts-webhook.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=acebfedc2e7ca71b6bfe1720dcba2661)

Token do Webhook DoglyTdc

## O que chega

```http theme={null}
POST /seu-endereco
Content-Type: application/json
User-Agent: DoglyTdc-Scripts-Webhook/1
X-DoglyTdc-Event: repo.commit
X-DoglyTdc-Delivery: 1234
X-DoglyTdc-Timestamp: 1794015161
X-DoglyTdc-Signature: sha256=…

{ "id": "1234", "event": "repo.commit", "script_id": "…", "created_at": "…", "data": { … } }
```

## Conferir a assinatura

A assinatura é `sha256=` + hex de HMAC-SHA256(segredo, `timestamp + "." + corpo cru`). Recuse pedidos com timestamp de mais de 5 minutos.

```js Node.js theme={null}
import crypto from "node:crypto";

export function valido(req, corpoCru, segredo) {
  const ts = req.headers["x-doglytdc-timestamp"];
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
  const esperado = "sha256=" + crypto.createHmac("sha256", segredo).update(`${ts}.${corpoCru}`).digest("hex");
  const recebido = req.headers["x-doglytdc-signature"] || "";
  return recebido.length === esperado.length && crypto.timingSafeEqual(Buffer.from(recebido), Buffer.from(esperado));
}
```

## Novas tentativas

* Até 3 tentativas por aviso (na hora, depois de 1 s e de 3 s).
* Resposta 4xx (menos 429) não é tentada de novo.
* Depois de 10 falhas seguidas, o webhook é desligado. Ligue de novo pelo painel ou por `PATCH`.

Rotas: [API › Webhooks](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/webhooks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.