Λύση για βλάβες Webhook στο Workspace Studio

Δημιουργήσατε μια ροή στο Google Workspace Studio, προσθέσατε το βήμα Αποστολή webhook Και το αίτημα δεν φτάνει ποτέ στον προορισμό του. Ή ίσως η ροή λειτουργούσε και τώρα παρουσιάζεται σφάλμα. Πριν αλλάξετε τυφλά τη διεύθυνση URL, αξίζει να το διερευνήσετε. Σε ποιο σημείο σταματά η εκτέλεση;: πρόσβαση στο βήμα, σε μια εκκρεμή έγκριση, στη διαμόρφωση του αιτήματος ή στην απόκριση από την εξωτερική υπηρεσία.

Το Workspace Studio χρησιμοποιεί αυτό το βήμα για να στείλει ένα Αίτημα HTTP σε συγκεκριμένη διεύθυνσηΑυτό μπορεί να χρησιμοποιηθεί για την ειδοποίηση ενός εσωτερικού εργαλείου, τη δημιουργία μιας εγγραφής σε άλλη εφαρμογή ή την αποστολή δεδομένων σε μια υπηρεσία που δεν διαθέτει άμεση σύνδεση. Η λύση εξαρτάται από το αν το μπλοκάρισμα παρουσιάζεται εντός του Google Workspace ή στον διακομιστή που λαμβάνει το αίτημα.

Ελέγξτε εάν ο διαχειριστής έχει ενεργοποιήσει τα webhooks

Si Αποστολή webhook Δεν εμφανίζεται στα διαθέσιμα βήματα. Ξεκινήστε με τα δικαιώματα του οργανισμού. Η Google υποδεικνύει ότι αυτή η λειτουργία είναι... απενεργοποιημένο από προεπιλογή και ότι ένας διαχειριστής πρέπει να το ενεργοποιήσει για την αντίστοιχη οργανωτική μονάδα. Η διαδρομή είναι Κονσόλα διαχειριστή > Εφαρμογές > Google Workspace > Workspace Studio > Ρυθμίσεις Webhook.

Ελέγξτε επίσης ότι ο λογαριασμός σας έχει πρόσβαση στη λειτουργία: Η Google συνεχίζει να αναγνωρίζει την αποστολή webhook ως λειτουργία στο περιορισμένη προεπισκόπησηΕάν δεν είστε διαχειριστής, δώστε στον διαχειριστή του χώρου εργασίας το όνομα του βήματος που λείπει, τον λογαριασμό σας και την οργανωτική μονάδα στην οποία ανήκετε. Αυτό θα του επιτρέψει να επαληθεύσει τις ισχύουσες ρυθμίσεις χωρίς να επηρεάσει τα δικαιώματα σε άλλες ομάδες.

Ελέγξτε τη λίστα με τις επιτρεπόμενες διευθύνσεις URL και τις εγκρίσεις

Σε ορισμένες εκδόσεις, ο διαχειριστής μπορεί να περιορίσει τους εξωτερικούς προορισμούς χρησιμοποιώντας ένα λίστα επιτρεπόμενων τομέων και διευθύνσεων URLΕάν το βήμα υπάρχει αλλά δεν μπορείτε να συνδεθείτε σε ένα συγκεκριμένο τελικό σημείο, επιβεβαιώστε ότι ο τομέας ή η διεύθυνση URL σας βρίσκεται σε αυτήν τη λίστα. Αυτή η ρύθμιση διαχειρίζεται από τις επιλογές εισαγωγής και ανάκτησης URL του Drive και των Εγγράφων.

Αυτός ο περιορισμός Δεν λειτουργεί το ίδιο σε όλες τις εκδόσειςΗ λίστα επιτρεπόμενων webhook είναι διαθέσιμη σε εκδόσεις όπως Business Plus, Enterprise Standard και Plus, και Education Standard και Plus. Σε εκδόσεις που δεν προσφέρουν αυτόν τον έλεγχο, η ενεργοποίηση των webhooks επιτρέπει συνδέσεις σε έγκυρες διευθύνσεις URL χωρίς την εφαρμογή αυτής της λίστας επιτρεπόμενων. Επομένως, συνιστάται να ελέγξετε πρώτα την έκδοσή σας και την πολιτική του οργανισμού σας.

