Lösung für Webhook-Fehler in Workspace Studio

Sie haben einen Flow in Google Workspace Studio erstellt und den Schritt hinzugefügt. Senden Sie einen Webhook Die Anfrage erreicht ihr Ziel nie. Oder vielleicht funktionierte der Ablauf vorher und jetzt tritt ein Fehler auf. Bevor man die URL einfach ändert, sollte man das untersuchen. An welchem ​​Punkt wird die Ausführung gestoppt?Zugriff auf den Schritt, eine ausstehende Genehmigung, die Konfiguration der Anfrage oder die Antwort des externen Dienstes.

Workspace Studio verwendet diesen Schritt, um eine HTTP-Anfrage an eine bestimmte AdresseDies kann genutzt werden, um ein internes Tool zu benachrichtigen, einen Datensatz in einer anderen Anwendung zu erstellen oder Daten an einen Dienst zu senden, der keine direkte Verbindung besitzt. Die Lösung hängt davon ab, ob die Blockierung innerhalb von Google Workspace oder auf dem Server auftritt, der die Anfrage empfängt.

Prüfen Sie, ob der Administrator Webhooks aktiviert hat.

Si Senden Sie einen Webhook Diese Option ist nicht in den verfügbaren Schritten aufgeführt; beginnen Sie mit den Berechtigungen der Organisation. Google gibt an, dass diese Funktion... Standardmäßig deaktiviert und dass ein Administrator die Funktion für die entsprechende Organisationseinheit aktivieren muss. Der Pfad lautet: Admin-Konsole > Apps > Google Workspace > Workspace Studio > Webhook-Einstellungen.

Prüfen Sie außerdem, ob Ihr Konto Zugriff auf diese Funktion hat: Google kennzeichnet die Webhook-Weiterleitung weiterhin als Funktion in begrenzte VorschauWenn Sie kein Administrator sind, geben Sie dem Workspace-Administrator den Namen des fehlenden Schritts, Ihr Konto und Ihre Organisationseinheit an. So kann er die entsprechenden Einstellungen überprüfen, ohne die Berechtigungen anderer Teams zu beeinträchtigen.

Überprüfen Sie die Liste der zulässigen URLs und Genehmigungen.

In einigen Editionen kann der Administrator externe Ziele mithilfe eines Liste der zulässigen Domains und URLsFalls der Schritt vorhanden ist, Sie aber keine Verbindung zu einem bestimmten Endpunkt herstellen können, überprüfen Sie, ob Ihre Domain oder URL in dieser Liste enthalten ist. Diese Einstellung wird über die Import- und Abrufoptionen für URLs in Drive und Docs verwaltet.

Diese Einschränkung Es funktioniert nicht in allen Editionen gleich.Die Webhook-Zulassungsliste ist in Editionen wie Business Plus, Enterprise Standard und Plus sowie Education Standard und Plus verfügbar. In Editionen, die diese Steuerung nicht bieten, ermöglicht die Aktivierung von Webhooks Verbindungen zu gültigen URLs, ohne dass diese Zulassungsliste angewendet wird. Daher empfiehlt es sich, zunächst Ihre Edition und die Richtlinien Ihrer Organisation zu prüfen.

Der Fluss wartet möglicherweise auch auf einen NutzerzulassungGoogle behandelt das Senden von Daten an einen externen Endpunkt als sensible Aktion und verlangt standardmäßig eine Überprüfung und Bestätigung. Falls die Automatisierung nicht weiterläuft, öffnen Sie Studio und prüfen Sie, ob Genehmigungsanfragen ausstehen, bevor Sie von einem Serverausfall ausgehen.

Konfigurieren Sie die URL, die Methode und die zu sendenden Daten korrekt.

Öffnen Sie den Fluss in studio.workspace.google.com und überprüfen Sie den Schritt „Webhook senden“. Die Adresse sollte lauten: vollständig und statischDas Feld akzeptiert eine URL, die mit folgendem beginnt: http:// o https://Es erlaubt jedoch nicht, Variablen in die URL selbst einzufügen. HTTPS ist die empfohlene Option. um das Senden unverschlüsselter Informationen zu vermeiden; dies ist keine Voraussetzung für dieses Fachgebiet.

• HTTP-Methode: Wählen Sie die vom Ziel-API erwartete Methode aus. Studio bietet GET, POST, PUT, PATCH und DELETE an; POST ist die Standardeinstellung.
• Inhalt der Anfrage: Es ist optional und wird als Text gesendet. Für viele APIs empfiehlt es sich, JSON zu verwenden und dabei die vom Dienst geforderten Anführungszeichen, geschweiften Klammern und Feldnamen zu beachten.
• Variablen: Sie können Daten aus vorherigen Schritten in den Nachrichtentext einfügen. Überprüfen Sie das Ergebnis, wenn eine Variable Anführungszeichen, Zeilenumbrüche oder andere Zeichen enthält, die das JSON-Format beschädigen könnten.
• GET-Anfragen: Studio ignoriert bei dieser Methode den Anfragetext. Falls der Dienst Daten im Anfragetext benötigt, prüfen Sie, welche Methode in der Dokumentation beschrieben ist.

