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

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

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

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

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

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

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

    כניסה ל-Chat API

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

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

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

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

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

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

Google Chat API זמין רק למשתמשי Google Workspace

כשמגדירים את אפליקציית Chat, יכול להיות שתקבלו את השגיאה Google Chat API is only available to Google Workspace users. המשמעות של ההודעה הזו היא שחשבון Google שבו השתמשתם כדי להגדיר את Chat API לא שייך לארגון ב-Google Workspace. כדי ליצור אפליקציה ל-Chat או להשתמש ב-Chat API, צריך להשתמש בחשבון Google Workspace.

שימו לב שמשתמשי Google Chat יכולים להשתמש באפליקציות צ'אט גם בלי חשבון Google Workspace. למידע נוסף על האופן שבו משתמשים מחפשים ומתקינים אפליקציות צ'אט, ראו פרסום אפליקציות של Google Chat.

אפשר להחריג משתמשים ממרחבים משותפים

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

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

בתרחיש הזה ובתרחישים אחרים שבהם יש התנגשויות בין הגדרות ההיסטוריה, יכול להיות ש-Chat API לא יוכל ליצור מינוי או ליצור הודעה עם אימות משתמש, כדי להסיר מהמרחב המשותף את המשתמש המאומת עם הגדרת היסטוריית הצ'אט מתנגשת.

מידע נוסף זמין במאמר אי אפשר להחריג משתמשים ממרחבים משותפים במרכז העזרה לאדמינים של Google Workspace.

פתרון בעיות בשירות הצ'אט המתקדם ב-Google Apps Script

ראו את הדף של Apps Script לגבי שירות צ'אט מתקדם.

המשתמשים לא יכולים להוסיף אפליקציות של Chat למרחבים משותפים

אם משתמשים מקבלים את הודעת השגיאה This organization's administrator must allow users to install this Chat app כשמנסים להוסיף אפליקציית Chat למרחב משותף, יכול להיות שהשגיאה הזאת נובעת מאחת מהסיבות הבאות:

  • בארגון לא משתמשים באפליקציות ל-Chat.
  • הארגון לא הוסיף את אפליקציית Chat הספציפית הזו לרשימת ההיתרים של הארגון.

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

במאמר אישור למשתמשים להתקין אפליקציות ל-Chat מוסבר איך פותרים את הבעיה הזו.

פתרון שגיאות של פונקציות של Cloud Functions

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

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

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

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

    כניסה לדף Cloud Functions

  2. כדי לפתוח את היומנים, מאתרים את הפונקציה ב-Cloud Functions של אפליקציית Chat ולוחצים על Show actions > View logs.

Logs Explorer פותח ומריץ שאילתה שבה מוצגים יומני פונקציות של Cloud Functions, כולל שגיאות.

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

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

מלבד היומנים, הפונקציה של Cloud Functions עשויה גם לדווח על שגיאות שהתרחשו בזמן הריצה.

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

    כניסה לדף Cloud Functions

  2. לוחצים על הפונקציה של Cloud Functions באפליקציית 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 Functions יש שם זהה לזה שאתם פורסים. משנים את השם ופורסים את הפונקציה שוב. ודאו שאפליקציית Chat משתמשת ב-Trigger URL של הפונקציה ב-Cloud Functions, ולא ב-Trigger URL של הפונקציה הקיימת ב-Cloud Functions.

אחד או יותר מהמשתמשים שמצוינים במדיניות לא שייכים ללקוח מורשה

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

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

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