Η ροή μπορεί επίσης να περιμένει ένα έγκριση χρήστηΗ Google αντιμετωπίζει την αποστολή δεδομένων σε εξωτερικό τελικό σημείο ως ευαίσθητη ενέργεια και απαιτεί έλεγχο και επιβεβαίωση από προεπιλογή. Εάν ο αυτοματισμός φαίνεται να έχει κολλήσει, ανοίξτε το Studio και ελέγξτε για αιτήματα έγκρισης που εκκρεμούν πριν καταλήξετε στο συμπέρασμα ότι ο διακομιστής έχει αποτύχει.

Ρυθμίστε σωστά τη διεύθυνση URL, τη μέθοδο και τα δεδομένα που στάλθηκαν.

Άνοιγμα της ροής εισόδου studio.workspace.google.com και ελέγξτε το βήμα Αποστολή webhook. Η διεύθυνση θα πρέπει να είναι πλήρης και στατικήΤο πεδίο δέχεται μια διεύθυνση URL που ξεκινά με http:// o https://αλλά δεν επιτρέπει την εισαγωγή μεταβλητών στην ίδια τη διεύθυνση URL. Το HTTPS είναι η προτεινόμενη επιλογή για να αποφευχθεί η αποστολή μη κρυπτογραφημένων πληροφοριών· δεν είναι απαίτηση του πεδίου.

• Μέθοδος HTTP: Επιλέξτε αυτήν που αναμένεται από το API-στόχο. Το Studio προσφέρει GET, POST, PUT, PATCH και DELETE. Η προεπιλεγμένη ρύθμιση είναι η POST.
• Κύριο μέρος του αιτήματος: Είναι προαιρετικό και αποστέλλεται ως κείμενο. Για πολλά API, συνιστάται η χρήση JSON, τηρώντας τα εισαγωγικά, τις αγκύλες και τα ονόματα πεδίων που απαιτούνται από την υπηρεσία.
• Μεταβλητές: Μπορείτε να συμπεριλάβετε δεδομένα από προηγούμενα βήματα στο κυρίως μέρος. Ελέγξτε το αποτέλεσμα όταν μια μεταβλητή περιέχει εισαγωγικά, αλλαγές γραμμής ή άλλους χαρακτήρες που ενδέχεται να παραβιάζουν τη μορφή JSON.
• Αιτήματα GET: Το Studio αγνοεί το κύριο μέρος του αιτήματος με αυτήν τη μέθοδο. Εάν η υπηρεσία απαιτεί δεδομένα στο κύριο μέρος, ελέγξτε ποια μέθοδο υποστηρίζει η τεκμηρίωσή της.

Κάντε ένα εκτέλεση δοκιμής Και να θυμάστε ότι θα στείλει ένα πραγματικό αίτημα στον προορισμό. Εάν το βήμα λειτουργήσει, η απάντησή του γίνεται διαθέσιμη ως μεταβλητή κειμένου για μελλοντική χρήση στην ίδια ροή.

Χρησιμοποιήστε την καρτέλα Δραστηριότητα για να εντοπίσετε το πρόβλημα

Μετά από κάθε εκτέλεση, ανοίξτε Δραστηριότητα στο Workspace Studio. Εάν το αίτημα ήταν επιτυχές, μπορείτε να ελέγξετε τα δεδομένα που στάλθηκαν και την απάντηση που λάβατε. Εάν αποτύχει, το Studio εμφανίζει το κωδικός σφάλματος και απόκριση διεύθυνσης URL προορισμούΑυτές οι πληροφορίες μας επιτρέπουν να διακρίνουμε μεταξύ ενός προβλήματος διαμόρφωσης στη ροή και μιας απόρριψης που προκαλείται από την εξωτερική υπηρεσία.

Un 400 Αυτό συνήθως υποδηλώνει ότι ο παραλήπτης δεν αποδέχεται το αίτημα όπως είναι γραμμένο. Εξετάζει τη μέθοδο και το σώμα. Σε περίπτωση 401 ή 403Ελέγξτε τις απαιτήσεις πρόσβασης της υπηρεσίας και τους περιορισμούς του οργανισμού σας. 404 Σας ζητά να επαληθεύσετε τη διαδρομή του τελικού σημείου. Εάν ένα 429Ελέγξτε τα όρια των αιτημάτων σας· σφάλματα 5xx Συνήθως υποδεικνύουν κάποιο πρόβλημα με την υπηρεσία λήψης. Η συγκεκριμένη απόκριση από το τελικό σημείο είναι πιο χρήσιμη από την ερμηνεία του αριθμού μεμονωμένα.

