Webhook zasílá informace do jiné aplikace na základě událostí ve Fakturoidu. Dojde-li k nějaké změně u faktur, nákladů, kontaktů nebo skladových položek, robot o tom dá automaticky vědět podle vašeho nastavení.
Obsah článku
K čemu webhooky slouží
Jsou efektivnější alternativou k periodickému kontrolování událostí (events) v API. Využijete je například při napojení na eshop - zadáte adresu, kam vám pošleme webhook s informací o zaplacení faktury, na základě které váš eshop připraví objednávku k odeslání.
Další podrobnosti, příklady a technické podklady k webhookům v robotově API dokumentaci.
Nastavení ve Fakturoidu
Možnost přidávat a spravovat webhooky najdete v Nastavení → Napojení na jiné aplikace → Webhooky.
Můžete zde vytvářet nové webhooky, upravovat ty existující, nebo je hromadně aktivovat či deaktivovat.
Vytvoření webhooku
Stačí vyplnit adresu webhooku a vybrat události, o kterých má robot informovat.
Používáte-li autorizaci, vyplňte políčko pod adresou a bude se odesílat v hlavičce jako auth_header.
Alternativně doporučujeme přidat unikátní token do adresy webhooku, který ve své aplikaci zkontrolujete a ověříte si tak, že webhook opravdu přišel z Fakturoidu.
Webhooky jsou dostupné v placených tarifech.
Časté otázky
Mají webhooky Fakturoidu nastavené pevné FQDN nebo rozsah IP adres?
Webhooky z Fakturoidu nemají pevně stanovené FQDN ani rozsah IP adres. Doporučujeme nespoléhat na rozsah IP nebo FQDN, můžou se měnit. Využijte možnosti nastavit authorization hlavičku. Podrobnosti naleznete zde
Mohu spravovat webhooky přes API?
Ano, v režimu "Client credentials flow" si můžete správu webhooků přes API zapnout přímo ve vašem účtu takto:
- Klikněte na název vašeho účtu v pravém horním rohu.
- Vyberte Nastavení.
- Klikněte na Uživatelský účet.
- Vyberte API přístupy.
- Klikněte modrý název přístupu.
- Klikněte na Upravit.
- Přepínátkem zapněte správu webhooků přes API.
Pokud jste integrátor (režim "Authorization code flow") a potřebujete povolit správu webhooků přes API, napište nám na podpora@fakturoid.cz
