פתרון בעיות ותיקון שגיאות באפליקציית Google Chat

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

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

לקבלת עזרה בפתרון בעיות בכרטיסים, אפשר לעיין במאמר פתרון בעיות בכרטיסים.

האפליקציה לא מגיבה

אם שולחים הודעה לאפליקציית Chat והתשובה היא 'האפליקציה לא מגיבה', צריך לוודא שההגדרה של אפליקציית Chat נכונה:

  1. במסוף Google Cloud, לוחצים על תפריט > הצגת כל המוצרים > מוצרי Google אחרים > Google Workspace > ספריית מוצרים > Google Chat API > ניהול > הגדרה.

    ל-Chat API

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

  3. בקטע תכונות אינטראקטיביות, מוודאים שההגדרות מתאימות לפונקציונליות של האפליקציה. אם אפליקציית Chat שלכם יוצרת אינטראקציה עם משתמשים, הקפידו להפעיל את ההגדרה הפעלה של תכונות אינטראקטיביות:

    1. כברירת מחדל, אפליקציות יכולות להשיב לצ'אטים ישירים ממשתמשים.
    2. אם האפליקציה שלכם מגיבה להודעות במרחבים ובצ'אטים קבוצתיים, בוחרים באפשרות הצטרפות למרחבים ולשיחות קבוצתיות.
    3. בקטע הגדרות חיבור, מוודאים שכתובת ה-URL של נקודת הקצה (endpoint) של HTTP, מזהה הפריסה של פרויקט Apps Script, שם הנושא ב-Cloud Pub/Sub או סוכן Dialogflow מוגדרים בצורה נכונה ושהם נפרסו.
    4. בקטע חשיפה, מוודאים שלמשתמשים המתאימים יש גישה לאפליקציה באמצעות כתובת אימייל או קבוצה בדומיין Google Workspace. אם האפליקציה נפרסה באמצעות Google Workspace Marketplace SDK, אין צורך בהגדרות של הרשאות גישה כי ההגדרות של Google Workspace Marketplace קודמות להן.

  4. אם האפליקציה פורסמה באמצעות Google Workspace Marketplace SDK, צריך לבדוק את ההגדרות של Google Workspace Marketplace.

  5. לוחצים על שמירה.

  6. מנסים לשלוח שוב הודעה לאפליקציה.

ממשק 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 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 עדיין לא אישר את השימוש בהיקפי ההרשאות שמתחילים בשם https://www.googleapis.com/auth/chat.app.* באפליקציית Chat.

כדי לפתור את השגיאה:

  • צריך לבקש מהאדמין ב-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 Functions

אם אפליקציית Chat מיושמת באמצעות Cloud Functions והיא לא פועלת, הקטעים הבאים יעזרו לכם לפתור את הבעיה.

בדיקת היומנים של Cloud Functions

קודם כל, בודקים אם יש שגיאות ביומנים של Cloud Functions.

  1. במסוף Google Cloud, נכנסים לדף Cloud Functions:

    כניסה לדף Cloud Functions

  2. כדי לפתוח את היומנים, מחפשים את פונקציית הענן של אפליקציית Chat ולוחצים על הצגת פעולות > הצגת יומנים.

נפתח Logs Explorer ומופעלת שאילתה שמציגה יומנים של Cloud Function, כולל שגיאות.

אם המידע שמתועד כברירת מחדל לא מספיק לניפוי באגים באפליקציה, אפשר להוסיף תיעוד נוסף מקוד Cloud Functions. איך צופים ביומנים של Cloud Functions וכותבים בהם

בדיקת שגיאות בפונקציה של Cloud Functions

בנוסף ליומנים, יכול להיות ש-Cloud Function ידווח גם על שגיאות שנתקל בהן במהלך ההפעלה.

  1. במסוף Google Cloud, נכנסים לדף Cloud Functions:

    כניסה לדף Cloud Functions

  2. לוחצים על פונקציית Cloud של אפליקציית Chat.

  3. בדף פרטי הפונקציה, השגיאות מפורטות בקטע שגיאות.

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

פתרון בעיות נפוצות ב-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 Function. הקצאת התפקיד Cloud Functions Invoker (הפעלת פונקציות ב-Cloud) ל-allUsers (כל המשתמשים) פירושה שפונקציית Cloud Functions שמפעילה את האפליקציה זמינה לציבור וניתן לגשת אליה ללא אימות. במאמר הקצאת תפקיד יחיד מוסבר איך מקצים תפקידים.

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

כדי לפתור את הבעיה, צריך לוודא שפונקציית Cloud מאפשרת הפעלות לא מאומתות. במאמר מתן גישה ציבורית (לא מאומתת) מוסבר איך לאפשר הפעלות לא מאומתות של Cloud Function קיים.