Οι διαχειριστές μπορούν επίσης να συμβουλευτούν το Αρχεία καταγραφής συμβάντων Workspace Studio για τη διερεύνηση αιτημάτων webhook. Η πρόσβαση σε ορισμένα δεδομένα, όπως η ζητούμενη διεύθυνση URL, είναι περιορισμένη επειδή ενδέχεται να περιέχουν ευαίσθητες πληροφορίες.

Μην συγχέετε το webhook του Studio με ένα εισερχόμενο webhook του Google Chat.

Το βήμα Αποστολή webhook Το Workspace Studio υποβάλλει ένα αίτημα σε μια εξωτερική διεύθυνση URL. εισερχόμενο webhook Google ChatΑντίθετα, πρόκειται για μια διεύθυνση URL που δημιουργείται μέσα σε έναν χώρο για να δημοσιεύσει μηνύματα εκεί ένα άλλο σύστημα. Είναι ξεχωριστά στοιχεία, παρόλο που μπορείτε να χρησιμοποιήσετε τη διεύθυνση URL συνομιλίας ως προορισμό για μια ροή Studio.

Αν ο στόχος σας είναι να δημοσιεύσετε μια διαφήμιση στο Google Chat, ελέγξτε πρώτα αν το βήμα 1 είναι επαρκές. Δημοσίευση σε έναν χώρο από το Studio. Εάν χρειάζεται να χρησιμοποιήσετε ένα εισερχόμενο webhook, πρέπει να το δημιουργήσετε από Εφαρμογές και ενσωματώσεις του χώρου και να διατηρείται η διεύθυνση URL του ιδιωτική, η οποία περιλαμβάνει ένα κλειδί και ένα διακριτικό. Αυτά τα webhooks χρησιμοποιούνται για την αποστολή μηνυμάτων στον χώρο, αλλά δεν επιτρέπουν τη συνομιλία με τους χρήστες.

Το Google Chat εφαρμόζει ένα κοινόχρηστο όριο στα εισερχόμενα webhooks. ένα αίτημα ανά δευτερόλεπτο και ανά χώροΑυτό το όριο ισχύει για τη Συνομιλία. Δεν είναι γενικό όριο για το βήμα Αποστολή Webhook στο Workspace Studio. Εάν το σφάλμα παρουσιάζεται κατά την ανάρτηση πολλών ανακοινώσεων στη σειρά στον ίδιο χώρο, ελέγξτε αυτό το όριο μαζί με την απάντηση στο αίτημα.

Ελέγξτε τα όρια ροής εάν τα σφάλματα είναι διαλείποντα.

Το Workspace Studio σάς επιτρέπει να δημιουργήσετε έως και 25 ροές ανά χρήστη, με μέγιστο 20 βήματα ανά ροήΕπιπλέον, εφαρμόζει ένα συνδυασμένο όριο στον αριθμό των εκτελέσεων κατά τη διάρκεια κάθε 24ωρης περιόδου. Εάν φτάσετε αυτό το όριο, οι περαιτέρω εκτελέσεις θα αποτύχουν μέχρι να μηδενιστεί ο μετρητής.

Όταν το webhook αποτυγχάνει μόνο μετά από πολλές ενεργοποιήσεις, ελέγξτε Δραστηριότητα Ελέγξτε τα όρια τόσο του Studio όσο και αυτά της υπηρεσίας-στόχου. Η βελτίωση της ενεργοποίησης —για παράδειγμα, ο περιορισμός της σε συγκεκριμένους αποστολείς ή συμβάντα— μπορεί να αποτρέψει περιττά αιτήματα. Εάν το σφάλμα παρουσιαστεί κατά την πρώτη εκτέλεση, ξεκινήστε ελέγχοντας τα δικαιώματα, τις εκκρεμείς εγκρίσεις και την απόκριση του τελικού σημείου.