Hoppa till innehåll
TicketingHub Help

Så konfigurerar du webhooks

Webhooks skickar utvalda TicketingHub-händelser till ett annat system när de inträffar.

Innan du börjar

  • Webhooks måste vara aktiverade för ditt TicketingHub-konto. Kontakta TicketingHub om avsnittet Webhooks saknas.
  • Du behöver administratörs- eller manageråtkomst.
  • Det mottagande systemet måste tillhandahålla en offentlig HTTPS-URL.

Lägg till en webhook

  1. Gå till Inställningar → Avancerat.
  2. Leta reda på Webhooks och välj Redigera.
  3. Välj Ny webhook.
  4. Ange den HTTPS-URL som ska ta emot händelserna.
  5. Välj vilka händelsetyper som ska skickas, till exempel en bekräftad eller avbruten bokning.
  6. Valfritt: ange en stark hemlig nyckel så att det mottagande systemet kan verifiera varje begäran.
  7. Skapa webhooken och utför sedan en av de valda händelserna för att testa den.

Om du lägger till en hemlig nyckel signerar TicketingHub varje begäran och skickar signaturen i headern X-TicketingHub-Signature-256. Din utvecklare bör verifiera denna signatur innan data tas emot.

Håll webhooken aktiv

Det mottagande systemet bör snabbt svara med en lyckad 2xx-statuskod. TicketingHub försöker leverera igen om leveranserna tar slut på tid eller returnerar ett misslyckat svar. En slutpunkt som fortsätter att misslyckas inaktiveras automatiskt. Åtgärda problemet i det mottagande systemet och gå sedan tillbaka till sidan Webhooks och aktivera den igen.

TicketingHub skickar endast händelser till offentliga adresser. Om URL:en pekar på en privat nätverksadress, till exempel en server i ditt eget nätverk, skickar TicketingHub inte händelsen och inaktiverar webhooken direkt. På sidan Webhooks visas “URL:en pekar på en privat nätverksadress” och administratörerna för ditt konto får ett e-postmeddelande. Ändra URL:en till en offentlig HTTPS-adress och aktivera sedan webhooken igen.

Välj bara de händelser du behöver och undvik att använda en test-URL i ett aktivt konto. Om du vill skicka händelser till Zapier utan att bygga en egen mottagare kan du läsa Så ansluter du TicketingHub till Zapier. Om du vill bygga en integration som även begär data från TicketingHub kan du läsa Så skapar och använder du en API-token.