> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# Gerenciar e diagnosticar webhooks

## Permissões de configuração

Um webhook de projeto exige administração desse projeto. Um webhook global e o inventário organizacional exigem administração da organização conforme as políticas do backend. Estas são operações JWT da API privada.

| Método             | Rota relativa a `/api/v1/organizations/{orgId}` |
| ------------------ | ----------------------------------------------- |
| POST               | `/webhooks`                                     |
| GET                | `/webhooks`                                     |
| GET / PUT / DELETE | `/webhooks/{id}`                                |
| GET                | `/webhooks/{id}/deliveries?page=1&pageSize=20`  |

Na criação, envie `projectId` opcional, `url`, `secret` opcional e `eventTypes` opcional. O servidor gera um segredo se ele não for informado. O segredo completo só acompanha a criação; leituras posteriores não o devolvem.

## Atualize a configuração

O PUT recebe `url`, `eventTypes` e `active`. Ele não é um PATCH parcial e não oferece mudança de segredo. Revise os valores ao desativar ou editar o destino.

## Investigue falhas

Consulte o histórico na configuração de integrações do projeto. Confira URL, assinatura no receptor, status HTTP e tentativas. Destinos inválidos, integração removida ou inativa e restrições de acesso podem produzir estados diferentes de uma falha HTTP comum.

A implementação mantém um identificador estável por entrega. Uma repetição manual deve operar sobre a entrega específica; não reenvie um lote inteiro para compensar um único destino.
