Rješenje za kvarove webhooka u Workspace Studiju

Izradili ste tijek u Google Workspace Studiju, dodali ste korak Pošalji webhook I zahtjev nikad ne stiže do odredišta. Ili je možda tijek radio, a sada se javlja greška. Prije nego što se URL slijepo promijeni, vrijedi istražiti. U kojem trenutku prestaje izvršenje?: pristup koraku, odobrenje na čekanju, konfiguracija zahtjeva ili odgovor vanjske usluge.

Workspace Studio koristi ovaj korak za slanje HTTP zahtjev upućen određenoj adresiOvo se može koristiti za obavještavanje internog alata, stvaranje zapisa u drugoj aplikaciji ili slanje podataka usluzi koja nema izravni konektor. Rješenje ovisi o tome događa li se blokada unutar Google Workspacea ili na poslužitelju koji prima zahtjev.

Provjerite je li administrator omogućio webhookove

Si Pošalji webhook Ne pojavljuje se među dostupnim koracima; počnite s dozvolama organizacije. Google navodi da je ova značajka... onemogućeno prema zadanim postavkama i da administrator to mora omogućiti za odgovarajuću organizacijsku jedinicu. Put je Administratorska konzola > Aplikacije > Google Workspace > Workspace Studio > Postavke webhooka.

Također provjerite ima li vaš račun pristup toj značajki: Google i dalje identificira prosljeđivanje webhook-a kao značajku u ograničeni pregledAko niste administrator, administratoru radnog prostora navedite naziv koraka koji nedostaje, svoj račun i organizacijsku jedinicu kojoj pripadate. To će im omogućiti da provjere primjenjive postavke bez utjecaja na dopuštenja drugih timova.

Pregledajte popis dopuštenih URL-ova i odobrenja

U nekim izdanjima administrator može ograničiti vanjska odredišta pomoću popis dopuštenih domena i URL-ovaAko korak postoji, ali se ne možete povezati s određenom krajnjom točkom, potvrdite da je vaša domena ili URL na tom popisu. Ova se postavka upravlja iz opcija uvoza i dohvaćanja URL-ova Diska i Dokumenata.

Ovo ograničenje Ne radi isto u svim izdanjimaPopis dopuštenih webhookova dostupan je u izdanjima kao što su Business Plus, Enterprise Standard i Plus te Education Standard i Plus. U izdanjima koja ne nude ovu kontrolu, omogućavanje webhookova omogućuje povezivanje s valjanim URL-ovima bez primjene ovog popisa dopuštenih. Stoga je preporučljivo prvo provjeriti svoje izdanje i pravila svoje organizacije.

Tok također može čekati odobrenje korisnikaGoogle tretira slanje podataka na vanjsku krajnju točku kao osjetljivu radnju i prema zadanim postavkama zahtijeva pregled i potvrdu. Ako se čini da je automatizacija zapela, otvorite Studio i provjerite ima li zahtjeva za odobrenje na čekanju prije nego što zaključite da je poslužitelj zakazao.

Ispravno konfigurirajte URL, metodu i poslane podatke.

Otvorite protok unutra studio.workspace.google.com i označite korak Pošalji webhook. Adresa bi trebala biti potpun i statičanPolje prihvaća URL koji počinje s http:// o https://ali ne dopušta umetanje varijabli u sam URL. HTTPS je preporučena opcija kako bi se izbjeglo slanje nešifriranih informacija; to nije uvjet polja.

• HTTP metoda: Odaberite onaj koji očekuje ciljni API. Studio nudi GET, POST, PUT, PATCH i DELETE; POST je zadana vrijednost.
• Tijelo zahtjeva: Nije obavezno i ​​šalje se kao tekst. Za mnoge API-je preporučljivo je koristiti JSON, poštujući navodnike, vitičaste zagrade i nazive polja koje zahtijeva usluga.
• Varijable: U tijelo možete uključiti podatke iz prethodnih koraka. Provjerite rezultat kada varijabla sadrži navodnike, prijelome redaka ili druge znakove koji bi mogli narušiti JSON format.
• GET zahtjevi: Studio ovom metodom ignorira tijelo zahtjeva. Ako usluga zahtijeva podatke u tijelu, provjerite koju metodu podržava njezina dokumentacija.

