Viagilize Vídeos

Webhooks

Viagilize

Tutoriais oficiais · Integracoes

Artigo

Obrigado pelo aviso. O que faltou ou ficou confuso? (opcional)

Recebemos. Vamos rever este vídeo.

1 visualização · · 3:16

Neste vídeo você vai conhecer os Webhooks: o Viagilize avisando o seu sistema, na hora, cada vez que algo acontece aqui dentro. Eles ficam em Configurações, depois APIs e MCP.

Capítulos

Este vídeo responde

  • Como configuro um webhook para receber notificações quando uma reserva for criada?
  • Como testar se o webhook está funcionando antes de colocar em produção?
  • O que fazer quando o webhook está com muitas falhas consecutivas?
  • Por que o meu webhook foi desativado sozinho?
  • Como valido a assinatura do webhook para saber que veio do Viagilize?
  • Onde vejo o histórico de entregas dos webhooks?
  • Quais eventos o Viagilize pode avisar por webhook?
  • O Viagilize tenta enviar de novo quando o meu sistema está fora do ar?
  • Onde fica o secret do webhook e como eu copio ele?
  • O que acontece se eu regenerar o secret do webhook?

#webhook #integracao #api #notificacoes #hmac #assinatura #eventos #logs #reenvio #erp

Transcrição

  1. Onde ficam

    Eles ficam em Configurações, depois APIs e MCP. No topo, Webhooks Ativos conta quantos estão ligados, e a aba Webhooks abre a lista.

  2. A lista de webhooks

    Cada webhook é um endereço do seu sistema que recebe os avisos.

  3. Eventos inscritos

    A linha mostra o nome que você deu, a URL de destino e se ele está ativo. Eventos inscritos diz o que faz o aviso sair: reserva criada, pagamento confirmado, check-in realizado.

  4. O segredo da assinatura

    Nada além desses eventos dispara a chamada. O Secret para validação é o segredo que prova que a chamada saiu daqui, e não de um impostor.

  5. Testar o webhook

    O card mostra só as pontas; o botão de prancheta copia o segredo inteiro. O avião de papel dispara um aviso de teste na hora, sem precisar de uma venda de verdade: é assim que você confere o destino antes de entrar em produção.

  6. Editar, trocar o segredo e excluir

    Ao lado fica o último disparo. O lápis edita nome, URL e eventos.

  7. Novo Webhook

    A seta circular troca o segredo, e aí o seu sistema precisa ser atualizado. A lixeira apaga o webhook.

  8. Marcar os eventos

    Novo Webhook abre a janela de cadastro. O Nome é só para você se achar na lista; a URL de Destino precisa ser um endereço HTTPS válido que responda com sucesso. Ainda nessa janela, em Eventos para Notificar você marca o que interessa, em grupos: Reservas, Pagamentos, Check-in, Excursões, Experiências, Clientes e Contratos.

  9. Quando o webhook falha

    Ao menos um é obrigatório, e aqui eu só cancelo a janela. Quando as entregas começam a falhar, o próprio card mostra a contagem.

  10. Validação da assinatura

    Com dez falhas seguidas o webhook é desativado sozinho e para de enviar, e Reativar volta com ele depois que você corrigir o destino. Mais abaixo, Validação de Webhooks explica o cabeçalho X-Viagilize-Signature: o seu sistema recalcula o HMAC SHA256 do conteúdo com o segredo e compara antes de aceitar o aviso.

  11. Reenvio automático

    E o reenvio: erro de rede ou falha do servidor é tentado de novo em um minuto, cinco, quinze, uma hora e duas horas. Erro de endereço, como 404, não é reenviado. Na aba Logs, em Webhooks, fica o histórico de cada aviso enviado, com o evento, o código que o destino devolveu e o tempo de resposta.

  12. Histórico de entregas

    É aqui que você descobre por que um aviso não chegou. Pronto. Os webhooks ficam em Configurações, APIs e MCP, na aba Webhooks. Até a próxima. Os dados deste vídeo são fictícios, criados só para a demonstração.