- Det native trin er at sende en webhook.
- URL'en er fast; variabler kan placeres i brødteksten.
- Svaret er stadig tilgængeligt for yderligere skridt.
- Funktionen kræver administrativ autorisation.
En Google Workspace Studio-workflow kan have brug for data uden for Gmail, Drive eller Chat: en ordrestatus, et nummer fra en database eller et svar fra et internt værktøj. For at hente disse data eller sende oplysninger til en anden tjeneste kan du tilføje trinnet Send en webhookDette foretager en HTTP-anmodning til adressen på en API, du har angivet.
Du behøver ikke at konfigurere Gemini-funktionskaldet for at foretage den anmodning. I Workspace Studio udfører flowet webhook-trinnet og modtager svaret. Derefter kan du, hvis du finder det nyttigt, sende svaret til et andet trin for at opsummere det, udtrække data eller kommunikere resultatet.
Hvad du skal bruge, før du opretter forbindelse til en API
Det første trin er at bekræfte, at din organisation kan bruge webhooks. Funktionen er placeret i begrænset forhåndsvisning og er som standard deaktiveret. En administrator skal logge ind. Apps > Google Workspace > Workspace Studio > Webhook-indstillinger og aktiver det for den tilsvarende organisationsenhed.
I nogle udgaver kan administratoren også begrænse forbindelser til én liste over tilladte domæner og URL'erHvis trinnet vises i Studio, men ikke kommunikerer med din API, skal du kontrollere, at destinationsadressen er godkendt. Handlinger, der involverer webhooks, kræver desuden som standard, at brugeren gennemgår og bekræfter trinnet før udførelse.
Fra den eksterne tjeneste skal du kende dens URL, de HTTP-metoder, den understøtter, og det dataformat, den forventer. Kontroller også, hvordan den autentificerer: en offentlig skrivebeskyttet API har andre krav end en privat API, der kræver tokens eller særlige headere.
Sådan kalder du en API fra Workspace Studio trin for trin
Indtast studio.workspace.google.com og opret en arbejdsgang med den trigger, du har brug for. Du kan f.eks. starte den, når der ankommer en e-mail, der opfylder bestemte betingelser. Følg derefter disse trin:
- Trykke Tilføj trin og vælg Send en webhook.
- Indtast Fuld URL af API'en, inklusive præfikset
https://Adressen skal rettes: dette felt understøtter ikke flowvariabler. - Vælg HTTP-metoden. FÅ Det bruges til at forespørge data; STOLPEat sende dem eller oprette en post. De er også tilgængelige Læg, reparer og slet.
- Hvis API'en kræver en brødtekst, skal du skrive den i indholdsfeltet eller nyttelastGoogle anbefaler at bruge JSON, når den modtagende tjeneste forventer det.
- Lav en testudførelseTjek resultatet, og aktiver flowet, når du har bekræftet, at det fungerer.
Husk på, at testen udfør handlingenHvis du konfigurerer en POST til at oprette en post eller en DELETE til at slette den, skal du først bruge et testmiljø eller data, som du kan ændre uden problemer.
Eksempel: afsendelse af en besked til et eksternt værktøj
Forestil dig, at dit team har en API, der opretter alarmer i https://api.ejemplo.com/v1/avisosDenne adresse er illustrativDu skal erstatte den med den fra din tjeneste. Hvis dokumentationen angiver, at den accepterer POST og en JSON-brødtekst, kan du konfigurere trinnet med indhold som f.eks. {"tipo":"nuevo_correo","origen":"Workspace Studio"}.
Du kan også indsætte en flowvariabel I brødteksten, for eksempel for at inkludere emnet på den e-mail, der udløste den. Gør dette fra Studios variabelvælger, og tjek resultatet: hvis den indsatte tekst indeholder anførselstegn eller andre specialtegn, kan det efterlade JSON-filen forkert udformet. Variabler kan bruges i indholdet, men ikke i URL-feltet.
Hvis du har brug for at hente data, skal du vælge GET og indtaste en fast URL, der allerede indeholder de nødvendige parametre. Workspace Studio ignorerer alt indhold, du har skrevet i brødteksten af en GET-anmodning.
Hvad skal man gøre med API-svaret
Webhook-trinnet efterlader servicesvar som tekst i en variabel, der er tilgængelig for efterfølgende trin. Du kan bruge den til at sende en notifikation, skrive et resumé eller bede et AI-trin om at udtrække specifikke data.
Hvis API'en for eksempel returnerer status for en ordre, kan det næste trin kommunikere denne status til teamet. Vælg eksplicit den variabel, der indeholder svaret: efterfølgende trin modtager ikke automatisk alt, hvad der skete tidligere i flowet. Det anbefales at teste det returnerede indhold, før du skriver instruktioner, der afhænger af det.
Hvis API'en kræver godkendelse eller mere kompleks logik
Den dokumenterede grundkonfiguration for Send en webhook Den indeholder URL'en, metoden og en valgfri brødtekst. Hvis din integration skal hente et OAuth-token, konstruere en URL med variable parametre, tilføje specifikke headere eller transformere et svar, før du fortsætter, skal du kontrollere, om dette trin dækker disse krav.
Når det ikke lykkes, er én mulighed at udvikle en Brugerdefineret trin til Workspace Studio via et plugin. I en Google Apps Script-implementering er tjenesten UrlFetchApp Det giver dig mulighed for at sende anmodninger til eksterne API'er og behandle JSON-svar. Denne løsning kræver udvikling og korrekt tilladelseskonfiguration; det er ikke nødvendigt for simple anmodninger, som det native trin allerede kan håndtere.
Undgå at indsætte private nøgler i synlige felter i flowet eller integrere dem i en delt URL. Før du sender data fra Gmail, Chat eller Kalender, skal du kontrollere, hvilke oplysninger den eksterne tjeneste modtager, og om den er autoriseret til at behandle dem.
Sådan finder du fejl i en webhook
Hvis forbindelsen mislykkes, skal du åbne fanen Aktivitet af flowet. Der kan du se den fulde fejl og svaret sendt af destinationsserveren. Disse oplysninger hjælper med at skelne mellem et Studio-konfigurationsproblem og en anmodning afvist af API'en.
- Trinet vises ikke: Tjek med din administrator, om webhooks er aktiveret for din organisationsenhed.
- URL'en er blokeret: Tjek listen over tilladte adresser, hvis din udgave bruger denne begrænsning.
- Fejl 400: Kontrollér brødtekstformatet og de felter, der kræves af API'en.
- Fejl 401 eller 403: Gennemgå de tilladelser og den godkendelsesmetoder, der kræves af tjenesten.
- Fejl 429: Tjek om du har overskredet anmodningsgrænsen for mål-API'en.
- Fejl 500: Kontroller status og optegnelser for den tjeneste, der modtager anmodningen.
Husk også de generelle begrænsninger i Workspace Studio: det understøtter i øjeblikket op til 25 flows pr. bruger y 20 trin pr. flowDerudover er der en kombineret udførelsesgrænse, der nulstilles hver 24. time. Hvis flere flows stopper med at køre, skal du gennemgå deres aktivitet, før du tilskriver fejlen til API'en.
For de fleste simple HTTP-forbindelser er processen ligetil: Aktiver webhook'en, konfigurer en fast URL og den korrekte metode, test anmodningen, og brug svaret i de efterfølgende trin. Hvis integrationen kræver avanceret godkendelse eller transformation af data via kode, giver det mening at forberede et brugerdefineret trin.
Jeg er en teknologientusiast, der har vendt sine "nørde" interesser til et erhverv. Jeg har brugt mere end 10 år af mit liv på at bruge avanceret teknologi og pille ved alle slags programmer af ren nysgerrighed. Nu har jeg specialiseret mig i computerteknologi og videospil. Dette skyldes, at jeg i mere end 5 år har skrevet til forskellige hjemmesider om teknologi og videospil, og lavet artikler, der søger at give dig den information, du har brug for, på et sprog, der er forståeligt for alle.
Har du spørgsmål, så spænder min viden fra alt relateret til Windows styresystemet samt Android til mobiltelefoner. Og mit engagement er over for dig, jeg er altid villig til at bruge et par minutter og hjælpe dig med at løse eventuelle spørgsmål, du måtte have i denne internetverden.