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

# Webhook

> Receba o resultado das Notas sem consultar a API.

> [!WARNING]
>
> **Em desenvolvimento.** Você já pode configurar o endereço e obter o segredo, mas as entregas ainda não
> estão ativas. Por enquanto, acompanhe as Notas por `GET /v1/notas/{id}`.

O **Webhook** é o endereço HTTPS da sua Conta que o NotasX vai chamar quando uma Nota chegar a um resultado
(`emitida`, `rejeitada` ou `falhou`). Há um Webhook por Conta.

## Configurar

```bash theme={null}
curl -X PUT $NOTASX/v1/webhook \
  -H "Authorization: Bearer $CHAVE" -H "Content-Type: application/json" \
  -d '{"url": "https://erp.exemplo.com.br/notasx/webhook"}'
```

```json theme={null}
{"url": "https://erp.exemplo.com.br/notasx/webhook", "segredo": "whsec_..."}
```

* O endereço precisa ser `https://`.
* O `segredo` é gerado na primeira configuração e **mantido** quando você troca o endereço. Ele servirá para
  conferir a assinatura HMAC de cada entrega.
* `GET /v1/webhook` mostra a configuração; `DELETE /v1/webhook` remove (e um segredo novo é gerado na próxima
  configuração).


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