Ratkaisu Webhook-virheisiin Workspace Studiossa

Olet luonut työnkulun Google Workspace Studiossa ja lisännyt vaiheen Lähetä webhook Ja pyyntö ei koskaan saavuta määränpäätään. Tai ehkä työnkulku toimi ja nyt tapahtuu virhe. Ennen kuin muutat URL-osoitetta sokkona, kannattaa tutkia asia. Missä vaiheessa toteutus loppuu?: pääsy vaiheeseen, odottava hyväksyntä, pyynnön kokoonpano tai ulkoisen palvelun vastaus.

Workspace Studio käyttää tätä vaihetta lähettääkseen HTTP-pyyntö tiettyyn osoitteeseenTätä voidaan käyttää sisäisen työkalun ilmoittamiseen, tietueen luomiseen toisessa sovelluksessa tai datan lähettämiseen palveluun, jolla ei ole suoraa liitintä. Ratkaisu riippuu siitä, esiintyykö esto Google Workspacen sisällä vai pyynnön vastaanottavalla palvelimella.

Tarkista, onko järjestelmänvalvoja ottanut webhookit käyttöön

Si Lähetä webhook Se ei näy käytettävissä olevien vaiheiden joukossa; aloita organisaation käyttöoikeuksista. Googlen mukaan tämä ominaisuus on... oletuksena poistettu käytöstä ja että järjestelmänvalvojan on otettava se käyttöön kyseisessä organisaatioyksikössä. Polku on Hallintakonsoli > Sovellukset > Google Workspace > Workspace Studio > Webhook-asetukset.

Tarkista myös, että tililläsi on käyttöoikeus ominaisuuteen: Google jatkaa webhook-välityksen tunnistamista ominaisuudeksi, joka on käytössä rajoitettu esikatseluJos et ole järjestelmänvalvoja, anna työtilan järjestelmänvalvojalle puuttuvan vaiheen nimi, tilisi ja organisaatioyksikkö, johon kuulut. Näin järjestelmänvalvoja voi tarkistaa sovellettavat asetukset vaikuttamatta muiden tiimien käyttöoikeuksiin.

Tarkista sallittujen URL-osoitteiden ja hyväksyntöjen luettelo

Joissakin versioissa järjestelmänvalvoja voi rajoittaa ulkoisia kohteita käyttämällä sallittujen verkkotunnusten ja URL-osoitteiden luetteloJos vaihe on olemassa, mutta et voi muodostaa yhteyttä tiettyyn päätepisteeseen, varmista, että verkkotunnuksesi tai URL-osoitteesi on kyseisessä luettelossa. Tätä asetusta hallitaan Driven ja Docsin URL-osoitteiden tuonti- ja hakuasetuksista.

Tämä rajoitus Se ei toimi samalla tavalla kaikissa versioissaWebhookien sallittujen luettelo on saatavilla esimerkiksi Business Plus-, Enterprise Standard- ja Plus-versioissa sekä Education Standard- ja Plus-versioissa. Versioissa, joissa tätä valintaa ei ole, webhookien käyttöönotto sallii yhteydet kelvollisiin URL-osoitteisiin ilman sallittujen luettelon käyttöä. Siksi on suositeltavaa ensin tarkistaa versiosi ja organisaatiosi käytäntö.

Virtaus voi myös odottaa käyttäjän hyväksyntäGoogle käsittelee datan lähettämistä ulkoiseen päätepisteeseen arkaluontoisena toimintona ja vaatii oletusarvoisesti tarkistuksen ja vahvistuksen. Jos automaatio näyttää juuttuneen, avaa Studio ja tarkista odottavat hyväksyntäpyynnöt ennen kuin päätät palvelimen epäonnistuneen.

Määritä URL-osoite, menetelmä ja lähetetyt tiedot oikein.

Avaa virtaus sisään studio.workspace.google.com ja tarkista Lähetä webhook -vaihe. Osoitteen pitäisi olla täydellinen ja staattinenKenttä hyväksyy URL-osoitteen, joka alkaa merkeillä http:// o https://mutta se ei salli muuttujien lisäämistä itse URL-osoitteeseen. HTTPS on suositeltu vaihtoehto välttääkseen salaamattoman tiedon lähettämistä; se ei ole kentän vaatimus.