Napravite izvršenje testa I zapamtite da će poslati stvarni zahtjev odredištu. Ako korak uspije, njegov odgovor postaje dostupan kao tekstualna varijabla za kasniju upotrebu u istom toku.

Pomoću kartice Aktivnost pronađite problem

Nakon svakog izvršenja, otvorite Aktivnost u Workspace Studiju. Ako je zahtjev bio uspješan, možete pregledati poslane podatke i primljeni odgovor. Ako nije uspio, Studio prikazuje kod pogreške i odgovor odredišnog URL-aOve informacije nam omogućuju razlikovanje konfiguracijskog problema u toku i odbijanja uzrokovanog vanjskom uslugom.

Un 400 To obično ukazuje na to da primatelj ne prihvaća zahtjev onako kako je napisan; oni pregledavaju metodu i sadržaj. U slučaju 401 ili 403Provjerite uvjete pristupa usluzi i ograničenja vaše organizacije. 404 Traži se od vas da provjerite rutu krajnje točke. Ako 429Provjerite ograničenja zahtjeva; pogreške 5xx Obično ukazuju na problem s prijemnom uslugom. Specifičan odgovor krajnje točke korisniji je od izoliranog tumačenja broja.

Administratori se također mogu konzultirati s Zapisnici događaja Workspace Studija istražiti zahtjeve webhook-a. Pristup određenim podacima, kao što je traženi URL, ograničen je jer mogu sadržavati osjetljive informacije.

Nemojte brkati Studio webhook s dolaznim Google Chat webhookom.

Korak Pošalji webhook Workspace Studio šalje zahtjev vanjskom URL-u. dolazni webhook za Google ChatNasuprot tome, to je URL kreiran unutar prostora za drugi sustav za objavljivanje poruka tamo. To su odvojeni elementi, iako URL chata možete koristiti kao odredište za Studio tijek.

Ako vam je cilj objaviti oglas na Google Chatu, prvo provjerite je li 1. korak dovoljan. Objavi u prostoru iz Studija. Ako trebate koristiti dolazni webhook, morate ga stvoriti iz Aplikacije i integracije prostora i čuvaju njegov URL privatnim, što uključuje ključ i token. Ovi webhookovi koriste se za slanje poruka u prostor, ali ne dopuštaju razgovor s korisnicima.

Google Chat primjenjuje dijeljenu kvotu na svoje dolazne webhookove. jedan zahtjev po sekundi i po prostoruOvo ograničenje odnosi se na Chat; nije opće ograničenje za korak Slanje web-hooka u Workspace Studiju. Ako se pogreška pojavi prilikom objavljivanja više objava zaredom u istom prostoru, provjerite ovu kvotu zajedno s odgovorom na zahtjev.

Provjerite kvote protoka ako su pogreške povremene.

Workspace Studio vam omogućuje stvaranje do 25 tokova po korisniku, s najviše 20 koraka po tokuOsim toga, primjenjuje kombinirano ograničenje na broj izvršenja tijekom svakog 24-satnog razdoblja. Ako dosegnete ovo ograničenje, daljnja izvršenja neće uspjeti dok se brojač ne resetira.

Kada webhook ne uspije tek nakon mnogo aktivacija, provjerite Aktivnost Provjerite ograničenja i Studija i ciljane usluge. Pročišćavanje okidača - na primjer, ograničavanje na određene pošiljatelje ili događaje - može spriječiti nepotrebne zahtjeve. Ako se pogreška pojavi pri prvom pokretanju, započnite provjerom dopuštenja, odobrenja na čekanju i odgovora krajnje točke.