Preskočiť na obsah
TicketingHub Help

Ako nastaviť webhooky

Webhooky odosielajú vybrané udalosti zo služby TicketingHub do iného systému hneď, ako nastanú.

Skôr než začnete

  • Webhooky musia byť povolené pre váš účet TicketingHub. Ak sekcia Webhooky chýba, kontaktujte TicketingHub.
  • Potrebujete prístup správcu alebo manažéra.
  • Prijímajúci systém musí poskytovať verejnú adresu URL HTTPS.

Pridanie webhooku

  1. Prejdite do časti Nastavenia → Rozšírené.
  2. Nájdite položku Webhooky a vyberte možnosť Upraviť.
  3. Vyberte možnosť Nový webhook.
  4. Zadajte adresu URL HTTPS, na ktorú sa budú odosielať udalosti.
  5. Vyberte typy udalostí, ktoré sa majú odosielať, napríklad potvrdenú alebo zrušenú rezerváciu.
  6. Voliteľné: zadajte silný tajný kľúč, aby prijímajúci systém mohol overiť každú požiadavku.
  7. Vytvorte webhook a potom vykonajte jednu z vybraných udalostí na jeho otestovanie.

Ak pridáte tajný kľúč, TicketingHub podpíše každú požiadavku a odošle podpis v hlavičke X-TicketingHub-Signature-256. Pred prijatím údajov by mal váš vývojár tento podpis overiť.

Udržiavanie aktívneho webhooku

Prijímajúci systém by mal bezodkladne odpovedať úspešným stavovým kódom 2xx. TicketingHub opakuje doručenie požiadaviek, ktorých spracovanie vypršalo alebo pri ktorých bola vrátená neúspešná odpoveď. Koncový bod, pri ktorom naďalej dochádza k chybám, sa automaticky deaktivuje. Opravte prijímajúci systém, potom sa vráťte na stránku Webhooky a znova ho povoľte.

TicketingHub odosiela udalosti iba na verejné adresy. Ak adresa odkazuje na adresu v súkromnej sieti, napríklad na server vo vašej vlastnej sieti, TicketingHub udalosť neodošle a webhook okamžite deaktivuje. Na stránke Webhooky sa zobrazí hlásenie „Adresa odkazuje na adresu v súkromnej sieti“ a správcovia vášho účtu dostanú e-mail. Zmeňte adresu na verejnú adresu HTTPS a potom webhook znova aktivujte.

Vyberte iba udalosti, ktoré potrebujete, a v aktívnom účte nepoužívajte testovaciu adresu URL. Ak chcete odosielať udalosti do služby Zapier bez vytvárania vlastného prijímača, pozrite si článok Ako prepojiť TicketingHub so službou Zapier. Ak chcete vytvoriť integráciu, ktorá zároveň požaduje údaje zo služby TicketingHub, pozrite si článok Ako vytvoriť a používať token API.