• HTTP-menetelmä: Valitse kohde-API:n odottama. Studio tarjoaa GET-, POST-, PUT-, PATCH- ja DELETE-käskyjä; POST on oletusarvo.
• Pyynnön runko: Se on valinnainen ja lähetetään tekstinä. Monissa API-rajapinnoissa on suositeltavaa käyttää JSON-muotoa, ottaen huomioon palvelun vaatimat lainausmerkit, aaltosulkeet ja kenttien nimet.
• Muuttujat: Voit sisällyttää leipätekstiin tietoja edellisistä vaiheista. Tarkista tulos, kun muuttuja sisältää lainausmerkkejä, rivinvaihtoja tai muita merkkejä, jotka saattavat rikkoa JSON-muodon.
• GET-pyynnöt: Studio jättää pyynnön rungon huomiotta tällä metodilla. Jos palvelu vaatii tietoja rungossa, tarkista, mitä metodia sen dokumentaatio tukee.

Tee testin suorittaminen Ja muista, että se lähettää varsinaisen pyynnön kohteeseen. Jos vaihe toimii, sen vastaus tulee saataville tekstimuuttujana myöhempää käyttöä varten samassa työnkulussa.

Käytä Toiminta-välilehteä ongelman paikantamiseen

Avaa jokaisen suorituksen jälkeen Toiminta Workspace Studiossa. Jos pyyntö onnistui, voit tarkastella lähetettyjä tietoja ja saatua vastausta. Jos se epäonnistui, Studio näyttää virhekoodi ja kohde-URL-vastausNäiden tietojen avulla voimme erottaa työnkulun määritysongelman ulkoisen palvelun aiheuttamasta hylkäyksestä.

Un 400 Tämä yleensä tarkoittaa, että vastaanottaja ei hyväksy pyyntöä sellaisenaan; hän tarkistaa menetelmän ja rungon. Jos 401 tai 403Tarkista palvelun käyttöoikeusvaatimukset ja organisaatiosi rajoitukset. 404 Se kehottaa sinua vahvistamaan päätepisteen reitin. Jos 429Tarkista pyyntörajoituksesi; virheet 5xx Ne yleensä viittaavat ongelmaan vastaanottavassa palvelussa. Päätepisteen tarkka vastaus on hyödyllisempi kuin numeron tulkitseminen erikseen.

Ylläpitäjät voivat myös tutustua Workspace Studion tapahtumalokit tutkia webhook-pyyntöjä. Pääsy tiettyihin tietoihin, kuten pyydettyyn URL-osoitteeseen, on rajoitettu, koska ne saattavat sisältää arkaluonteisia tietoja.

Älä sekoita Studio-webhookia saapuvien Google Chat -webhookiin.

Askel Lähetä webhook Workspace Studio tekee pyynnön ulkoiseen URL-osoitteeseen. saapuva Google Chat -webhookSe on URL-osoite, joka on luotu tilaan, johon toinen järjestelmä voi lähettää viestejä. Ne ovat erillisiä elementtejä, vaikka voit käyttää Chat-URL-osoitetta Studio-työnkulun kohteena.

Jos tavoitteenasi on julkaista mainos Google Chatissa, tarkista ensin, riittääkö vaihe 1. Julkaise tilassa Studiosta. Jos sinun on käytettävä saapuvaa webhookia, sinun on luotava se Sovellukset ja integraatiot tilaan ja pidä sen URL-osoite yksityisenä, joka sisältää avaimen ja tunnuksen. Näitä webhookkeja käytetään viestien lähettämiseen tilaan, mutta ne eivät salli keskustelua käyttäjien kanssa.

Google Chat käyttää jaettua kiintiötä saapuville webhookeilleen. yksi pyyntö sekunnissa ja tilaa kohdenTämä rajoitus koskee Chattia; se ei ole yleinen rajoitus Workspace Studion Lähetä webhook -vaiheelle. Jos virhe ilmenee, kun lähetät useita ilmoituksia peräkkäin samaan tilaan, tarkista tämä kiintiö yhdessä pyyntövastauksen kanssa.

Tarkista virtauskiintiöt, jos virheet ovat ajoittaisia.

Workspace Studion avulla voit luoda jopa 25 työnkulkua käyttäjää kohden, enintään 20 askelta per virtausLisäksi se asettaa yhdistetyn rajoituksen suoritusten määrälle 24 tunnin aikana. Jos saavutat tämän rajan, lisäsuoritukset epäonnistuvat, kunnes laskuri nollataan.

Kun webhook epäonnistuu vasta useiden aktivointien jälkeen, tarkista Toiminta Tarkista sekä Studion että kohdepalvelun rajoitukset. Liipaisimen tarkentaminen – esimerkiksi rajoittamalla se tiettyihin lähettäjiin tai tapahtumiin – voi estää tarpeettomia pyyntöjä. Jos virhe ilmenee ensimmäisellä ajokerralla, aloita tarkistamalla käyttöoikeudet, odottavat hyväksynnät ja päätepisteen vastaus.