Automatizace Transeptu pomocí webhooků

Otevřete uložený pracovní postup v nástroji pro tvorbu a podívejte se na kartu spouštěče nahoře – tu, na které je napsáno Spouštíte ručně. Je to přepínač. Ručně je výchozí volba: spuštění provádíte sami. Webhook přidělí pracovnímu postupu soukromou URL adresu, na kterou externí systém odesílá POST požadavky, takže se spuštění provede automaticky. Spouštěč patří k uloženému pracovnímu postupu, proto jej nejprve uložte – u neuloženého konceptu zůstane možnost Webhook neaktivní.

Přepněte kartu na Webhook, nastavte, na co se má spuštění vztahovat (viz níže), a uložte. Transept pro tento konkrétní workflow vygeneruje tajnou URL adresu a zobrazí ji pouze jednou – tehdy si ji zkopírujte, protože se ukládá pouze hash a celou URL adresu už nebude možné znovu zobrazit. Tajný klíč je obsažen přímo v URL adrese, nikoli v hlavičce, protože nejjednodušší odesílatelé neumí hlavičky nastavit; zacházejte tedy s URL adresou jako s heslem – kdokoli ji má, může spuštění vyvolat.

Když kartu otevřete později, uvidíte místo celé URL adresy zamaskovaný prefix (whk_live_…) a akci Obnovit. Obnovením se vygeneruje nová URL adresa a ta stará se v okamžiku potvrzení zneplatní, což je způsob, jak vyřadit odkaz, který unikl. Spouštěč můžete také vypnout, aniž byste jej smazali, nebo jej odstranit úplně. Na kartě je vidět, kdy došlo k poslednímu spuštění.

O tom, co pracovní postup při aktivaci URL adresy ovlivní, rozhodují dvě nastavení:

• Cíl – buď konkrétní dokument, který určíte (každé spuštění se pak týká tohoto dokumentu a jeho jazykové skupiny), nebo stránka v Notion uvedená v příchozích datech (Transept ji spáruje s vaším dokumentem a jakmile ji poprvé rozpozná, importuje ji).
• Jazyky – všechny jazykové verze (výchozí nastavení; spuštění se rozšíří na všechny jazyky cíle jako hromadné spuštění), nebo pouze tento jeden dokument.
• Pouze aktualizovaný obsah – ve výchozím nastavení zapnuto, protože automatizované spuštění by mělo znovu zpracovat jen to, co se od posledně změnilo, a ne při každém spuštění překládat celý dokument znovu. Viz Spouštět pouze u změn.

Automatizace databáze Notion může vyvolat spouštěč pomocí své akce Odeslat webhook: nasměrujte akci na URL adresu spouštěče a při každém spuštění automatizace Transept spustí pracovní postup na stránce, která jej vyvolala. Než se na to začnete spoléhat, je dobré vědět dvě věci.

Zaprvé, automatizace v Notion se spouštějí při změně vlastnosti (nebo u nové stránky), nikoli pouze při úpravě obsahu – samotná editace textu stránky tedy nemusí nic spustit. Spolehlivým vzorcem je vlastnost Status, kterou automatizace sleduje: změňte ji (například na Ready to translate) a tato změna poslouží jako signál.

Zadruhé, webhook z Notion pouze identifikuje stránku – nikdy nepřenáší její obsah – takže Transept čte stránku prostřednictvím vašeho propojení s Notion, kterému musí být udělen přístup k databázi přímo v Notion. Oba kroky (propojení Notion a následné sdílení databáze s integrací) jsou popsány v části „Spouštěče Notion: udělení přístupu pro Transept“ v dokumentu Automatizace Transeptu pomocí API. Pokud některý z nich vynecháte, každé spuštění bude odmítnuto s chybou přístupu.

Spouštěč může aktivovat cokoli, co dokáže odeslat HTTP POST – krok v Zapieru nebo n8n, úloha CI nebo příkaz curl na konci sestavení. U cíle typu konkrétní dokument na těle požadavku nezáleží, takže stačí prázdný POST; pouze cíl typu stránka v Notion tělo čte, aby zjistil, která stránka se změnila. Není potřeba žádná hlavička Authorization – celá URL adresa slouží jako tajný klíč.

Ve výchozím nastavení se při spuštění provede pracovní postup ve všech jazykových verzích a – se zapnutou funkcí Pouze aktualizovaný obsah – se znovu přeloží pouze ty bloky, jejichž zdroj se od posledního spuštění změnil. Drobná úprava tak stojí jen pár bloků, nikoli celý dokument. Spuštění zahájená tímto způsobem účtují slova úplně stejně jako v editoru aplikace, a pokud zůstatek na spuštění nestačí, nic se neodešle ani neúčtuje.

Krok nastavený na čekat na vaši kontrolu se i nadále pozastaví: spuštění provede překlad až k tomuto bodu a tam se zastaví. Daný jazyk se pak zobrazí v panelu editoru Připraveno ke kontrole, abyste jej mohli schválit – automatizace vaše kontrolní body nepřeskakuje. A pokud nelze načíst cíl stránka v Notion (obvykle proto, že databáze nebyla sdílena s integrací), na kartě spouštěče se zobrazí poslední chyba jako poznámka „nepodařilo se načíst stránku Notion“ s časovým údajem, abyste viděli, proč spuštění nic neudělalo.