Oplossing voor webhook-fouten in Workspace Studio

Je hebt een workflow gemaakt in Google Workspace Studio en je hebt de stap toegevoegd. Verzend een webhook En het verzoek bereikt de bestemming nooit. Of misschien werkte het eerst wel en is er nu een fout opgetreden. Voordat je de URL zomaar aanpast, is het de moeite waard om dit te onderzoeken. Op welk punt stopt de uitvoering?: toegang tot de stap, een goedkeuring in behandeling, de configuratie van het verzoek of het antwoord van de externe dienst.

Workspace Studio gebruikt deze stap om een HTTP-verzoek naar een specifiek adresDit kan worden gebruikt om een ​​interne tool te informeren, een record in een andere applicatie aan te maken of gegevens te verzenden naar een service die geen directe koppeling heeft. De oplossing hangt af van de vraag of de blokkering zich binnen Google Workspace of op de server die het verzoek ontvangt voordoet.

Controleer of de beheerder webhooks heeft ingeschakeld.

Si Verzend een webhook Het staat niet tussen de beschikbare stappen; begin met de machtigingen van de organisatie. Google geeft aan dat deze functie... standaard uitgeschakeld En dat een beheerder dit moet inschakelen voor de betreffende organisatie-eenheid. Het pad is Beheerconsole > Apps > Google Workspace > Workspace Studio > Webhook-instellingen.

Controleer ook of uw account toegang heeft tot de functie: Google blijft het doorgeven van webhooks identificeren als een functie in beperkte previewAls u geen beheerder bent, geef dan de Workspace-beheerder de naam van de ontbrekende stap, uw account en de organisatie-eenheid waartoe u behoort. Hierdoor kan de beheerder de relevante instellingen controleren zonder de machtigingen van andere teams te beïnvloeden.

Bekijk de lijst met toegestane URL's en goedkeuringen.

In sommige edities kan de beheerder externe bestemmingen beperken met behulp van een Lijst met toegestane domeinen en URL'sAls de stap bestaat maar u geen verbinding kunt maken met een specifiek eindpunt, controleer dan of uw domein of URL in die lijst staat. Deze instelling wordt beheerd via de import- en ophaalopties voor Drive- en Docs-URL's.

Deze beperking Het werkt niet in alle edities hetzelfde.De whitelist voor webhooks is beschikbaar in edities zoals Business Plus, Enterprise Standard en Plus, en Education Standard en Plus. In edities die deze controle niet bieden, staat het inschakelen van webhooks verbindingen met geldige URL's toe zonder deze whitelist toe te passen. Het is daarom raadzaam om eerst uw editie en het beleid van uw organisatie te controleren.

De stroom kan ook wachten op een gebruikersgoedkeuringHet verzenden van gegevens naar een extern eindpunt door Google wordt beschouwd als een gevoelige actie en vereist standaard beoordeling en bevestiging. Als de automatisering vastloopt, open dan Studio en controleer of er nog goedkeuringsverzoeken openstaan ​​voordat u concludeert dat de server niet werkt.

Configureer de URL, de methode en de verzonden gegevens correct.

Open de stroom in studio.workspace.google.com en controleer de stap 'Een webhook verzenden'. Het adres moet zijn compleet en statischHet veld accepteert een URL die begint met http:// o https://Maar het is niet mogelijk om variabelen rechtstreeks in de URL in te voegen. HTTPS is de aanbevolen optie. Om te voorkomen dat onversleutelde informatie wordt verzonden; dit is geen vereiste binnen het vakgebied.

• HTTP-methode: Selecteer de gewenste methode voor de doel-API. Studio biedt GET, POST, PUT, PATCH en DELETE; POST is de standaardmethode.
• Inhoud van het verzoek: Het is optioneel en wordt als tekst verzonden. Voor veel API's is het raadzaam om JSON te gebruiken, waarbij de aanhalingstekens, accolades en veldnamen die de service vereist, in acht moeten worden genomen.
• Variabelen: Je kunt gegevens uit eerdere stappen in de body opnemen. Controleer het resultaat wanneer een variabele aanhalingstekens, regeleinden of andere tekens bevat die de JSON-indeling kunnen verstoren.
• GET-verzoeken: Studio negeert de request body met deze methode. Als de service gegevens in de body vereist, controleer dan welke methode in de documentatie wordt ondersteund.

