- Det innebygde trinnet er å sende en webhook.
- URL-en er fast; variabler kan plasseres i brødteksten.
- Svaret er fortsatt tilgjengelig for videre skritt.
- Funksjonen krever administrativ autorisasjon.
En arbeidsflyt i Google Workspace Studio kan trenge data utenfra Gmail, Drive eller Chat: en ordrestatus, et nummer fra en database eller et svar fra et internt verktøy. For å hente disse dataene eller sende informasjon til en annen tjeneste kan du legge til trinnet Send en webhookDette lager en HTTP-forespørsel til adressen til et API du har spesifisert.
Du trenger ikke å konfigurere Gemini-funksjonskallet for å gjøre den forespørselen. I Workspace Studio utfører flyten webhook-trinnet og mottar svaret. Deretter, hvis du synes det er nyttig, kan du sende svaret til et annet trinn for å oppsummere det, trekke ut data eller kommunisere resultatet.
Det du trenger før du kobler til et API
Det første trinnet er å bekrefte at organisasjonen din kan bruke webhooks. Funksjonen ligger i begrenset forhåndsvisning og er deaktivert som standard. En administrator må logge inn. Apper > Google Workspace > Workspace Studio > Webhook-innstillinger og aktiver den for den tilsvarende organisasjonsenheten.
I noen utgaver kan administratoren også begrense tilkoblinger til én liste over tillatte domener og URL-erHvis trinnet vises i Studio, men ikke kommuniserer med API-et ditt, må du bekrefte at destinasjonsadressen er autorisert. Handlinger som involverer webhooks krever også som standard at brukeren gjennomgår og bekrefter trinnet før det kjøres.
Fra den eksterne tjenesten må du vite URL-en, HTTP-metodene den støtter og dataformatet den forventer. Sjekk også hvordan den autentiserer: et offentlig skrivebeskyttet API har andre krav enn et privat API som krever tokener eller spesielle overskrifter.
Slik kaller du et API fra Workspace Studio trinn for trinn
Gå studio.workspace.google.com og opprett en arbeidsflyt med utløseren du trenger. Du kan for eksempel starte den når en e-post kommer inn som oppfyller visse betingelser. Følg deretter disse trinnene:
- Pressen Legg til trinn og velg Send en webhook.
- Skriv inn Fullstendig URL av API-et, inkludert prefikset
https://Adressen må rettes: dette feltet støtter ikke flytvariabler. - Velg HTTP-metoden. BLI Den brukes til å spørre data; STOLPEfor å sende dem eller opprette en oppføring. De er også tilgjengelige PUT, PATCH og DELETE.
- Hvis API-et krever en brødtekst, skriv den i innholdsfeltet eller nyttelastGoogle anbefaler å bruke JSON når mottakertjenesten forventer det.
- Lag en testutførelseSjekk resultatet og aktiver flyten når du har bekreftet at den fungerer.
Husk at testen utfør handlingenHvis du konfigurerer en POST for å opprette en post eller en DELETE for å slette den, må du først bruke et testmiljø eller data som du kan endre uten problemer.
Eksempel: sending av et varsel til et eksternt verktøy
Tenk deg at teamet ditt har et API som oppretter varsler i https://api.ejemplo.com/v1/avisosDenne adressen er illustrerendeDu må erstatte den med den fra tjenesten din. Hvis dokumentasjonen indikerer at den godtar POST og en JSON-tekst, kan du konfigurere trinnet med innhold som {"tipo":"nuevo_correo","origen":"Workspace Studio"}.
Du kan også sette inn en flytvariabel I brødteksten, for eksempel for å inkludere emnet i e-posten som utløste den. Gjør dette fra Studios variabelvelger og sjekk resultatet: hvis den innsatte teksten inneholder anførselstegn eller andre spesialtegn, kan det føre til at JSON-en blir feilformet. Variabler kan brukes i innholdet, men ikke i URL-feltet.
Hvis du trenger å hente data, velger du GET og skriver inn en fast URL som allerede inneholder de nødvendige parameterne. Workspace Studio vil ignorere alt innhold du har skrevet i brødteksten til en GET-forespørsel.
Hva du skal gjøre med API-svaret
Webhook-trinnet forlater tjenestesvar som tekst i en variabel som er tilgjengelig for påfølgende trinn. Du kan bruke den til å sende et varsel, skrive et sammendrag eller be et AI-trinn om å trekke ut spesifikke data.
Hvis for eksempel API-et returnerer statusen til en ordre, kan neste trinn kommunisere denne statusen til teamet. Velg eksplisitt variabelen som inneholder svaret: påfølgende trinn mottar ikke automatisk alt som skjedde tidligere i flyten. Det anbefales å teste det returnerte innholdet før du skriver instruksjoner som er avhengige av det.
Hvis API-et krever autentisering eller mer kompleks logikk
Den dokumenterte grunnleggende konfigurasjonen for Send en webhook Den inneholder URL-en, metoden og en valgfri brødtekst. Hvis integrasjonen din trenger å hente et OAuth-token, konstruere en URL med variable parametere, legge til spesifikke overskrifter eller transformere et svar før du fortsetter, må du sjekke om dette trinnet dekker disse kravene.
Når det ikke lykkes, er ett alternativ å utvikle en Tilpasset trinn for Workspace Studio via en plugin. I en Google Apps Script-implementering, tjenesten UrlFetchApp Den lar deg sende forespørsler til eksterne API-er og behandle JSON-svar. Denne løsningen krever utvikling og riktig tillatelseskonfigurasjon; den er ikke nødvendig for enkle forespørsler som det native trinnet allerede kan håndtere.
Unngå å lime inn private nøkler i synlige felt i flyten eller bygge dem inn i en delt URL. Før du sender data fra Gmail, Chat eller Kalender, må du bekrefte hvilken informasjon den eksterne tjenesten vil motta og om den er autorisert til å behandle den.
Slik finner du feil i en webhook
Hvis tilkoblingen mislykkes, åpne fanen Aktivitet av flyten. Der kan du se hele feilen og svaret som ble sendt av målserveren. Denne informasjonen hjelper deg med å skille mellom et Studio-konfigurasjonsproblem og en forespørsel som ble avvist av API-et.
- Trinnet vises ikke: Sjekk med administratoren din om webhooks er aktivert for organisasjonsenheten din.
- URL-en er blokkert: Sjekk listen over tillatte adresser hvis utgaven din bruker den begrensningen.
- Feil 400: sjekk brødtekstformatet og feltene som kreves av API-et.
- Feil 401 eller 403: Se gjennom tillatelsene og autentiseringsmetoden som kreves av tjenesten.
- Feil 429: Sjekk om du har overskredet forespørselsgrensen for mål-API-et.
- Feil 500: Sjekk statusen og registreringene til tjenesten som mottar forespørselen.
Husk også de generelle begrensningene til Workspace Studio: det støtter for øyeblikket opptil 25 flyter per bruker y 20 trinn per flytI tillegg finnes det en kombinert utførelsesgrense som tilbakestilles hver 24. time. Hvis flere flyter slutter å kjøre, må du gjennomgå aktiviteten deres før du tilskriver feilen til API-et.
For de fleste enkle HTTP-tilkoblinger er prosessen enkel: aktiver webhooken, konfigurer en fast URL og riktig metode, test forespørselen, og bruk svaret i påfølgende trinn. Hvis integrasjonen krever avansert autentisering eller transformering av data gjennom kode, er det fornuftig å forberede et tilpasset trinn.
Jeg er en teknologientusiast som har gjort sine "geek"-interesser til et yrke. Jeg har brukt mer enn 10 år av livet mitt på å bruke banebrytende teknologi og fikse med alle slags programmer av ren nysgjerrighet. Nå har jeg spesialisert meg på datateknologi og videospill. Dette er fordi jeg i mer enn 5 år har skrevet for forskjellige nettsteder om teknologi og videospill, og laget artikler som prøver å gi deg den informasjonen du trenger på et språk som er forståelig for alle.
Hvis du har spørsmål, spenner min kunnskap fra alt relatert til Windows-operativsystemet samt Android for mobiltelefoner. Og mitt engasjement er til deg, jeg er alltid villig til å bruke noen minutter og hjelpe deg med å løse eventuelle spørsmål du måtte ha i denne internettverdenen.