- Det inbyggda steget är att skicka en webhook.
- URL:en är fast; variabler kan placeras i brödtexten.
- Svaret finns tillgängligt för vidare åtgärder.
- Funktionen kräver administrativ behörighet.
Ett arbetsflöde i Google Workspace Studio kan behöva data utanför Gmail, Drive eller Chat: en orderstatus, ett nummer från en databas eller ett svar från ett internt verktyg. För att hämta dessa data eller skicka information till en annan tjänst kan du lägga till steget Skicka en webhookDetta gör en HTTP-förfrågan till adressen för ett API som du har angett.
Du behöver inte konfigurera Gemini-funktionsanropet för att göra den begäran. I Workspace Studio kör flödet webhook-steget och tar emot svaret. Om du sedan tycker att det är användbart kan du skicka svaret till ett annat steg för att sammanfatta det, extrahera data eller kommunicera resultatet.
Vad du behöver innan du ansluter till ett API
Det första steget är att verifiera att din organisation kan använda webhooks. Funktionen finns i begränsad förhandsvisning och är inaktiverad som standard. En administratör måste logga in. Appar > Google Workspace > Workspace Studio > Webhook-inställningar och aktivera det för motsvarande organisationsenhet.
I vissa utgåvor kan administratören också begränsa anslutningar till en lista över tillåtna domäner och webbadresserOm steget visas i Studio men inte kommunicerar med ditt API, kontrollera att destinationsadressen är auktoriserad. Som standard kräver dessutom åtgärder som involverar webhooks att användaren granskar och bekräftar steget innan det körs.
Från den externa tjänsten behöver du veta dess URL, de HTTP-metoder den stöder och det dataformat den förväntar sig. Kontrollera också hur den autentiserar: ett offentligt skrivskyddat API har andra krav än ett privat API som kräver tokens eller speciella rubriker.
Så här anropar du ett API från Workspace Studio steg för steg
Skriva in studio.workspace.google.com och skapa ett arbetsflöde med den utlösare du behöver. Du kan till exempel starta det när ett e-postmeddelande anländer som uppfyller vissa villkor. Följ sedan dessa steg:
- Trycka Lägg till steg och välj Skicka en webhook.
- Ange Fullständig URL av API:et, inklusive prefixet
https://Adressen måste åtgärdas: det här fältet stöder inte flödesvariabler. - Välj HTTP-metoden. FÅ Den används för att fråga data; POSTAför att skicka dem eller skapa en post. De är också tillgängliga LÄGG TILL, PATCHA och TA BORT.
- Om API:et kräver en brödtext, skriv den i innehållsfältet eller nyttolastGoogle rekommenderar att man använder JSON när den mottagande tjänsten förväntar sig det.
- Gör en testkörningKontrollera resultatet och aktivera flödet när du har verifierat att det fungerar.
Tänk på att testet utföra åtgärdenOm du konfigurerar en POST för att skapa en post eller en DELETE för att ta bort den, använd först en testmiljö eller data som du kan ändra utan problem.
Exempel: skicka ett meddelande till ett externt verktyg
Tänk dig att ditt team har ett API som skapar aviseringar i https://api.ejemplo.com/v1/avisosDenna adress är belysandeDu måste ersätta den med den från din tjänst. Om dokumentationen anger att den accepterar POST och en JSON-text kan du konfigurera steget med innehåll som {"tipo":"nuevo_correo","origen":"Workspace Studio"}.
Du kan också infoga en flödesvariabel I brödtexten, till exempel för att inkludera ämnet för e-postmeddelandet som utlöste det. Gör detta från Studios variabelväljare och kontrollera resultatet: om den infogade texten innehåller citattecken eller andra specialtecken kan det leda till att JSON-filen blir felaktigt formaterad. Variabler kan användas i innehållet, men inte i URL-fältet.
Om du behöver hämta data, välj GET och ange en fast URL som redan innehåller de nödvändiga parametrarna. Workspace Studio kommer att ignorera allt innehåll du har skrivit i brödtexten i en GET-begäran.
Vad man ska göra med API-svaret
Webhook-steget lämnar tjänstesvar som text i en variabel som är tillgänglig för efterföljande steg. Du kan använda den för att skicka ett meddelande, skriva en sammanfattning eller be ett AI-steg att extrahera specifik data.
Om till exempel API:et returnerar statusen för en order kan nästa steg kommunicera den statusen till teamet. Välj explicit variabeln som innehåller svaret: efterföljande steg tar inte automatiskt emot allt som hände tidigare i flödet. Det är lämpligt att testa det returnerade innehållet innan man skriver instruktioner som är beroende av det.
Om API:et kräver autentisering eller mer komplex logik
Den dokumenterade grundkonfigurationen för Skicka en webhook Den innehåller URL:en, metoden och en valfri brödtext. Om din integration behöver hämta en OAuth-token, konstruera en URL med variabla parametrar, lägga till specifika rubriker eller transformera ett svar innan du fortsätter, kontrollera om det här steget täcker dessa krav.
När det inte räcker är ett alternativ att utveckla en Anpassat steg för Workspace Studio via ett plugin. I en Google Apps Script-implementering, tjänsten UrlFetchApp Det låter dig göra förfrågningar till externa API:er och bearbeta JSON-svar. Den här lösningen kräver utveckling och korrekt behörighetskonfiguration; det är inte nödvändigt för enkla förfrågningar som det inbyggda steget redan kan hantera.
Undvik att klistra in privata nycklar i synliga fält i flödet eller bädda in dem i en delad URL. Innan du skickar data från Gmail, Chat eller Kalender, kontrollera vilken information den externa tjänsten kommer att ta emot och om den är behörig att bearbeta den.
Hur man hittar fel i en webhook
Om anslutningen misslyckas, öppna fliken Aktivitet av flödet. Där kan du se hela felet och svaret som skickades av destinationsservern. Denna information hjälper till att skilja mellan ett Studio-konfigurationsproblem och en begäran som avvisats av API:et.
- Steget visas inte: Kontrollera med din administratör om webhooks är aktiverade för din organisationsenhet.
- URL:en är blockerad: Kontrollera listan över tillåtna adresser om din utgåva använder den begränsningen.
- Fel 400: kontrollera brödtextformatet och de fält som krävs av API:et.
- Fel 401 eller 403: Granska de behörigheter och den autentiseringsmetod som krävs av tjänsten.
- Fel 429: Kontrollera om du har överskridit begärandegränsen för mål-API:et.
- Fel 500: Kontrollera status och register för den tjänst som tar emot begäran.
Tänk också på de allmänna begränsningarna i Workspace Studio: det stöder för närvarande upp till 25 flöden per användare y 20 steg per flödeDessutom finns det en kombinerad körningsgräns som återställs var 24:e timme. Om flera flöden slutar köras, granska deras aktivitet innan felet tillskrivs API:et.
För de flesta enkla HTTP-anslutningar är processen enkel: aktivera webhooken, konfigurera en fast URL och rätt metod, testa begäran och använd svaret i efterföljande steg. Om integrationen kräver avancerad autentisering eller transformering av data via kod är det klokt att förbereda ett anpassat steg.
Jag är en teknikentusiast som har gjort sina "nördar"-intressen till ett yrke. Jag har tillbringat mer än 10 år av mitt liv med att använda den senaste tekniken och mixtrat med alla typer av program av ren nyfikenhet. Nu har jag specialiserat mig på datateknik och tv-spel. Detta beror på att jag i mer än 5 år har arbetat med att skriva för olika webbplatser om teknik och videospel, skapa artiklar som försöker ge dig den information du behöver på ett språk som är begripligt för alla.
Om du har några frågor sträcker sig min kunskap från allt som rör operativsystemet Windows samt Android för mobiltelefoner. Och mitt engagemang är för dig, jag är alltid villig att spendera några minuter och hjälpa dig att lösa alla frågor du kan ha i den här internetvärlden.