# Seus webhooks deixam de ser uma caixa-preta.

> Inspecione cada chamada de webhook recebida no Pocket Alert: headers, payload, mensagem renderizada e motivo da falha. Depure suas integrações de webhook com até um ano de histórico.

<!-- source: https://pocketalert.app/pt/features/webhook-history -->

Última atualização: 2026-08-11

Cada chamada recebida registrada com seus cabeçalhos, payload, mensagem gerada e resultado. Quando uma integração jura que enviou a requisição, você pode conferir.

Documentação: https://info.pocketalert.app/api/webhooks/history.html

## Descubra o que realmente chegou

1. **Aponte um serviço para ele** — Crie um webhook e aponte o seu serviço para a URL dele, como faria normalmente.
2. **Abra o histórico** — Abra o webhook no seu painel e clique para acessar o histórico.
3. **Expanda a chamada** — Expanda qualquer chamada para ver os cabeçalhos, o corpo, a mensagem gerada e o que deu errado.

## Tudo o que um webhook com falha não vai te contar

Quando um alerta não chega, a pergunta é sempre a mesma: o remetente realmente fez a chamada e, se fez, o que deu errado do nosso lado?

- **Um log de cada requisição** — Cada chamada registrada, da mais recente para a mais antiga, expansível na própria linha. Método, IP de origem, tamanho e tipo de conteúdo à vista.
- **Cabeçalhos e payload completos** — Os cabeçalhos completos e o corpo bruto exatamente como chegaram, para você comparar o que um serviço diz que envia com o que ele de fato enviou.
- **O que o seu template produziu** — Veja a mensagem que o seu template gerou a partir do payload, ao lado do próprio payload. Bugs de template deixam de ser um palpite.
- **Motivos de falha nomeados** — As falhas vêm com um motivo específico: JSON inválido, uma mensagem vazia por causa de um %path% ausente, ou um webhook inativo.
- **Ocultados e criptografados** — Os cabeçalhos Authorization, cookie e chave de API são ocultados antes do armazenamento, e os payloads são criptografados em repouso com a sua chave.
- **Filtrar, paginar ou buscar** — Filtre por resultado e percorra o histórico no painel, ou busque os dados pela API e analise por conta própria.

## Como funciona o histórico de webhooks

    
Cada requisição que chega a uma das suas URLs de webhook é registrada antes de ser processada, e o resultado é anexado quando o processamento termina. Isso significa que você vê as chamadas com falha tão claramente quanto as bem-sucedidas, inclusive as chamadas para um webhook que você desativou e esqueceu.

    
Abra um webhook no painel e o histórico está ali, do mais recente para o mais antigo, com cada linha expandindo para mostrar a query string, os cabeçalhos completos e o corpo com formatação JSON. Os mesmos dados estão disponíveis pela API REST, com filtros para `success` e `error`.

    
## Depurando um template

    
A falha mais comum não é um problema de rede, e sim um placeholder `%path%` apontando para um campo que o remetente na verdade não envia. O histórico mostra o payload bruto e a mensagem que o seu template gerou lado a lado, o que normalmente torna a divergência óbvia em segundos.

    
## Privacidade

    
Payloads costumam conter segredos, por isso são criptografados em repouso com a sua chave pessoal, e os cabeçalhos Authorization, cookie e chave de API são substituídos por `[redacted]` antes do armazenamento. A retenção vai de 7 dias no plano gratuito até um ano completo no Large.

## Perguntas frequentes

### O que é registrado para cada chamada de webhook?

Data e hora, método HTTP, IP de origem, tipo de conteúdo, query string, cabeçalhos completos, o corpo bruto, tamanho do payload, a mensagem gerada pelo seu template, se um alerta foi criado, o motivo da falha quando não foi, e quanto tempo o processamento levou.

### Por quanto tempo o histórico de webhooks é mantido?

7 dias no plano gratuito, 30 no Starter, 90 no Medium e 365 no Large. Chamadas mais antigas são removidas automaticamente, assim como as entradas mais antigas quando um único webhook passa de 1.000 chamadas registradas.

### O payload armazenado é seguro?

Sim. Os payloads são criptografados em repouso com a sua chave pessoal, da mesma forma que o conteúdo das mensagens, e os cabeçalhos Authorization, cookie e chave de API são substituídos por [redacted] antes de qualquer coisa ser armazenada.

### Um serviço diz que enviou o webhook, mas nada chegou. E agora?

O histórico mostra qual é. Se nada foi registrado, o remetente nunca chegou até nós. Se uma chamada foi registrada com erro, você recebe o motivo: JSON inválido, uma mensagem vazia de um %path% que não existe no payload, ou um webhook que estava desativado.

### Onde vejo o histórico?

Abra o webhook no seu painel e o histórico estará ali, do mais recente para o mais antigo, com cada chamada expansível. Também há um endpoint REST, se você preferir buscar os dados programaticamente, com filtros para sucesso e erro.

### O histórico de webhooks funciona no plano gratuito?

Sim, com 7 dias de retenção. Se você precisar de mais tempo, é isso que os planos pagos ampliam.
