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

# Visão geral

> Webhooks disponíveis hoje, eventos suportados, rotas e limites do MVP.

Webhooks permitem que a Atriby envie eventos de pedido para o seu servidor.

## O que funciona hoje

* Criar, listar e desabilitar endpoints no app.
* Entrega HTTP POST real para a URL configurada.
* Assinatura HMAC-SHA256.
* Logs de entrega.
* Retry manual de falhas.

## Eventos suportados

| Evento             | Quando dispara                                |
| ------------------ | --------------------------------------------- |
| `order.created`    | Um pedido é criado via `POST /api/v1/orders`. |
| `order.paid`       | Um pedido muda para `paid`.                   |
| `order.refunded`   | Um pedido muda para `refunded`.               |
| `order.chargeback` | Um pedido muda para `chargedback`.            |

`order.refused` não dispara webhook hoje.

## Rotas do app

As rotas de gerenciamento usam sessão do dashboard, não API token:

| Método   | Rota                                  | Uso                                        |
| -------- | ------------------------------------- | ------------------------------------------ |
| `GET`    | `/api/webhooks`                       | Lista endpoints e entregas recentes.       |
| `POST`   | `/api/webhooks`                       | Cria endpoint e retorna o segredo uma vez. |
| `DELETE` | `/api/webhooks/{id}`                  | Desabilita endpoint.                       |
| `POST`   | `/api/webhooks/deliveries/{id}/retry` | Reenvia entrega manualmente.               |

## Limites atuais

* Não existe `PATCH /api/webhooks/{id}`. Para alterar URL, nome ou eventos, desabilite e crie outro endpoint.
* Não há worker, fila ou backoff automático.
* Retry é manual.
* Webhooks fora do domínio de pedidos ainda não existem.