Webhooks
Verificar entrega
Delega ao LiveTP a verificação da assinatura de um webhook recebido.
https://livetp.app/api/webhooks/verify/{endpointId}Para plataformas que não conseguem calcular HMAC localmente, como alguns ambientes do n8n. O receptor envia o corpo bruto e os headers recebidos, e o LiveTP confirma se a assinatura é válida, se o timestamp está no prazo e se o evento foi realmente entregue a este destino.
Este endpoint fica fora de /api/v1 e não aceita chaves de API: ele é autenticado pelo token Bearer do destino, o mesmo configurado em Token Bearer do destino no cadastro do webhook. Copie a URL pronta em Copiar URL de verificação, no destino em Integrações → Webhooks.
A verificação não dá acesso a roteiros nem permite gerenciar o destino. A resposta traz apenas o evento que já foi entregue a esse destino. Cada chamada consome uma leitura do limite da conta dona do destino.
Parâmetros de caminho
ID do destino de webhook.
Headers
Bearer <token do destino>.
Corpo da requisição
Corpo exatamente como recebido, até 16 KiB.
Valor do header webhook-id.
Valor do header webhook-timestamp (10 dígitos).
Valor completo do header webhook-signature.
Resposta
Sempre true em respostas 200.
O evento já interpretado.
Erros
| Status | Código | Quando |
|---|---|---|
401 | invalid_receiver | Token Bearer ausente ou incorreto, ou destino inexistente. |
401 | invalid_signature | Assinatura inválida, timestamp fora do prazo de 5 minutos ou evento de outro destino. |
422 | invalid_input | Corpo fora do formato esperado. |
429 | rate_limited | Limite de leituras da conta atingido. |