פתרון לכשלים ב-Webhook ב-Workspace Studio

יצרת זרימה ב-Google Workspace Studio, הוספת את השלב שלח וובהוק והבקשה לעולם לא מגיעה ליעדה. או שאולי הזרימה עבדה ועכשיו מתרחשת שגיאה. לפני שמשנים את כתובת ה-URL באופן עיוור, כדאי לבדוק. באיזו נקודה הביצוע נעצר?: גישה לשלב, אישור ממתין, תצורת הבקשה או התגובה מהשירות החיצוני.

Workspace Studio משתמש בשלב זה כדי לשלוח בקשת HTTP לכתובת ספציפיתניתן להשתמש בכך כדי להודיע ​​לכלי פנימי, ליצור רשומה באפליקציה אחרת, או לשלוח נתונים לשירות שאין לו מחבר ישיר. הפתרון תלוי אם החסימה מתרחשת בתוך Google Workspace או בשרת שמקבל את הבקשה.

בדוק אם מנהל המערכת הפעיל webhooks

Si שלח וובהוק זה לא מופיע בין השלבים הזמינים; התחילו עם הרשאות הארגון. גוגל מציינת שתכונה זו היא... מושבת כברירת מחדל ושמנהל מערכת חייב להפעיל זאת עבור היחידה הארגונית הרלוונטית. הנתיב הוא מסוף ניהול > אפליקציות > Google Workspace > Workspace Studio > הגדרות Webhook.

כמו כן, בדוק שלחשבונך יש גישה לתכונה: גוגל ממשיכה לזהות העברת webhook כתכונה ב- תצוגה מקדימה מוגבלתאם אינך מנהל מערכת, ספק למנהל סביבת העבודה את שם השלב החסר, את החשבון שלך ואת היחידה הארגונית שאליה אתה שייך. זה יאפשר לו לאמת את ההגדרות הרלוונטיות מבלי להשפיע על הרשאות בצוותים אחרים.

סקור את רשימת כתובות ה-URL והאישורים המותרים

במהדורות מסוימות, מנהל המערכת יכול להגביל יעדים חיצוניים באמצעות רשימת דומיינים וכתובות URL מותרותאם השלב קיים אך אינך מצליח להתחבר לנקודת קצה ספציפית, ודא שהדומיין או כתובת האתר שלך נמצאים ברשימה זו. הגדרה זו מנוהלת מאפשרויות הייבוא ​​והאחזור של כתובות האתר של Drive ו-Docs.

הגבלה זו זה לא עובד אותו דבר בכל המהדורותרשימת ההיתרים של webhooks זמינה במהדורות כגון Business Plus, Enterprise Standard ו-Plus, ו-Education Standard ו-Plus. במהדורות שאינן מציעות שליטה זו, הפעלת webhooks מאפשרת חיבורים לכתובות URL תקפות מבלי להחיל רשימת היתרים זו. לכן, מומלץ לבדוק תחילה את המהדורה שלכם ואת מדיניות הארגון שלכם.

ייתכן שהזרימה מחכה גם ל- אישור המשתמשגוגל מתייחסת לשליחת נתונים לנקודת קצה חיצונית כפעולה רגישה ודורשת בדיקה ואישור כברירת מחדל. אם נראה שהאוטומציה תקועה, פתחו את Studio ובדקו אם יש בקשות אישור ממתינות לפני שתסיקו שהשרת נכשל.

הגדר את כתובת ה-URL, השיטה והנתונים שנשלחו בצורה נכונה.

פתחו את הזרימה פנימה studio.workspace.google.com וסמנו את השלב "שלח וובהוק". הכתובת צריכה להיות שלם וסטטיהשדה מקבל כתובת URL שמתחילה ב- http:// o https://אבל זה לא מאפשר הוספת משתנים לתוך כתובת האתר עצמה. HTTPS היא האפשרות המומלצת כדי להימנע משליחת מידע לא מוצפן; זו אינה דרישה של השדה.

• שיטת HTTP: בחר את האפשרות הצפויה על ידי ה-API של היעד. Studio מציע GET, POST, PUT, PATCH ו-DELETE; POST הוא ברירת המחדל.
• גוף הבקשה: זהו אופציונלי ונשלח כטקסט. עבור ממשקי API רבים, מומלץ להשתמש ב-JSON, תוך התחשבות במירכאות, בסוגריים מסולסלים ובשמות השדות הנדרשים על ידי השירות.
• משתנים: ניתן לכלול נתונים משלבים קודמים בגוף הקובץ. בדוק את התוצאה כאשר משתנה מכיל מרכאות, מעברי שורה או תווים אחרים שעשויים לשבש את פורמט ה-JSON.
• בקשות GET: סטודיו מתעלם מגוף הבקשה עם מתודה זו. אם השירות דורש נתונים בגוף הבקשה, בדוק באיזו מתודה התיעוד שלו תומך.

