Webhooks

Webhooks em tempo real que nunca falham um evento

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.

Teste gratuito de 14 dias. Sem cartão de crédito.

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.

Dispara em menos de um segundo

Os eventos são despachados em menos de 500 ms depois da ação que os despoleta — sem polling, sem atraso, sem reservas perdidas. Os teus sistemas a jusante ficam em sincronia perfeita com o Triviyo.

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 teu endpoint devolver algo diferente de 2xx, o Triviyo retenta com backoff exponencial durante até 72 horas. As falhas transitórias resolvem-se sem intervenção manual — e podes repetir qualquer evento a partir do registo de entregas.

Nomes de eventos padrão

booking.created, booking.updated, booking.cancelled, payment.succeeded — os nomes que qualquer engenheiro espera. Subscreve exatamente os eventos de que a tua integração precisa; ignora os restantes.

Segredos e allowlists por endpoint

Cada endpoint recebe o seu próprio segredo de assinatura e uma allowlist de IP opcional no lado recetor. Roda segredos sem downtime e restringe endpoints apenas à tua infraestrutura.

Registo completo de entregas com repetição

Cada tentativa de entrega é registada com código de estado, corpo da resposta e carimbo temporal — disponível no dashboard e via API. Repete manualmente qualquer evento quando o teu ambiente de staging falhou um.

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 incluiTriviyoWithout Triviyo
Tempo de configuraçãoMenos de 15 minutosDias a construir um poller
DisponibilidadeA partir do plano ProfessionalApenas acesso à API Enterprise
booking.created
booking.updated
booking.cancelled
payment.succeeded
Assinaturas HMAC-SHA256Extra Enterprise
Estratégia de retentativasBackoff exponencial, janela de 72 hUma tentativa ou nenhuma
Registo de entregas com repetição
SuporteEquipa de engenharia no SlackFila de tickets por e-mail

Padrões standard — nada exótico, nada proprietário.

Equipas de engenharia que usam webhooks Triviyo em produção

Apagámos 400 linhas de código de polling no dia em que os webhooks Triviyo saíram. O booking.created chega ao nosso data warehouse em menos de um segundo — os dashboards de atribuição e receita são finalmente em tempo real, não com atraso de 15 minutos.
Maya Lindqvist
Diretora de engenharia, Nordic Trek Collective
-400 linhas de código de polling
O registo de entregas é o herói esquecido. Quando a nossa integração com Slack falhou num feriado, repeti 30 eventos perdidos a partir do dashboard enquanto a equipa de plataforma estava fora. Sem perda de dados, sem escalonamento.
Diego Fernández
Engenheiro sénior, Coastal Expeditions
100% de entrega via repetição

Perguntas frequentes

A que eventos posso subscrever?

booking.created, booking.updated, booking.cancelled e payment.succeeded no lançamento. Mais eventos (payment.refunded, waiver.signed, checkin.completed, gift_card.redeemed) chegam em atualizações graduais. 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-Triviyo-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 retenta com backoff exponencial durante até 72 horas — começando com 1 minuto, depois 5, 25, 2h, 6h, 24h. Depois disso, o evento fica no registo de entregas onde o podes repetir manualmente assim que o teu endpoint recuperar.

Posso testar webhooks num ambiente de staging?

Sim. Todos os planos incluem um modo de teste com endpoints de webhooks próprios e eventos falsos. Dispara qualquer evento a partir do dashboard para validar a tua integração antes de entrar em produção — e repete-o quantas vezes precisares.

Que escalão preciso para webhooks?

A partir do plano Professional. Os planos Starter têm acesso ao dashboard e relatórios completos; os webhooks desbloqueiam no Professional porque exigem investimento sustentado em infraestrutura do nosso lado para cumprir garantias de latência e entrega.

Há limite de taxa?

Sem limite de taxa rígido — entregamos de bom grado centenas de eventos por minuto ao teu endpoint. Se o teu endpoint tiver dificuldades, abrandamos automaticamente e retentamos em vez de descartar eventos.

Constrói integrações em tempo real sem polling

Cria o teu primeiro endpoint de webhook em 15 minutos. 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.