בקטע הזה מתוארות בעיות נפוצות שאפשר להיתקל בהן במהלך הפיתוח והבדיקה של אפליקציות ל-Chat.
כרטיס, הודעה, תיבת דו-שיח או תצוגה מקדימה של קישור לא מוצגים או לא פועלים כמצופה
לקבלת עזרה בפתרון בעיות בכרטיסים, אפשר לעיין במאמר פתרון בעיות בכרטיסים.
האפליקציה לא מגיבה
אם שולחים הודעה לאפליקציית Chat והתשובה היא 'האפליקציה לא מגיבה' צריך לבדוק את ההגדרה של אפליקציית Chat:
במסוף Google Cloud, לוחצים על תפריט > מוצרים נוספים > Google Workspace > ספריית מוצרים > Google Chat API > ניהול > הגדרה.
בקטע סטטוס האפליקציה, מוודאים שבחרתם באפשרות פעילה – זמינה למשתמשים.
בקטע תכונות אינטראקטיביות, מוודאים שההגדרות מתאימות לפונקציונליות של האפליקציה. אם אפליקציית Chat מקיימת אינטראקציה עם משתמשים, צריך להפעיל את ההגדרה הפעלת תכונות אינטראקטיביות:
- כברירת מחדל, אפליקציות יכולות להשיב להודעות ישירות ממשתמשים.
- אם האפליקציה מגיבה להודעות במרחבים ובצ'אטים קבוצתיים, בוחרים באפשרות הצטרפות למרחבים ולשיחות קבוצתיות.
- בקטע הגדרות חיבור, מוודאים שכתובת ה-URL של נקודת הקצה (endpoint) של HTTP, מזהה הפריסה של פרויקט Apps Script, שם הנושא של Cloud Pub/Sub או סוכן Dialogflow מוגדרים בצורה נכונה ושהם נפרסו.
- בקטע חשיפה, מוודאים שלמשתמשים המתאימים יש גישה לאפליקציה באמצעות כתובת אימייל או קבוצה בדומיין של Google Workspace. אם האפליקציה נפרסה באמצעות Google Workspace Marketplace SDK, אין צורך בהגדרות של הרשאות גישה כי ההגדרות של Google Workspace Marketplace קודמות להן.
אם האפליקציה פורסמה באמצעות Google Workspace Marketplace SDK, כדאי לבדוק את ההגדרות של Google Workspace Marketplace.
לוחצים על שמירה.
אפשר לנסות לשלוח שוב הודעה לאפליקציה.
ממשק Google Chat API זמין רק למשתמשי Google Workspace
יכול להיות שתקבלו את השגיאה Google Chat API is only available to Google Workspace users כשאתם מגדירים את אפליקציית Chat. ההודעה הזו מציינת שחשבון Google שבו השתמשתם כדי להגדיר את Chat API לא שייך לארגון ב-Google Workspace. כדי לבנות אפליקציה ל-Chat או להשתמש ב-Chat API, צריך להשתמש בחשבון Google Workspace.
שימו לב: משתמשי Google Chat יכולים להשתמש באפליקציות ל-Chat גם אם אין להם חשבון Google Workspace. מידע נוסף על האופן שבו משתמשים מגלים ומתקינים אפליקציות ל-Chat זמין במאמר פיתוח אפליקציות אינטראקטיביות ל-Google Chat.
אפשר להוציא משתמשים ממרחבים
אם אדמין ב-Google Workspace לא מאפשר למשתמשים להפעיל או להשבית את היסטוריית הצ'אטים, יכול להיות שיהיו מקרים שבהם משתמשים לא יוכלו להצטרף למרחב או להישאר בו בגלל סתירה בין הגדרה ברמת המשתמש שמכריחה את היסטוריית הצ'אטים להיות מופעלת או מושבתת לבין מרחב שמקבל בירושה את ההגדרה שנכפית ברמת הארגון.
לדוגמה, אם הגדרת ההיסטוריה של משתמש ב-Chat היא 'מופעלת' וההגדרה של המרחב היא 'מושבתת', יכול להיות שהמשתמש לא יוכל להצטרף למרחב. בנוסף, יכול להיות שהמשתמש יוסר מהמרחב אם הוא הצטרף לפני שהתגלה הקונפליקט ואז פרסם הודעה במרחב אחרי שהתגלה הקונפליקט.
בתרחיש הזה, ובתרחישים אחרים שבהם יש סתירות בין הגדרות ההיסטוריה, יכול להיות שלא תהיה אפשרות ליצור חברות באמצעות Chat API, או שיצירת הודעה עם אימות משתמש תגרום להסרת המשתמש המאומת מהמרחב אם הגדרת ההיסטוריה שלו ב-Chat סותרת את הגדרת ההיסטוריה של המרחב.
מידע נוסף זמין במאמר אפשר להחריג משתמשים מחללים במרכז העזרה של Google Workspace לאדמינים.
פתרון בעיות בשירות המתקדם של Chat ב-Google Apps Script
מידע נוסף זמין בדף בנושא Apps Script על שירות Chat מתקדם.
משתמשים לא יכולים להוסיף אפליקציה ל-Chat למרחב
אם המשתמשים נתקלים בהודעת השגיאה
This organization's administrator must allow users to install this Chat app
בניסיון להוסיף אפליקציית Chat למרחב, יכול להיות שהשגיאה הזו נגרמת מאחת מהסיבות הבאות:
- הארגון השבית את אפליקציות Chat.
- הארגון לא הוסיף את אפליקציית Chat הספציפית הזו לרשימת ההיתרים של הארגון.
אם משתמש נתקל בהודעת השגיאה הזו כשהוא מנסה ליצור אינטראקציה עם אפליקציית Chat, יכול להיות שהסיבה לכך היא שהארגון העניק גישה ליחידה ארגונית משנית, בלי להפעיל אותה ביחידה הארגונית הראשית.
מידע על פתרון הבעיה זמין במאמר בנושא הרשאת התקנה של אפליקציות ל-Chat למשתמשים.
האדמין צריך להעניק לאפליקציה את היקף ההרשאות הנדרש של OAuth כדי לבצע את הפעולה הזו
כשמבצעים אימות כאפליקציית Chat, יכול להיות שתופיע השגיאה הבאה:
<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">
הודעת השגיאה הזו מציינת שאדמין ב-Google Workspace עדיין לא העניק אישור חד-פעמי לאפליקציית Chat להשתמש בהיקפי הרשאות שמתחילים בשם https://www.googleapis.com/auth/chat.app.*.
כדי לפתור את השגיאה:
- צריך לבקש מהאדמין ב-Google Workspace לאשר את אפליקציית Chat.
כשמטפלים בשגיאה הזו בלוגיקה של אפליקציית Chat, כדאי לשלוח הודעה שמודיעה שאפליקציית Chat צריכה אישור אדמין כדי לבצע את הפעולה המבוקשת, למשל:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - אם שיטת Chat API תומכת בהיקף ההרשאות
https://www.googleapis.com/auth/chat.botשלא דורש אישור אדמין, כדאי להשתמש בה במקום זאת. כדי לבדוק אילו היקפי הרשאות נתמכים על ידי method, אפשר לעיין במאמר אימות והרשאה של אפליקציות ל-Google Chat ובקשות ל-Google Chat API.
פתרון בעיות בפונקציות Cloud
אם אפליקציית Chat מיושמת באמצעות Cloud Functions והיא לא פועלת, הקטעים הבאים יעזרו לכם לפתור את הבעיה.
בדיקת היומנים של Cloud Functions
קודם כל, כדאי לבדוק אם יש שגיאות ביומנים של Cloud Functions.
במסוף Google Cloud, נכנסים לדף Cloud Functions:
כדי לפתוח את היומנים, מחפשים את פונקציית הענן של אפליקציית Chat ולוחצים על הצגת פעולות > הצגת יומנים.
נפתח Logs Explorer ומופעלת שאילתה שמציגה יומנים של Cloud Functions, כולל שגיאות.
אם המידע שמתועד כברירת מחדל לא מספיק לניפוי באגים באפליקציה, אפשר להוסיף תיעוד נוסף מקוד Cloud Functions. מידע נוסף זמין במאמר בנושא צפייה ביומנים של Cloud Functions וכתיבה שלהם.
בדיקת שגיאות בפונקציה של Cloud Functions
בנוסף ליומנים, יכול להיות ש-Cloud Function ידווח גם על שגיאות שנתקל בהן במהלך ההפעלה.
במסוף Google Cloud, נכנסים לדף Cloud Functions:
לוחצים על הפונקציה של Cloud Functions של אפליקציית Chat.
בדף פרטי הפונקציה, השגיאות מפורטות בקטע שגיאות.
כדי לפתור בעיה ספציפית, לוחצים עליה.
תיקון שגיאות נפוצות ב-Cloud Functions
לפעמים נתקלים בשגיאות הבאות כשיוצרים אפליקציה ל-Chat באמצעות Cloud Functions.
הפונקציה ChatApp באזור REGION_NAME בפרויקט PROJECT_NAME כבר קיימת
כשפורסים פונקציה ב-Cloud Functions, יכול להיות שתופיע השגיאה Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists. ההודעה הזו מציינת שלפונקציה אחרת של Cloud יש שם זהה לשם של הפונקציה שאתם מפעילים. משנים את השם ומפעילים מחדש את הפונקציה. מוודאים שאפליקציית Chat משתמשת בכתובת ה-URL שמשמשת כטריגר של הפונקציה של Cloud Functions, ולא בכתובת ה-URL שמשמשת כטריגר של הפונקציה הקיימת של Cloud Functions.
אחד או יותר מהמשתמשים שצוינו במדיניות לא שייכים ללקוח מורשה
כשפורסים Cloud Function, יכול להיות שתקבלו את השגיאה The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer." אם תקבלו את השגיאה הזו ואז תשלחו הודעה לאפליקציית Chat, תקבלו שגיאה שאומרת שהאפליקציה לא מגיבה כי Google Chat לא יכולה להגיע לשרת שמארח את Cloud Function. ההודעה הזו מציינת שלמשתמש בשם allUsers אין הרשאה להתקשר לפונקציית Cloud.
הקצאת התפקיד Cloud Functions Invoker (הפעלת פונקציות ב-Cloud) ל-allUsers (כל המשתמשים) פירושה שפונקציית Cloud שמפעילה את האפליקציה זמינה לציבור ונגישה ללא אימות. במאמר הקצאת תפקיד יחיד מוסבר איך מקצים תפקיד.
יכול להיות שהשגיאה הזו מציינת שהפרויקט ב-Google Cloud מוגבל לדומיין. מידע נוסף על אילוצים של הגבלת דומיין זמין במאמר הגבלת זהויות לפי דומיין.
כדי לפתור את הבעיה, צריך לוודא שפונקציית Cloud מאפשרת הפעלות לא מאומתות. במאמר מתן גישה ציבורית (לא מאומתת) מוסבר איך לאפשר הפעלות לא מאומתות של Cloud Function קיים.