צור ביצוע בדיקה וזכרו שהשלב ישלח בקשה בפועל ליעד. אם השלב יעבוד, התגובה שלו תהיה זמינה כמשתנה טקסט לשימוש מאוחר יותר באותו זרימה.

השתמש בכרטיסייה פעילות כדי לאתר את הבעיה

לאחר כל ביצוע, פתחו פְּעִילוּת ב-Workspace Studio. אם הבקשה הצליחה, תוכלו לעיין בנתונים שנשלחו ובתגובה שהתקבלה. אם הבקשה נכשלה, Studio מציג את קוד שגיאה ותגובת כתובת אתר יעדמידע זה מאפשר לנו להבחין בין בעיית תצורה בזרימה לבין דחייה הנגרמת על ידי השירות החיצוני.

Un 400 זה בדרך כלל מצביע על כך שהמקבל אינו מקבל את הבקשה כפי שהיא כתובה; הוא בודק את השיטה ואת גוף הבקשה. במקרה של 401 או 403בדקו את דרישות הגישה של השירות ואת מגבלות הארגון שלכם. 404 זה מבקש ממך לאמת את נתיב נקודת הקצה. אם 429בדוק את מגבלות הבקשות שלך; שגיאות 5xx בדרך כלל הם מצביעים על בעיה בשירות המקבל. התגובה הספציפית מנקודת הקצה שימושית יותר מאשר פירוש המספר בפני עצמו.

מנהלים יכולים גם להתייעץ עם יומני אירועים של Workspace Studio כדי לחקור בקשות webhook. הגישה לנתונים מסוימים, כגון כתובת ה-URL המבוקשת, מוגבלת מכיוון שהם עשויים להכיל מידע רגיש.

אל תבלבלו בין ה-webhook של Studio לבין ה-webhook של צ'אט נכנס של גוגל.

הצעד שלח וובהוק Workspace Studio מבצע בקשה לכתובת URL חיצונית. וובהוק נכנס של גוגל צ'אטלעומת זאת, זוהי כתובת URL שנוצרה בתוך חלל עבור מערכת אחרת לפרסם שם הודעות. אלו אלמנטים נפרדים, למרות שניתן להשתמש בכתובת URL של הצ'אט כיעד עבור זרימת Studio.

אם המטרה שלכם היא לפרסם מודעה בצ'אט של גוגל, תחילה בדקו אם שלב 1 מספיק. פרסום בחלל מ-Studio. אם עליך להשתמש ב-webhook נכנס, עליך ליצור אותו מ- אפליקציות ואינטגרציות של המרחב ולשמור על כתובת ה-URL שלו פרטית, הכוללת מפתח וטוקן. Webhooks אלה משמשים לשליחת הודעות למרחב, אך אינם מאפשרים שיחה עם משתמשים.

צ'אט גוגל מחיל מכסה משותפת על ה-webhooks הנכנסים שלו. בקשה אחת לשנייה ולכל רווחמגבלה זו חלה על צ'אט; זוהי אינה מגבלה כללית עבור שלב "שלח Webhook" ב-Workspace Studio. אם השגיאה מתרחשת בעת פרסום הכרזות רבות ברצף לאותו חלל, יש לבדוק את המכסה הזו יחד עם תגובת הבקשה.

בדוק את מכסות הזרימה אם השגיאות הן לסירוגין.

Workspace Studio מאפשר לך ליצור עד 25 זרימות לכל משתמש, עם מקסימום של 20 צעדים לכל זרימהבנוסף, היא מחילה מגבלה משולבת על מספר הביצועים במהלך כל תקופה של 24 שעות. אם תגיעו למגבלה זו, ביצועים נוספים ייכשלו עד לאיפוס המונה.

כאשר ה-webhook נכשל רק לאחר הפעלות רבות, בדוק פְּעִילוּת בדקו הן את המגבלות של Studio והן את אלו של שירות היעד. חידוד הטריגר - לדוגמה, הגבלתו לשולחים או אירועים ספציפיים - יכול למנוע בקשות מיותרות. אם השגיאה מתרחשת בהפעלה הראשונה, התחילו בבדיקת הרשאות, אישורים ממתינים ותגובת נקודת הקצה.