Webhooks assinados para cada evento de reserva e pagamento
Transmite cada evento de reserva e pagamento para os teus sistemas — CRM, data warehouse, Slack, integrações personalizadas. Assinados com HMAC, retentados com backoff exponencial, totalmente registados. Feito para equipas de engenharia que se recusam a fazer polling a uma API.
Porque as equipas de engenharia escolhem os webhooks Triviyo
Padrões comuns, comportamento previsível e um registo de entregas que realmente ajuda a depurar.
Assinaturas HMAC em cada payload
Cada webhook é assinado com HMAC-SHA256 usando o segredo do teu endpoint. Verifica a assinatura antes de agir sobre o payload — o mesmo padrão do Stripe, do GitHub e de qualquer webhook em que já confias.
Retentativas com backoff exponencial
Se o seu endpoint não responder a tempo ou devolver 408, 429 ou 5xx, o Triviyo tenta a entrega novamente de forma automática, até 6 tentativas no total. Qualquer outra resposta 4xx é considerada definitiva e não é repetida.
Nomes de eventos padrão
BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Subscreve exatamente os eventos de que a tua integração precisa; ignora os restantes.
Chave de assinatura por endpoint
Cada endpoint tem a sua própria chave de assinatura, que pode gerar novamente a qualquer momento em Definições → Webhooks.
Registo completo de entregas
Cada tentativa de entrega fica registada no painel com o estado HTTP, a resposta e a hora.
Webhooks Triviyo vs. polling a uma API REST
Como fica o streaming de eventos em tempo real comparado com martelar um endpoint REST.
| O que a API de webhooks inclui | Triviyo | Without Triviyo |
|---|---|---|
| Disponibilidade | A partir do plano Professional | Apenas acesso à API Enterprise |
| BOOKING_CREATED | ||
| BOOKING_UPDATED | ||
| BOOKING_CANCELED | ||
| PAYMENT_SUCCEEDED | ||
| Assinaturas HMAC-SHA256 | Extra Enterprise | |
| Estratégia de retentativas | Até 6 tentativas | Uma tentativa ou nenhuma |
| Registo de entregas | ||
| Suporte | Suporte prioritário | Fila de tickets por e-mail |
Padrões standard — nada exótico, nada proprietário.
Perguntas frequentes
A que eventos posso subscrever?
BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Subscreve por endpoint exatamente o que a tua integração precisa.
Como verifico que o webhook vem mesmo do Triviyo?
Cada payload é assinado com HMAC-SHA256 usando o segredo único do teu endpoint. Verifica o cabeçalho X-Webhook-Signature contra o corpo bruto do pedido antes de agir — o mesmo padrão dos webhooks do Stripe e do GitHub. Exemplos de código estão na nossa documentação.
O que acontece se o meu endpoint estiver em baixo?
O Triviyo faz até 6 tentativas de entrega no total. Após a última, a entrega é marcada como falhada no registo de entregas. Uma resposta 4xx diferente de 408 e 429 marca a entrega como falhada de imediato, sem novas tentativas.
Posso testar webhooks num ambiente de staging?
Sim. Envie uma entrega de teste para qualquer endpoint em Definições → Webhooks para verificar a integração antes de entrar em produção.
Que escalão preciso para webhooks?
A partir do plano Professional.
Constrói integrações em tempo real sem polling
Assinado, retentado, registado — exatamente como as equipas de engenharia esperam que os webhooks funcionem.
Teste gratuito de 14 dias. Sem cartão de crédito. Cancela quando quiseres.