Řešení selhání webhooku v aplikaci Workspace Studio

Vytvořili jste tok v Google Workspace Studiu a přidali jste krok Odeslat webhook A požadavek nikdy nedorazí do cíle. Nebo možná proces fungoval a nyní došlo k chybě. Než URL adresu naslepo změníte, stojí za to to prozkoumat. V jakém okamžiku se exekuce zastaví?: přístup ke kroku, čekající schválení, konfigurace požadavku nebo odpověď od externí služby.

Workspace Studio používá tento krok k odeslání HTTP požadavek na konkrétní adresuToto lze použít k upozornění interního nástroje, vytvoření záznamu v jiné aplikaci nebo odeslání dat do služby, která nemá přímý konektor. Řešení závisí na tom, zda k zablokování dochází v rámci Google Workspace nebo na serveru, který požadavek přijímá.

Zkontrolujte, zda administrátor povolil webhooky

Si Odeslat webhook Nezobrazuje se mezi dostupnými kroky; začněte s oprávněními organizace. Google uvádí, že tato funkce je... ve výchozím nastavení zakázáno a že administrátor ji musí pro příslušnou organizační jednotku povolit. Cesta je Administrátorská konzole > Aplikace > Google Workspace > Workspace Studio > Nastavení webhooku.

Také zkontrolujte, zda má váš účet přístup k této funkci: Google i nadále identifikuje předávání webhooků jako funkci v omezený náhledPokud nejste administrátor, sdělte administrátorovi pracovního prostoru název chybějícího kroku, svůj účet a organizační jednotku, do které patříte. To mu umožní ověřit příslušná nastavení, aniž by to ovlivnilo oprávnění ostatních týmů.

Zkontrolujte seznam povolených URL adres a schválení

V některých edicích může administrátor omezit externí cíle pomocí seznam povolených domén a URL adresPokud krok existuje, ale nemůžete se připojit ke konkrétnímu koncovému bodu, ověřte, zda je vaše doména nebo URL adresa v tomto seznamu. Toto nastavení se spravuje z možností importu a načítání URL adres Disku a Dokumentů.

Toto omezení Nefunguje to ve všech edicích stejněSeznam povolených webhooků je k dispozici v edicích jako Business Plus, Enterprise Standard a Plus a Education Standard a Plus. V edicích, které tuto kontrolu nenabízejí, umožňuje povolení webhooků připojení k platným URL adresám bez použití tohoto seznamu povolených. Proto je vhodné nejprve zkontrolovat vaši edici a zásady vaší organizace.

Tok může také čekat na schválení uživatelemGoogle považuje odesílání dat do externího koncového bodu za citlivou akci a ve výchozím nastavení vyžaduje kontrolu a potvrzení. Pokud se zdá, že automatizace se zasekla, otevřete Studio a před závěrem, že server selhal, zkontrolujte čekající žádosti o schválení.

Správně nakonfigurujte URL, metodu a odesílaná data.

Otevřete tok studio.workspace.google.com a zaškrtněte krok Odeslat webhook. Adresa by měla být kompletní a statickéPole přijímá URL adresu začínající na http:// o https://ale neumožňuje vkládání proměnných do samotné URL adresy. HTTPS je doporučená možnost aby se zabránilo odesílání nešifrovaných informací; není to požadavek pole.

• Metoda HTTP: Vyberte ten, který cílové API očekává. Studio nabízí GET, POST, PUT, PATCH a DELETE; POST je výchozí.
• Tělo žádosti: Je volitelný a odesílá se jako text. Pro mnoho API je vhodné použít JSON s respektováním uvozovek, složených závorek a názvů polí vyžadovaných službou.
• Proměnné: Do těla můžete zahrnout data z předchozích kroků. Zkontrolujte výsledek, pokud proměnná obsahuje uvozovky, zalomení řádků nebo jiné znaky, které by mohly narušit formát JSON.
• GET požadavky: Studio s touto metodou ignoruje tělo požadavku. Pokud služba vyžaduje data v těle, zkontrolujte, kterou metodu její dokumentace podporuje.

Udělejte provedení testu A nezapomeňte, že odešle skutečný požadavek na cíl. Pokud krok funguje, jeho odpověď bude k dispozici jako textová proměnná pro pozdější použití ve stejném toku.

K nalezení problému použijte kartu Aktivita

Po každém spuštění otevřete Aktivita v aplikaci Workspace Studio. Pokud byl požadavek úspěšný, můžete si prohlédnout odeslaná data a přijatou odpověď. Pokud se nezdařil, Studio zobrazí kód chyby a odpověď na cílovou URL adresuTato informace nám umožňuje rozlišit mezi konfiguračním problémem v toku a odmítnutím způsobeným externí službou.

Un 400 To obvykle znamená, že příjemce nepřijme žádost tak, jak je napsána; zkontroluje metodu a text. V případě 401 nebo 403Zkontrolujte požadavky na přístup ke službě a omezení vaší organizace. 404 Vyzve vás k ověření trasy koncového bodu. Pokud a 429Zkontrolujte limity požadavků; chyby 5xx Obvykle indikují problém s přijímající službou. Konkrétní odpověď z koncového bodu je užitečnější než interpretace čísla samostatně.

Administrátoři se také mohou podívat na Protokoly událostí Workspace Studia prošetřit požadavky webhooků. Přístup k určitým datům, jako je požadovaná adresa URL, je omezen, protože mohou obsahovat citlivé informace.

Nezaměňujte webhook Studia s webhookem příchozích zpráv z Google Chatu.

Krok Odeslat webhook Workspace Studio odešle požadavek na externí URL. příchozí webhook z Google ChatuNaproti tomu se jedná o URL adresu vytvořenou v prostoru, kde jiný systém může zveřejňovat zprávy. Jsou to samostatné prvky, i když URL adresu chatu můžete použít jako cíl pro tok ve Studiu.

Pokud je vaším cílem zveřejnit reklamu na Google Chatu, nejprve zkontrolujte, zda je krok 1 dostatečný. Publikovat v prostoru ze Studia. Pokud potřebujete použít příchozí webhook, musíte ho vytvořit z Aplikace a integrace prostoru a uchovávat jeho URL adresu, která obsahuje klíč a token, jako soukromou. Tyto webhooky se používají k odesílání zpráv do prostoru, ale neumožňují konverzaci s uživateli.

Google Chat uplatňuje na své příchozí webhooky sdílenou kvótu. jeden požadavek za sekundu a na prostorTento limit platí pro Chat; nejedná se o obecný limit pro krok Odeslání webhooku v aplikaci Workspace Studio. Pokud k chybě dojde při odesílání mnoha oznámení za sebou do stejného prostoru, zkontrolujte tuto kvótu spolu s odpovědí na požadavek.

Pokud se chyby vyskytují občas, zkontrolujte kvóty toku.

Workspace Studio vám umožňuje vytvořit až 25 toků na uživatele, s max 20 kroků na tokDále uplatňuje kombinovaný limit na počet spuštění během každého 24hodinového období. Pokud tohoto limitu dosáhnete, další spuštění se nezdaří, dokud se počítadlo nevynuluje.

Pokud webhook selže až po mnoha aktivacích, zkontrolujte Aktivita Zkontrolujte limity aplikace Studio i cílové služby. Upřesnění spouštěče – například jeho omezení na konkrétní odesílatele nebo události – může zabránit zbytečným požadavkům. Pokud k chybě dojde při prvním spuštění, začněte kontrolou oprávnění, čekajících schválení a odpovědi koncového bodu.