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

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

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

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

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

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

  1. ב-Google API Console, לוחצים על תפריט > APIs & Services > Enabled APIs & Services > Google Chat API > Configuration.

    מעבר להגדרות של Chat API

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

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

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

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

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

ממשק 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, או שיצירת הודעה עם אימות משתמש תגרום להסרת המשתמש המאומת מהמרחב אם הגדרת היסטוריית הצ'אט שלו סותרת את הגדרת ההיסטוריה של המרחב.

מידע נוסף זמין במאמר אפשר להוציא משתמשים ממרחבים במרכז העזרה של 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.

האדמין צריך להעניק לאפליקציה את היקף ההרשאות הנדרש של 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 שלא דורש אישור אדמין, כדאי להשתמש בה במקום זאת. כדי לבדוק אילו היקפי הרשאות נתמכים בשיטה מסוימת, אפשר לעיין במאמר אימות והרשאה של אפליקציות ל-Google Chat ובקשות מ-Google Chat API.

פתרון בעיות בפונקציות של Cloud Functions

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

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

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

  1. במסוף Google API, עוברים לדף Cloud Functions:

    כניסה לדף Cloud Functions

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

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

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

בדיקת שגיאות ב-Cloud Functions

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

  1. במסוף Google API, עוברים לדף 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 משתמשת בכתובת ה-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 Functions מאפשרת הפעלות לא מאומתות. במאמר איך מאפשרים גישה ציבורית (לא מאומתת) מוסבר איך לאפשר הפעלות לא מאומתות של Cloud Function קיים.

אפליקציות ל-Chat שלא מוגדרות כתוספים: פתרון בעיות ושגיאות באפליקציות ל-Google Chat

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

אם אפליקציית Chat שהיא לא תוסף מגיבה בהודעה 'האפליקציה לא מגיבה', צריך לבדוק את ההגדרות הבאות בכרטיסייה Configuration (הגדרה) של Chat API ב-Google API Console:

  • בקטע סטטוס האפליקציה, מוודאים שבחרתם באפשרות פעילה – זמינה למשתמשים.
  • בקטע תכונות אינטראקטיביות > הגדרות חיבור, מוודאים שכתובת ה-URL של נקודת הקצה (endpoint) של HTTP, מזהה הפריסה של Apps Script, שם הנושא של Cloud Pub/Sub או סוכן Dialogflow מוגדרים ונפרסו.