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

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

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

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

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

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

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

    כניסה ל-Chat API

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

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

    1. אם האפליקציה שלכם מגיבה להודעות, עליכם לבחור באפשרות קבלת הודעות 1: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 לאדמינים.

פתרון בעיות בשירות Advanced Chat ב-Google Apps Script

אפשר לעיין בדף Apps Script כדי שירות Chat מתקדם.

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

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

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

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

לקבלת מידע על דרכים לפתרון הבעיה, ראה המשתמשים יכולים להתקין אפליקציות צ'אט.

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

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

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

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

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

    כניסה ל-Cloud Functions

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

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

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

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

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

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

    כניסה ל-Cloud Functions

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

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

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

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

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