Vibee

Pro správce aplikace

Jak přijímat události z jiných systémů

Nechte e-shop, dopravce nebo jiný program poslat novinku přímo do aplikace: objednávku, stav zásilky nebo úhradu.

Nejdřív ověřte, co potřebujete

Příchozí webhook je adresa, na kterou vám jiný systém sám pošle novinku: objednávku z e-shopu, změnu stavu zásilky nebo zaplacenou fakturu. Aplikace ji zapíše jako nový nebo změněný záznam a nikdo nemusí nic přepisovat ručně.

Potřebujete dvě věci. Rozšíření Webhooky u aplikace (dostupnost a cenu ověřte v Rozšířeních) a systém, který po události umí zavolat vámi zadanou adresu. V e-shopu nebo programu se to obvykle jmenuje Webhooky nebo Notifikace. Pokud je neumí, může události posílat Zapier nebo Make s pevnou hlavičkou.

Zkontrolovat rozšíření aplikace

Jak to funguje

  1. Aplikace dostane adresu

    Asistent pro každý příchozí webhook vytvoří adresu a tajné heslo. Heslo se ukáže jen jednou, hned ho uložte.

  2. Odesílatel událost podepíše

    E-shop nebo program k události přidá podpis, který jde vytvořit jen s tím heslem. Událost bez správného podpisu aplikace odmítne.

  3. Aplikace ji zapíše

    Údaje z události se přenesou do sloupců, které určíte. Zápis projde stejnými pravidly jako formulář: povinná pole, kontroly i limity.

  4. Opakování se nezapíše dvakrát

    Když odesílatel stejnou událost pošle znovu, protože nedostal odpověď, aplikace ji zapíše jen jednou.

Požádejte asistenta

Webhook nastavuje váš asistent. Řekněte mu, odkud události přijdou a co se má s nimi stát. Pokud odesílatel tajné heslo vygeneruje sám, napište ho asistentovi hned při zadání, aby ho použil místo nového.

Objednávky z e-shopu
V aplikaci [název] přidej příchozí webhook pro objednávky z e-shopu. Nejdřív ověř, že aplikace má rozšíření Webhooky. Událost typu objednávka vytvořena zapiš jako novou objednávku s položkami, číslo objednávky a e-mail vezmi z údajů události. Stejnou událost nezapisuj dvakrát. Napiš mi adresu, tajné heslo a jak se události podepisují, abych to nastavil v e-shopu.
Stav zásilky od dopravce
Přidej příchozí webhook od dopravce: když přijde nový stav zásilky, změň stav u objednávky se stejným číslem zásilky. Dopravce pošle heslo v hlavičce Authorization.

Co nastavit u odesílatele

  1. Vložte adresu

    V nastavení webhooků e-shopu nebo programu zadejte adresu, kterou vám asistent dal.

  2. Nastavte heslo a podpis

    Asistent řekne, jakou hlavičku a jaký podpis aplikace čeká. Heslo vložte tam, kam to nastavení odesílatele určuje, a nikam jinam.

  3. Vyberte druhy událostí

    Pošlete jen ty, které chcete zapisovat. Ostatní aplikace potvrdí a zahodí, takže odesílatele nezlobí.

Vyzkoušejte to

Vytvořte testovací objednávku nebo změňte stav testovací zásilky a v aplikaci zkontrolujte záznam. Odesílatelé obvykle ukazují, zda poslední doručení uspělo. Před ostrým provozem zkuste i událost, která se zapsat nemá, a opakované doručení téže události.

Když to nefunguje

Odesílatel hlásí chybu 401

Podpis nebo heslo nesedí. Zkontrolujte, že odesílatel používá heslo od asistenta a stejnou hlavičku. Pokud podpis sedí, ale doručení je staré, aplikace ho odmítne jako opakování; zkontrolujte čas v odesílateli.

Odesílatel hlásí chybu 400 nebo 422

Událost se nepodařilo zapsat: chybí údaj, který aplikace vyžaduje, nebo ho pravidlo odmítlo. Napište asistentovi název aplikace a čas pokusu. Odmítnuté události jsou v záznamu chyb pod názvem webhooku.

Když se údaje neuloží
Objednávka v aplikaci není, ale odesílatel hlásí úspěch

Zřejmě jde o druh události, který webhook nepřijímá. Ostatní se potvrdí a zahodí. Požádejte asistenta o kontrolu, které druhy událostí webhook bere.

Ztratil jsem tajné heslo

Znovu se zobrazit nedá. Požádejte asistenta, aby webhook smazal a založil znovu, a nové heslo zadejte u odesílatele.

Chci webhook změnit

Změna se dělá smazáním a novým založením. Heslo je pak nové a je potřeba ho zadat u odesílatele.

Bezpečnost a meze

Odesílatel nemá přístup do aplikace ani k jejím datům. Může jen poslat událost a ta se zapíše jediným předem určeným postupem aplikace, s jejími pravidly. Heslo nikomu neposílejte e-mailem ani v chatu mimo svého asistenta.

Přijímá se jen JSON do 512 kB. Webhook nic nevolá zpět: stav pro odesílatele posílají odchozí webhooky. Platební brány s vlastním postupem, například Comgate nebo GoPay, takto zatím napojit nejde. Platby kartou přes Stripe řeší samostatné rozšíření.

Jak přijímat platby kartou