Løsning på Webhook-fejl i Workspace Studio

Du har oprettet et flow i Google Workspace Studio, og du har tilføjet trinnet Send en webhook Og anmodningen når aldrig sin destination. Eller måske fungerede flowet, og nu opstår der en fejl. Før man blindt ændrer URL'en, er det værd at undersøge det. Hvornår stopper udførelsen?adgang til trinnet, en afventende godkendelse, konfigurationen af ​​anmodningen eller svaret fra den eksterne tjeneste.

Workspace Studio bruger dette trin til at sende en HTTP-anmodning til en specifik adresseDette kan bruges til at underrette et internt værktøj, oprette en post i en anden applikation eller sende data til en tjeneste, der ikke har en direkte forbindelse. Løsningen afhænger af, om blokeringen opstår i Google Workspace eller på den server, der modtager anmodningen.

Tjek om administratoren har aktiveret webhooks

Si Send en webhook Den vises ikke blandt de tilgængelige trin; start med organisationens tilladelser. Google angiver, at denne funktion er... deaktiveret som standard og at en administrator skal aktivere det for den relevante organisationsenhed. Stien er Administrationskonsol > Apps > Google Workspace > Workspace Studio > Webhook-indstillinger.

Kontrollér også, at din konto har adgang til funktionen: Google fortsætter med at identificere webhook-passering som en funktion i begrænset forhåndsvisningHvis du ikke er administrator, skal du give Workspace-administratoren navnet på det manglende trin, din konto og den organisationsenhed, du tilhører. Dette giver dem mulighed for at bekræfte de gældende indstillinger uden at påvirke tilladelser på andre teams.

Gennemgå listen over tilladte webadresser og godkendelser

I nogle udgaver kan administratoren begrænse eksterne destinationer ved hjælp af en liste over tilladte domæner og URL'erHvis trinnet findes, men du ikke kan oprette forbindelse til et bestemt slutpunkt, skal du bekræfte, at dit domæne eller din URL er på listen. Denne indstilling administreres fra import- og hentningsmulighederne for URL'er i Drev og Dokumenter.

Denne begrænsning Det fungerer ikke ens i alle udgaverWebhook-tilladelseslisten er tilgængelig i udgaver som Business Plus, Enterprise Standard og Plus samt Education Standard og Plus. I udgaver, der ikke tilbyder denne kontrol, tillader aktivering af webhooks forbindelser til gyldige URL'er uden at anvende denne tilladelsesliste. Derfor anbefales det først at tjekke din udgave og din organisations politik.

Strømmen kan også vente på en brugergodkendelseGoogle behandler afsendelse af data til et eksternt slutpunkt som en følsom handling og kræver som standard gennemgang og bekræftelse. Hvis automatiseringen ser ud til at sidde fast, skal du åbne Studio og kontrollere for ventende godkendelsesanmodninger, før du konkluderer, at serveren har fejlet.

Konfigurer URL'en, metoden og de sendte data korrekt.

Åbn flowet ind studio.workspace.google.com og tjek trinnet Send en webhook. Adressen skal være komplet og statiskFeltet accepterer en URL, der starter med http:// o https://men det tillader ikke indsættelse af variabler i selve URL'en. HTTPS er den anbefalede mulighed for at undgå at sende ukrypterede oplysninger; det er ikke et krav for feltet.

• HTTP-metode: Vælg den, der forventes af mål-API'en. Studio tilbyder GET, POST, PUT, PATCH og DELETE; POST er standardindstillingen.
• Anmodningens indhold: Det er valgfrit og sendes som tekst. For mange API'er anbefales det at bruge JSON, idet man respekterer de anførselstegn, krøllede parenteser og feltnavne, der kræves af tjenesten.
• Variabler: Du kan inkludere data fra tidligere trin i brødteksten. Tjek resultatet, når en variabel indeholder anførselstegn, linjeskift eller andre tegn, der kan forstyrre JSON-formatet.
• GET-anmodninger: Studio ignorerer anmodningsteksten med denne metode. Hvis tjenesten kræver data i teksten, skal du kontrollere, hvilken metode dens dokumentation understøtter.

Lav en testudførelse Og husk at den vil sende en faktisk anmodning til destinationen. Hvis trinnet fungerer, bliver svaret tilgængeligt som en tekstvariabel til senere brug i det samme flow.

Brug fanen Aktivitet til at finde problemet

Efter hver udførelse, åbn Aktivitet i Workspace Studio. Hvis anmodningen lykkedes, kan du gennemgå de sendte data og det modtagne svar. Hvis det mislykkedes, viser Studio fejlkode og svar på destinations-URLDisse oplysninger giver os mulighed for at skelne mellem et konfigurationsproblem i flowet og en afvisning forårsaget af den eksterne tjeneste.

Un 400 Dette indikerer normalt, at modtageren ikke accepterer anmodningen, som den er skrevet; de gennemgår metoden og brødteksten. I tilfælde af en 401 eller 403Tjek tjenestens adgangskrav og din organisations begrænsninger. 404 Den beder dig om at bekræfte slutpunktsruten. Hvis en 429Tjek dine anmodningsgrænser; fejl 5xx De indikerer normalt et problem med den modtagende tjeneste. Det specifikke svar fra slutpunktet er mere nyttigt end at fortolke nummeret isoleret.

Administratorer kan også konsultere Workspace Studio-hændelseslogfiler at undersøge webhook-anmodninger. Adgang til visse data, såsom den anmodede URL, er begrænset, fordi den kan indeholde følsomme oplysninger.

Forveksl ikke Studio-webhooken med en indgående Google Chat-webhook.

Trinet Send en webhook Workspace Studio sender en anmodning til en ekstern URL. indgående Google Chat webhookDet er derimod en URL, der er oprettet i et område, så et andet system kan sende beskeder der. De er separate elementer, selvom du kan bruge chat-URL'en som destination for et Studio-flow.

Hvis dit mål er at slå en annonce op på Google Chat, skal du først kontrollere, om trin 1 er tilstrækkeligt. Udgiv i et rum fra Studio. Hvis du har brug for at bruge en indgående webhook, skal du oprette den fra Apps og integrationer af rummet og holde dets URL privat, som inkluderer en nøgle og et token. Disse webhooks bruges til at sende beskeder til rummet, men tillader ikke samtale med brugerne.

Google Chat anvender en delt kvote på sine indgående webhooks. én anmodning pr. sekund og pr. mellemrumDenne grænse gælder for Chat; det er ikke en generel grænse for trinnet Send en webhook i Workspace Studio. Hvis fejlen opstår, når du sender mange meddelelser i træk til det samme rum, skal du kontrollere denne kvote sammen med anmodningssvaret.

Kontrollér flowkvoterne, hvis fejlene er periodiske.

Med Workspace Studio kan du oprette op til 25 flows pr. bruger, med et maksimum på 20 trin pr. flowDerudover anvender den en kombineret grænse for antallet af udførelser i løbet af hver 24-timers periode. Hvis du når denne grænse, vil yderligere udførelser mislykkes, indtil tælleren nulstilles.

Når webhooken kun fejler efter mange aktiveringer, skal du kontrollere Aktivitet Kontrollér både Studios og måltjenestens begrænsninger. Forfining af udløseren – for eksempel at begrænse den til bestemte afsendere eller begivenheder – kan forhindre unødvendige anmodninger. Hvis fejlen opstår ved første kørsel, skal du starte med at kontrollere tilladelser, ventende godkendelser og slutpunktets svar.