# Hooklane — Visão geral

Hooklane é uma plataforma para receber, inspecionar, rotear e reenviar webhooks. Um sistema externo
envia eventos para uma URL de entrada gerada pelo Hooklane; o Hooklane registra o evento, entrega-o
a um ou mais destinos, tenta novamente em caso de falha, e mantém um histórico consultável pelo
painel ou pela API pública (`/api/v1`).

## Tipos de webhook

- **Normal** — encaminha o corpo bruto do evento (sem transformação) para uma ou mais URLs próprias.
- **Discord** — aplica um template (Mensagem Simples, Embed clássico ou Components V2) e envia uma
  mensagem formatada a um canal do Discord, usando uma webhook de canal comum (sem bot).

## Fluxo completo

1. Criar a webhook (painel ou `POST /api/v1/webhooks`) → recebe uma URL de entrada única:
   `https://hooklane.shop/hooks/{token}`.
2. Configurar destino(s) (Normal) ou a URL do Discord + template (Discord).
3. Um sistema externo envia `POST` para a URL de entrada.
4. O Hooklane registra o evento e tenta entregá-lo imediatamente.
5. Falhas entram numa fila de retry automático (30s, 2min, 10min, 30min — 5 tentativas no total).
6. Histórico completo (evento, cada tentativa, status) disponível no painel e via
   `GET /api/v1/events`.

A URL de entrada (`/hooks/{token}`) só recebe eventos — nunca operações de gerenciamento, que
acontecem exclusivamente no painel ou em `/api/v1/*`, autenticado por chave de API.

## Recursos adicionais

- API pública de gerenciamento (`/api/v1`) — ver [api.md](/docs/api.md)
- Servidor MCP para assistentes de IA (`/mcp`)
- Equipes com controle de acesso por papel (`owner`/`admin`/`member`/`viewer`)
- Planos com uso de infraestrutura medido (Free base, Pro 20x, Plus 4x o Pro) — a quantidade de
  webhooks não é limite de plano
- MCP disponível em todos os planos, inclusive no Free
- PWA instalável com notificações push

## Próximos documentos

- [webhooks.md](/docs/webhooks.md) — webhooks Normais em detalhe
- [discord.md](/docs/discord.md) — integração Discord
- [components-v2.md](/docs/components-v2.md) — Components V2 em detalhe
- [api.md](/docs/api.md) — API pública
- [authentication.md](/docs/authentication.md) — autenticação e escopos
- [examples.md](/docs/examples.md) — exemplos completos
- [errors.md](/docs/errors.md) — erros comuns
- [faq.md](/docs/faq.md) — perguntas frequentes