Løsning på Webhook-feil i Workspace Studio

Du har opprettet en flyt i Google Workspace Studio, og du har lagt til trinnet Send en webhook Og forespørselen når aldri frem til målet. Eller kanskje flyten fungerte, og nå oppstår det en feil. Før du endrer URL-en blindt, er det verdt å undersøke. Når stopper henrettelsen?tilgang til trinnet, en ventende godkjenning, konfigurasjonen av forespørselen eller svaret fra den eksterne tjenesten.

Workspace Studio bruker dette trinnet til å sende en HTTP-forespørsel til en spesifikk adresseDette kan brukes til å varsle et internt verktøy, opprette en oppføring i et annet program eller sende data til en tjeneste som ikke har en direkte kobling. Løsningen avhenger av om blokkeringen oppstår i Google Workspace eller på serveren som mottar forespørselen.

Sjekk om administratoren har aktivert webhooks

Si Send en webhook Den vises ikke blant de tilgjengelige trinnene; start med organisasjonens tillatelser. Google indikerer at denne funksjonen er... deaktivert som standard og at en administrator må aktivere det for den relevante organisasjonsenheten. Banen er Administrasjonskonsoll > Apper > Google Workspace > Workspace Studio > Webhook-innstillinger.

Sjekk også at kontoen din har tilgang til funksjonen: Google fortsetter å identifisere webhook-passering som en funksjon i begrenset forhåndsvisningHvis du ikke er administrator, må du oppgi navnet på det manglende trinnet, kontoen din og organisasjonsenheten du tilhører til arbeidsområdeadministratoren. Dette vil gjøre det mulig for dem å bekrefte de gjeldende innstillingene uten å påvirke tillatelsene til andre team.

Se gjennom listen over tillatte nettadresser og godkjenninger

I noen utgaver kan administratoren begrense eksterne destinasjoner ved hjelp av en liste over tillatte domener og URL-erHvis trinnet finnes, men du ikke kan koble til et bestemt endepunkt, må du bekrefte at domenet eller URL-adressen din er på listen. Denne innstillingen administreres fra import- og hentingsalternativene for URL-adresser i Drive og Dokumenter.

Denne begrensningen Det fungerer ikke likt i alle utgaverWebhook-tillatelseslisten er tilgjengelig i utgaver som Business Plus, Enterprise Standard og Plus, og Education Standard og Plus. I utgaver som ikke tilbyr denne kontrollen, tillater aktivering av webhooks tilkoblinger til gyldige URL-er uten å bruke denne tillatelseslisten. Derfor anbefales det å først sjekke utgaven din og organisasjonens retningslinjer.

Strømmen kan også vente på en brukergodkjenningGoogle behandler sending av data til et eksternt endepunkt som en sensitiv handling og krever gjennomgang og bekreftelse som standard. Hvis automatiseringen ser ut til å ha hengt seg fast, åpner du Studio og ser etter ventende godkjenningsforespørsler før du konkluderer med at serveren har sviktet.

Konfigurer URL-en, metoden og de sendte dataene riktig.

Åpne flyten inn studio.workspace.google.com og sjekk trinnet Send en webhook. Adressen skal være komplett og statiskFeltet godtar en URL som begynner med http:// o https://men den tillater ikke å sette inn variabler i selve URL-en. HTTPS er det anbefalte alternativet for å unngå å sende ukryptert informasjon; det er ikke et krav for feltet.

• HTTP-metode: Velg den som forventes av mål-API-et. Studio tilbyr GET, POST, PUT, PATCH og DELETE; POST er standard.
• Forespørselens hoveddel: Det er valgfritt og sendes som tekst. For mange API-er anbefales det å bruke JSON, med respekt for anførselstegn, krøllparenteser og feltnavn som kreves av tjenesten.
• Variabler: Du kan inkludere data fra tidligere trinn i brødteksten. Sjekk resultatet når en variabel inneholder anførselstegn, linjeskift eller andre tegn som kan bryte JSON-formatet.
• GET-forespørsler: Studio ignorerer forespørselsteksten med denne metoden. Hvis tjenesten krever data i teksten, sjekk hvilken metode dokumentasjonen støtter.

Lag en testutførelse Og husk at den vil sende en faktisk forespørsel til destinasjonen. Hvis trinnet fungerer, blir svaret tilgjengelig som en tekstvariabel for senere bruk i samme flyt.

Bruk Aktivitet-fanen til å finne problemet

Etter hver utførelse, åpne Aktivitet i Workspace Studio. Hvis forespørselen var vellykket, kan du se gjennom dataene som ble sendt og svaret som ble mottatt. Hvis det mislyktes, viser Studio feilkode og svar på destinasjons-URLDenne informasjonen lar oss skille mellom et konfigurasjonsproblem i flyten og en avvisning forårsaket av den eksterne tjenesten.

Un 400 Dette indikerer vanligvis at mottakeren ikke godtar forespørselen slik den er skrevet; de gjennomgår metoden og brødteksten. I tilfelle en 401 eller 403Sjekk tjenestens tilgangskrav og organisasjonens restriksjoner. 404 Den ber deg om å bekrefte endepunktruten. Hvis en 429Sjekk forespørselsgrensene dine; feil 5xx De indikerer vanligvis et problem med den mottakende tjenesten. Den spesifikke responsen fra endepunktet er mer nyttig enn å tolke tallet isolert.

Administratorer kan også konsultere Hendelseslogger for Workspace Studio for å undersøke webhook-forespørsler. Tilgang til visse data, for eksempel den forespurte URL-en, er begrenset fordi den kan inneholde sensitiv informasjon.

Ikke forveksle Studio-webhooken med en innkommende Google Chat-webhook.

Trinnet Send en webhook Workspace Studio sender en forespørsel til en ekstern URL. innkommende Google Chat-webhookDet er derimot en URL som er opprettet i et område for at et annet system skal kunne legge ut meldinger der. De er separate elementer, selv om du kan bruke Chat-URL-en som destinasjon for en Studio-flyt.

Hvis målet ditt er å legge ut en annonse på Google Chat, bør du først sjekke om trinn 1 er tilstrekkelig. Publiser i et rom fra Studio. Hvis du trenger å bruke en innkommende webhook, må du opprette den fra Apper og integrasjoner av rommet og holde URL-en privat, som inkluderer en nøkkel og et token. Disse webhookene brukes til å sende meldinger til rommet, men tillater ikke samtaler med brukere.

Google Chat bruker en delt kvote på innkommende webhooks. én forespørsel per sekund og per mellomromDenne grensen gjelder for Chat; det er ikke en generell grense for trinnet Send en Webhook i Workspace Studio. Hvis feilen oppstår når du legger ut mange kunngjøringer på rad til samme område, må du sjekke denne kvoten sammen med forespørselssvaret.

Sjekk flytkvotene hvis feilene er periodiske.

Med Workspace Studio kan du lage opptil 25 flyter per bruker, med maksimalt 20 trinn per flytI tillegg gjelder en kombinert grense for antall utførelser i løpet av hver 24-timersperiode. Hvis du når denne grensen, vil ytterligere utførelser mislykkes inntil telleren nullstilles.

Når webhooken bare feiler etter mange aktiveringer, sjekk Aktivitet Sjekk både Studios grenser og måltjenestens grenser. Å avgrense utløseren – for eksempel å begrense den til bestemte avsendere eller hendelser – kan forhindre unødvendige forespørsler. Hvis feilen oppstår ved første kjøring, start med å sjekke tillatelser, ventende godkjenninger og endepunktets svar.