Megoldás a webhook hibákra a Workspace Studio-ban

Létrehoztál egy folyamatot a Google Workspace Studioban, és hozzáadtad a lépést. Webhook küldése És a kérés soha nem éri el a célját. Vagy talán a folyamat működött, és most hiba történik. Mielőtt vakon megváltoztatná az URL-t, érdemes kivizsgálni. Mikor áll le a végrehajtás?: hozzáférés a lépéshez, egy függőben lévő jóváhagyás, a kérés konfigurációja vagy a külső szolgáltatás válasza.

A Workspace Studio ezt a lépést használja egy HTTP kérés egy adott címreEz felhasználható egy belső eszköz értesítésére, rekord létrehozására egy másik alkalmazásban, vagy adatok küldésére egy olyan szolgáltatásba, amely nem rendelkezik közvetlen csatlakozóval. A megoldás attól függ, hogy a blokkolás a Google Workspace-en belül vagy a kérést fogadó szerveren történik-e.

Ellenőrizd, hogy a rendszergazda engedélyezte-e a webhookokat

Si Webhook küldése Nem jelenik meg az elérhető lépések között; kezdje a szervezet engedélyeivel. A Google szerint ez a funkció... alapértelmezés szerint letiltva és hogy egy rendszergazdának engedélyeznie kell azt az adott szervezeti egységben. Az elérési út a következő: Felügyeleti konzol > Alkalmazások > Google Workspace > Workspace Studio > Webhook-beállítások.

Azt is ellenőrizd, hogy a fiókod hozzáfér-e a funkcióhoz: A Google továbbra is a webhookok átadását olyan funkcióként azonosítja, amely a következőket tartalmazza: korlátozott előnézetHa nem rendszergazda, adja meg a munkaterület rendszergazdájának a hiányzó lépés nevét, a fiókját és a szervezeti egységet, amelyhez tartozik. Ez lehetővé teszi számára, hogy ellenőrizze az alkalmazandó beállításokat anélkül, hogy ez befolyásolná a többi csapat engedélyeit.

Tekintse át az engedélyezett URL-ek és jóváhagyások listáját

Bizonyos kiadásokban a rendszergazda korlátozhatja a külső célhelyeket egy engedélyezett domainek és URL-ek listájaHa a lépés létezik, de nem tud csatlakozni egy adott végponthoz, ellenőrizze, hogy a domainje vagy URL-címe szerepel-e a listán. Ez a beállítás a Drive és a Dokumentumok URL-címének importálási és lekérési beállításainál kezelhető.

Ez a korlátozás Nem minden kiadásban működik ugyanúgyA webhook engedélyezőlista olyan kiadásokban érhető el, mint a Business Plus, az Enterprise Standard és Plus, valamint az Education Standard és Plus. Azokban a kiadásokban, amelyek nem kínálják ezt a vezérlőt, a webhookok engedélyezése lehetővé teszi az érvényes URL-címekhez való kapcsolódást az engedélyezőlista alkalmazása nélkül. Ezért ajánlott először ellenőrizni a kiadást és a szervezet szabályzatát.

Az áramlás várhat is egy felhasználói jóváhagyásA Google a külső végpontra küldött adatokat bizalmas műveletként kezeli, és alapértelmezés szerint felülvizsgálatot és megerősítést igényel. Ha az automatizálás elakadni látszik, nyissa meg a Studio programot, és ellenőrizze a függőben lévő jóváhagyási kérelmeket, mielőtt arra a következtetésre jutna, hogy a szerver meghibásodott.

Konfigurálja helyesen az URL-címet, a metódust és az elküldött adatokat.

Nyissa meg az áramlást studio.workspace.google.com és jelölje be a Webhook küldése lépést. A címnek a következőnek kell lennie: teljes és statikusA mező elfogad egy URL-t, amely a következővel kezdődik: http:// o https://de nem engedélyezi változók beszúrását magába az URL-be. A HTTPS az ajánlott opció a titkosítatlan információk küldésének elkerülése érdekében; ez nem követelmény a területen.

• HTTP metódus: Válaszd ki a cél API által vártat. A Studio a GET, POST, PUT, PATCH és DELETE parancsokat kínálja; a POST az alapértelmezett.
• A kérés törzse: Ez opcionális, és szövegként kerül elküldésre. Sok API esetében ajánlott JSON-t használni, tiszteletben tartva az idézőjeleket, kapcsos zárójeleket és a szolgáltatás által megkövetelt mezőneveket.
• Változók: A törzsbe belefoglalhatja az előző lépésekből származó adatokat. Ellenőrizze az eredményt, ha egy változó idézőjeleket, sortöréseket vagy más olyan karaktereket tartalmaz, amelyek sérthetik a JSON formátumot.
• GET kérések: A Studio figyelmen kívül hagyja a kérés törzsét ezzel a metódussal. Ha a szolgáltatásnak adatokra van szüksége a törzsben, ellenőrizze, hogy a dokumentációja melyik metódust támogatja.

