Seus webhooks deixam de ser uma caixa-preta.
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.
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.
Descubra o que realmente chegou
Aponte um serviço para ele
Crie um webhook e aponte o seu serviço para a URL dele, como faria normalmente.
Abra o histórico
Abra o webhook no seu painel e clique para acessar o histórico.
Expanda a chamada
Expanda qualquer chamada para ver os cabeçalhos, o corpo, a mensagem gerada e o que deu errado.
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.
Dúvidas respondidas
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.
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.
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.
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.
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.
Sim, com 7 dias de retenção. Se você precisar de mais tempo, é isso que os planos pagos ampliam.
Pare de adivinhar por que o alerta nunca chegou
Aponte um serviço para um webhook da Pocket Alert e cada chamada que ele fizer fica registrada, tenha o alerta funcionado ou não.