Gå til indhold
TicketingHub Help

Sådan opsætter du webhooks

Webhooks sender udvalgte TicketingHub-hændelser til et andet system, efterhånden som de finder sted.

Før du begynder

  • Webhooks skal være aktiveret for din TicketingHub-konto. Kontakt TicketingHub, hvis sektionen Webhooks mangler.
  • Du skal have administrator- eller manageradgang.
  • Det modtagende system skal stille en offentlig HTTPS-URL til rådighed.

Tilføj en webhook

  1. Gå til Indstillinger → Avanceret.
  2. Find Webhooks, og vælg Rediger.
  3. Vælg Ny webhook.
  4. Indtast den HTTPS-URL, der skal modtage hændelserne.
  5. Vælg de hændelsestyper, der skal sendes, f.eks. en bekræftet eller annulleret booking.
  6. Valgfrit: Indtast en stærk hemmelighed, så det modtagende system kan verificere hver forespørgsel.
  7. Opret webhooken, og udløs derefter en af de valgte hændelser for at teste den.

Hvis du tilføjer en hemmelighed, signerer TicketingHub hver forespørgsel og sender signaturen i headeren X-TicketingHub-Signature-256. Din udvikler bør verificere denne signatur, før dataene accepteres.

Hold webhooken aktiv

Det modtagende system bør hurtigt svare med en vellykket 2xx-status. TicketingHub forsøger igen at levere hændelser, hvis forespørgsler får timeout eller returnerer et mislykket svar. Et endepunkt, der fortsat fejler, deaktiveres automatisk. Afhjælp problemet i det modtagende system, og gå derefter tilbage til siden Webhooks, hvor du kan aktivere webhooken igen.

TicketingHub sender kun hændelser til offentlige adresser. Hvis URL’en peger på en privat netværksadresse, f.eks. en server på dit eget netværk, sender TicketingHub ikke hændelsen og deaktiverer webhooken med det samme. Siden Webhooks viser “URL’en peger på en privat netværksadresse”, og administratorerne af din konto modtager en e-mail. Skift URL’en til en offentlig HTTPS-adresse, og aktivér derefter webhooken igen.

Vælg kun de hændelser, du har brug for, og undgå at bruge en test-URL på en livekonto. Hvis du vil sende hændelser til Zapier uden at bygge din egen modtager, kan du se Sådan forbinder du TicketingHub med Zapier. Hvis du vil bygge en integration, der også anmoder om data fra TicketingHub, kan du se Sådan opretter og bruger du et API-token.