Készíts egy teszt végrehajtása És ne feledd, hogy egy tényleges kérést fog küldeni a célállomásnak. Ha a lépés működik, a válasz szöveges változóként elérhetővé válik későbbi felhasználásra ugyanabban a folyamatban.

A probléma megkereséséhez használja a Tevékenység fület

Minden végrehajtás után nyissa ki Tevékenység a Workspace Studioban. Ha a kérés sikeres volt, áttekintheti az elküldött adatokat és a kapott választ. Sikertelen kérés esetén a Studio megjeleníti a következőt: hibakód és cél URL válaszEz az információ lehetővé teszi számunkra, hogy különbséget tegyünk a folyamatban lévő konfigurációs probléma és a külső szolgáltatás által okozott elutasítás között.

Un 400 Ez általában azt jelzi, hogy a címzett nem fogadja el a kérést a megírt formájában; áttekinti a metódust és a törzset. Abban az esetben, ha a 401 vagy 403Ellenőrizze a szolgáltatás hozzáférési követelményeit és a szervezetére vonatkozó korlátozásokat. 404 A rendszer kéri a végpont útvonalának ellenőrzését. Ha egy 429Ellenőrizd a kéréskorlátokat; hibák 5xx Általában a fogadó szolgáltatással kapcsolatos problémát jeleznek. A végponttól érkező konkrét válasz hasznosabb, mint a szám önmagában történő értelmezése.

A rendszergazdák a következőt is megtekinthetik: Workspace Studio eseménynaplók webhook-kérelmek kivizsgálásához. Bizonyos adatokhoz, például a kért URL-hez, korlátozott a hozzáférés, mivel bizalmas információkat tartalmazhatnak.

Ne keverd össze a Studio webhookot egy bejövő Google Chat webhookkal.

A lépés Webhook küldése A Workspace Studio egy külső URL-címre irányuló kérést küld. bejövő Google Chat webhookEzzel szemben ez egy URL, amelyet egy másik rendszer számára hoztak létre egy térben, hogy üzeneteket küldhessen oda. Ezek különálló elemek, annak ellenére, hogy a Chat URL-t használhatod célként egy Studio-folyamathoz.

Ha a célod egy hirdetés közzététele a Google Chatben, először ellenőrizd, hogy az 1. lépés elegendő-e. Közzététel egy térben a Studio-ból. Ha bejövő webhookot kell használnod, akkor azt a következőből kell létrehoznod: Alkalmazások és integrációk a térben, és tartsa titokban az URL-jét, amely egy kulcsot és egy tokent tartalmaz. Ezeket a webhookokat üzenetek küldésére használják a térbe, de nem teszik lehetővé a felhasználókkal való beszélgetést.

A Google Chat megosztott kvótát alkalmaz a bejövő webhookokra. egy kérés másodpercenként és mezőnkéntEz a korlát a Chatre vonatkozik; nem általános korlát a Workspace Studio Webhook küldése lépésére. Ha a hiba akkor jelentkezik, amikor egymás után több bejelentést teszel közzé ugyanabban a térben, ellenőrizd ezt a kvótát a kérésre adott válasszal együtt.

Ellenőrizze az áramlási kvótákat, ha a hibák időszakosan jelentkeznek.

A Workspace Studio segítségével akár 25 folyamat felhasználónként, legfeljebb 20 lépés áramlásonkéntEzenkívül kombinált korlátozást alkalmaz a végrehajtások számára 24 órás időszakonként. Ha eléri ezt a korlátot, a további végrehajtások sikertelenek lesznek, amíg a számláló vissza nem áll.

Ha a webhook csak számos aktiválás után hibázik, forduljon a következőhöz: Tevékenység Ellenőrizd mind a Studio, mind a célszolgáltatás korlátait. A trigger finomítása – például adott feladókra vagy eseményekre való korlátozása – megakadályozhatja a felesleges kéréseket. Ha a hiba az első futtatáskor jelentkezik, kezdd az engedélyek, a függőben lévő jóváhagyások és a végpont válaszának ellenőrzésével.