Salta ai contenuti
TicketingHub Help

Come configurare i webhook

I webhook inviano gli eventi selezionati di TicketingHub a un altro sistema non appena si verificano.

Prima di iniziare

  • I webhook devono essere abilitati per il proprio account TicketingHub. Contattare TicketingHub se la sezione Webhook non è disponibile.
  • È necessario disporre dell’accesso come amministratore o manager.
  • Il sistema ricevente deve fornire un URL HTTPS pubblico.

Aggiungere un webhook

  1. Accedere a Impostazioni → Avanzate.
  2. Individuare Webhook e selezionare Modifica.
  3. Selezionare Nuovo webhook.
  4. Inserire l’URL HTTPS che riceverà gli eventi.
  5. Selezionare i tipi di evento da inviare, ad esempio una prenotazione confermata o annullata.
  6. Facoltativo: inserire un segreto complesso affinché il sistema ricevente possa verificare ogni richiesta.
  7. Creare il webhook, quindi eseguire una delle azioni selezionate per testarlo.

Se si aggiunge un segreto, TicketingHub firma ogni richiesta e invia la firma nell’header X-TicketingHub-Signature-256. Il proprio sviluppatore dovrebbe verificare questa firma prima di accettare i dati.

Mantenere attivo il webhook

Il sistema ricevente dovrebbe rispondere tempestivamente con uno stato 2xx positivo. TicketingHub ritenta le consegne che scadono per timeout o restituiscono una risposta non valida. Un endpoint che continua a non funzionare viene disabilitato automaticamente; risolvere il problema nel sistema ricevente, quindi tornare alla pagina Webhook e abilitarlo nuovamente.

TicketingHub invia gli eventi solo a indirizzi pubblici. Se l’URL punta a un indirizzo di rete privata, ad esempio a un server all’interno della sua rete, TicketingHub non invia l’evento e disabilita immediatamente il webhook. Nella pagina Webhook viene visualizzato il messaggio “L’URL punta a un indirizzo di rete privata” e gli amministratori del suo account ricevono un’e-mail. Modifichi l’URL inserendo un indirizzo HTTPS pubblico, quindi abiliti nuovamente il webhook.

Scegliere solo gli eventi necessari ed evitare di utilizzare un URL di test in un account attivo. Per inviare eventi a Zapier senza creare un proprio sistema ricevente, consultare Come collegare TicketingHub a Zapier. Per creare un’integrazione che richieda anche dati a TicketingHub, consultare Come creare e utilizzare un token API.