Stelle ein Testausführung Denken Sie daran, dass dadurch eine tatsächliche Anfrage an das Ziel gesendet wird. Wenn der Schritt erfolgreich ist, steht die Antwort als Textvariable zur späteren Verwendung im selben Ablauf zur Verfügung.

Verwenden Sie die Registerkarte „Aktivität“, um das Problem zu lokalisieren.

Nach jeder Ausführung öffnen Aktivität in Workspace Studio. Wenn die Anfrage erfolgreich war, können Sie die gesendeten Daten und die empfangene Antwort überprüfen. Im Fehlerfall zeigt Studio die Fehlermeldung an. Fehlercode und Ziel-URL-AntwortMithilfe dieser Informationen können wir zwischen einem Konfigurationsproblem im Ablauf und einer durch den externen Dienst verursachten Ablehnung unterscheiden.

Un 400 Dies deutet in der Regel darauf hin, dass der Empfänger die Anfrage nicht in ihrer ursprünglichen Form akzeptiert; er prüft die Methode und den Inhalt der Anfrage. Im Falle eines 401 oder 403Prüfen Sie die Zugriffsvoraussetzungen des Dienstes und die Beschränkungen Ihrer Organisation. 404 Sie werden aufgefordert, die Endpunktroute zu überprüfen. Wenn ein 429Überprüfen Sie Ihre Anforderungslimits; Fehler 5xx Sie deuten in der Regel auf ein Problem mit dem empfangenden Dienst hin. Die konkrete Antwort des Endpunkts ist aussagekräftiger als die isolierte Interpretation der Zahl.

Administratoren können auch die Workspace Studio-Ereignisprotokolle zur Untersuchung von Webhook-Anfragen. Der Zugriff auf bestimmte Daten, wie z. B. die angeforderte URL, ist eingeschränkt, da diese sensible Informationen enthalten könnten.

Verwechseln Sie den Studio-Webhook nicht mit einem eingehenden Google Chat-Webhook.

Der Schritt Senden Sie einen Webhook Workspace Studio sendet eine Anfrage an eine externe URL. eingehender Google Chat-WebhookIm Gegensatz dazu handelt es sich um eine URL, die innerhalb eines Bereichs erstellt wird, damit ein anderes System dort Nachrichten veröffentlichen kann. Es sind separate Elemente, auch wenn Sie die Chat-URL als Ziel für einen Studio-Flow verwenden können.

Wenn Sie eine Anzeige auf Google Chat schalten möchten, prüfen Sie zunächst, ob Schritt 1 ausreicht. Im Raum veröffentlichen aus Studio. Wenn Sie einen eingehenden Webhook verwenden müssen, müssen Sie ihn erstellen von Apps und Integrationen Der Webhook speichert die URL des virtuellen Raums, die einen Schlüssel und ein Token enthält, und hält diese geheim. Er dient dazu, Nachrichten an den virtuellen Raum zu senden, ermöglicht aber keine Kommunikation mit Nutzern.

Google Chat wendet ein gemeinsames Kontingent für seine eingehenden Webhooks an. eine Anfrage pro Sekunde und pro SpeicherplatzDieses Limit gilt für den Chat; es handelt sich nicht um ein allgemeines Limit für den Schritt „Webhook senden“ in Workspace Studio. Wenn der Fehler beim Veröffentlichen mehrerer Ankündigungen nacheinander im selben Bereich auftritt, überprüfen Sie dieses Kontingent zusammen mit der Antwort auf die Anfrage.

Prüfen Sie die Durchflusskontingente, falls die Fehler nur zeitweise auftreten.

Workspace Studio ermöglicht Ihnen die Erstellung von bis zu 25 Flows pro Benutzer, mit maximal 20 Schritte pro AblaufZusätzlich wird eine kombinierte Begrenzung der Ausführungsanzahl innerhalb jedes 24-Stunden-Zeitraums angewendet. Wird diese Begrenzung erreicht, schlagen weitere Ausführungen fehl, bis der Zähler zurückgesetzt wird.

Wenn der Webhook erst nach vielen Aktivierungen fehlschlägt, überprüfen Sie Folgendes: Aktivität Prüfen Sie sowohl die Beschränkungen von Studio als auch die des Zieldienstes. Durch die Optimierung des Auslösers – beispielsweise durch Beschränkung auf bestimmte Absender oder Ereignisse – lassen sich unnötige Anfragen vermeiden. Tritt der Fehler beim ersten Ausführen auf, überprüfen Sie zunächst die Berechtigungen, ausstehende Genehmigungen und die Antwort des Endpunkts.