Maak een testuitvoering En vergeet niet dat er een daadwerkelijk verzoek naar de bestemming wordt verzonden. Als de stap slaagt, wordt het antwoord beschikbaar als een tekstvariabele voor later gebruik in hetzelfde proces.

Gebruik het tabblad Activiteit om het probleem te lokaliseren.

Na elke uitvoering, openen Activiteit In Workspace Studio. Als het verzoek succesvol was, kunt u de verzonden gegevens en het ontvangen antwoord bekijken. Als het mislukte, toont Studio de foutmelding. foutcode en bestemmings-URL-antwoordDeze informatie stelt ons in staat onderscheid te maken tussen een configuratieprobleem in de workflow en een afwijzing veroorzaakt door de externe service.

Un 400 Dit duidt er meestal op dat de ontvanger het verzoek niet accepteert zoals het is geschreven; ze beoordelen de methode en de inhoud. In het geval van een 401 of 403Controleer de toegangsvereisten van de dienst en de beperkingen van uw organisatie. 404 Het vraagt ​​u om de eindpuntroute te verifiëren. Als een 429Controleer uw aanvraaglimieten; fouten 5xx Ze duiden meestal op een probleem met de ontvangende dienst. De specifieke reactie van het eindpunt is nuttiger dan het getal op zichzelf te interpreteren.

Beheerders kunnen ook de volgende informatie raadplegen: Workspace Studio-gebeurtenislogboeken Om webhookverzoeken te onderzoeken. De toegang tot bepaalde gegevens, zoals de opgevraagde URL, is beperkt omdat deze gevoelige informatie kan bevatten.

Verwar de Studio-webhook niet met een inkomende Google Chat-webhook.

De stap Verzend een webhook Workspace Studio doet een verzoek aan een externe URL. inkomende Google Chat-webhookDaarentegen is het een URL die binnen een ruimte is aangemaakt, zodat een ander systeem daar berichten kan plaatsen. Het zijn afzonderlijke elementen, ook al kun je de chat-URL gebruiken als bestemming voor een Studio-flow.

Als je een advertentie op Google Chat wilt plaatsen, controleer dan eerst of stap 1 voldoende is. Publiceren in een ruimte vanuit Studio. Als u een inkomende webhook wilt gebruiken, moet u deze aanmaken vanuit Studio. Apps en integraties De webhooks maken gebruik van de ruimte en houden de URL ervan privé, inclusief een sleutel en een token. Deze webhooks worden gebruikt om berichten naar de ruimte te sturen, maar maken geen communicatie met gebruikers mogelijk.

Google Chat hanteert een gedeeld quotum voor inkomende webhooks. één verzoek per seconde en per ruimteDeze limiet geldt voor de chat; het is geen algemene limiet voor de stap 'Een webhook verzenden' in Workspace Studio. Als de fout optreedt bij het plaatsen van meerdere aankondigingen achter elkaar in dezelfde ruimte, controleer dan dit quotum samen met het antwoord op het verzoek.

Controleer de doorvoerlimieten als de fouten zich af en toe voordoen.

Met Workspace Studio kunt u tot wel 25 flows per gebruiker, met een maximum van 20 stappen per stroomDaarnaast geldt er een gecombineerde limiet voor het aantal uitvoeringen per periode van 24 uur. Als deze limiet wordt bereikt, zullen verdere uitvoeringen mislukken totdat de teller is gereset.

Als de webhook pas na meerdere activeringen mislukt, controleer dan het volgende: Activiteit Controleer zowel de limieten van Studio als die van de doelservice. Door de trigger te verfijnen – bijvoorbeeld door deze te beperken tot specifieke afzenders of gebeurtenissen – kunt u onnodige verzoeken voorkomen. Als de fout optreedt bij de eerste keer uitvoeren, controleer dan eerst de machtigingen, de openstaande goedkeuringen en de reactie van het eindpunt.