Pular para o conteúdo
TicketingHub Help

Como configurar webhooks

Os webhooks enviam eventos selecionados do TicketingHub para outro sistema à medida que ocorrem.

Antes de começar

  • Os webhooks têm de estar ativados na sua conta do TicketingHub. Contacte o TicketingHub se a secção Webhooks não estiver disponível.
  • Precisa de acesso de administrador ou gestor.
  • O sistema recetor tem de fornecer um URL HTTPS público.

Adicionar um webhook

  1. Aceda a Definições → Avançado.
  2. Procure Webhooks e selecione Editar.
  3. Selecione Novo webhook.
  4. Introduza o URL HTTPS que irá receber os eventos.
  5. Selecione os tipos de eventos a enviar, como uma reserva confirmada ou cancelada.
  6. Opcional: introduza um segredo forte para que o sistema recetor possa verificar cada pedido.
  7. Crie o webhook e, em seguida, execute um dos eventos selecionados para o testar.

Se adicionar um segredo, o TicketingHub assina cada pedido e envia a assinatura no cabeçalho X-TicketingHub-Signature-256. O seu programador deve verificar esta assinatura antes de aceitar os dados.

Manter o webhook ativo

O sistema recetor deve responder prontamente com um estado 2xx bem-sucedido. O TicketingHub tenta novamente entregar os eventos quando as entregas excedem o tempo limite ou devolvem uma resposta sem êxito. Um endpoint que continue a falhar é desativado automaticamente; corrija o sistema recetor e, em seguida, volte à página Webhooks e ative-o novamente.

O TicketingHub só envia eventos para endereços públicos. Se o URL apontar para um endereço de rede privada, como um servidor dentro da sua própria rede, o TicketingHub não envia o evento e desativa o webhook imediatamente. A página Webhooks apresenta a mensagem “O URL aponta para um endereço de rede privada” e os administradores da sua conta recebem um e-mail. Altere o URL para um endereço HTTPS público e, em seguida, ative o webhook novamente.

Escolha apenas os eventos de que precisa e evite utilizar um URL de teste numa conta ativa. Para enviar eventos para o Zapier sem criar o seu próprio recetor, consulte Como ligar o TicketingHub ao Zapier. Para criar uma integração que também solicite dados ao TicketingHub, consulte Como criar e utilizar um token de API.