Webhook agenta

V panelu Integrace najdete dvě možnosti. Není to totéž a záleží na tom, co druhý systém umí.

• •„Adresa s klíčem“ — jedna dlouhá adresa, ve které je klíč už obsažený. Použijte ji vždy, když má druhý systém jen jedno políčko pro adresu. To je většina nástrojů.
• •„Adresa“ + „Bezpečnostní klíč“ zvlášť — použijte, když systém umí přidat i hlavičku (Authorization). Je to bezpečnější varianta, protože klíč necestuje v adrese.
• •Nevíte? Zkuste najít pole jako „hlavička“, „header“ nebo „autorizace“. Když tam není, je to případ pro adresu s klíčem.
• •Obě varianty jsou přihlašovací údaje. Nedávejte je do veřejných dokumentů ani do e-mailu komukoli mimo firmu; při podezření na únik klíč vyměňte.

Výměna klíče zneplatní obě varianty naráz — po výměně vložte novou adresu (nebo klíč) do druhého systému.

Jedna adresa může přijímat víc druhů událostí (nová objednávka, zrušená objednávka, vrácení peněz). Pravidlo si můžete zúžit jen na ty, které vás zajímají.

• •Název události posílá druhá strana — bývá to pole „event“ nebo „type“ v odesílaných datech. Najdete ho v jejich dokumentaci, nebo si ho přečtete v „Posledních doručeních“ po prvním testu.
• •Necháte-li políčko prázdné, pravidlo reaguje na všechno, co na adresu přijde. Pro většinu lidí je to správná volba.
• •Chcete-li rozdělit chování (jinak na zaplacenou objednávku, jinak na reklamaci), vytvořte dvě pravidla, každé s jiným názvem události.
• •Pozor: pokud pravidlo názvy vyjmenuje a druhá strana žádný název neposílá, pravidlo se nespustí. Nechte pak filtr prázdný.

Systémy své zprávy často opakují, když si nejsou jisté, že dorazily. Aby z jedné objednávky nevznikly dvě odpovědi, používáme identifikátor doručení.

• •Pokud data obsahují „id“ (nebo hlavičku X-Jean-Delivery-Id), Jean si ho zapamatuje.
• •Přijde-li stejné id znovu, událost se přijme, ale agent se už podruhé nespustí — v přehledu ji uvidíte jako „duplicita“.
• •Pokud druhá strana žádné id neposílá, opakované odeslání spustí agenta znovu. Když to vadí, doplňte do odesílaných dat jakýkoli jednoznačný údaj jako „id“ (číslo objednávky).

Otevřete Agent → Integrace → Poslední doručení. Uvidíte i pokusy, které jsme odmítli — a to je většinou přesně ta informace, která chybí, protože druhý systém své chyby nikomu neukazuje.

• •Prázdný seznam = k nám vůbec nic nedorazilo. Zkontrolujte, že máte v druhém systému správnou adresu a že se událost opravdu spustila.
• •„Neplatný podpis“ nebo „neplatný klíč“ = druhá strana posílá jiný klíč, než má agent. Zkopírujte klíč znovu, nebo ho vyměňte a vložte nový.
• •„Chybí klíč“ = zpráva dorazila bez hlavičky Authorization. Doplňte ji ve tvaru „Bearer váš-klíč“.
• •„Tělo není platný JSON“ = druhý systém posílá jiný formát. Bývá to volba v jeho nastavení (JSON vs. formulář).
• •„Žádné pravidlo nečeká“ = doručení proběhlo v pořádku, ale u agenta není zapnuté žádné pravidlo se spouštěčem „Jiný systém“. Nejčastější případ ze všech.
• •„Agent je vypnutý“ = zapněte agenta přepínačem v jeho detailu.
• •„Duplicita“ = stejnou událost jsme už jednou přijali. Většinou správné chování, ne chyba.
• •„Příliš velké tělo“ = zpráva přesáhla 64 kB. Posílejte souhrn nebo odkaz, ne celý obsah.

Seznam ukazuje posledních 50 doručení. Starší se automaticky mažou.

Adresa je veřejná, klíč ne. Co dovolí ten, kdo klíč získá, jsme držel co nejmenší.

• •Událost může agenta rozmyslet, zapsat a připravit koncept. Odeslání e-mailu vždy potvrzujete vy.
• •Klíč vidíte jen ve chvíli vytvoření. Uložte si ho do správce hesel; my ho už znovu neukážeme.
• •Když klíč unikne, vyměňte ho tlačítkem „Vyměnit klíč“ — starý okamžitě přestane platit a nový vložíte do druhého systému.
• •Vypnutím webhooku doručení skončí, ale klíč zůstane. Po opětovném zapnutí adresa funguje dál, takže se nemusíte vracet do nastavení druhého systému.
• •Přijímáme nejvýše 60 událostí za minutu na agenta a zprávy do 64 kB. Rychlejší odesílání dočasně odmítneme.
• •Každý běh, který událost spustí, spotřebuje kredity jako každý jiný běh agenta. U velmi častých událostí to sledujte v přehledu spotřeby.

Do zpráv obvykle patří údaje vašich zákazníků — jméno, e-mail, adresa, hodnota objednávky. Proto je dobré vědět, co se s nimi děje.

• •Správcem těchto údajů zůstáváte vy. Posíláte je z vlastního rozhodnutí a odpovídáte za to, že k tomu máte právní důvod.
• •Z každého doručení ukládáme obsah zprávy (nejvýše 8 kB) a uchováváme posledních 50 doručení u agenta. Starší se automaticky mažou.
• •Obsah zprávy dostane jazykový model, který agenta pohání — stejně jako každý jiný podklad, se kterým agent pracuje.
• •Neposílejte přes webhook zvláštní kategorie údajů (například zdravotní údaje). Služba na to není určena.

Podrobnosti najdete v Ochraně osobních údajů a ve Všeobecných obchodních podmínkách; při zapnutí webhooku toto krátce potvrzujete.