פיתוח אפליקציה אינטראקטיבית ל-Google Chat

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

אפליקציות אינטראקטיביות ל-Chat מאפשרות למשתמשים לבצע את הפעולות הבאות:

איך המשתמשים מגלים אפליקציות אינטראקטיביות ל-Chat ומשתמשים בהן

ב-Chat, תוספים שמרחיבים את Chat מופיעים למשתמשים כאפליקציות ל-Google Chat. יש למשתמשים הרבה דרכים למצוא ולהשתמש באפליקציות ל-Chat שפורסמו ב-Marketplace, למשל:

  • לחפש ולהתקין אפליקציות ל-Chat מ-Google Chat או מ-Marketplace.
  • איך משתמשים באפליקציה ל-Chat שנוספה למרחב ב-Chat.
  • המשתמשים יכולים לראות את אפליקציית Chat בחלונית הצ'אטים הישירים שלהם אחרי שאדמין ב-Google Workspace מתקין את אפליקציית Chat בשמם.

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

בדוגמה הבאה אפשר לראות איך משתמש מתייג אפליקציית Chat כדי להוסיף אותה למרחב:

הוספת אפליקציה ל-Chat למרחב על ידי הקלדת @ בהודעה.

שנתחיל?

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

הגדרה ויצירה של אפליקציית צ'אט בסיסית

בטבלה הבאה מפורטים מאמרי העזרה להגדרת Chat API וליצירת אפליקציית צ'אט אינטראקטיבית בסיסית לכל ארכיטקטורה של אפליקציית Google Chat:

ארכיטקטורה או משימה הדרכות
הגדרת Chat API הגדרת Google Chat API
Quickstarts
Apps Script פיתוח אפליקציה ל-Chat באמצעות Apps Script
שירות HTTP (פונקציות Cloud Run) פיתוח אפליקציה ל-Chat עם HTTP
Pub/Sub פיתוח אפליקציה ל-Chat באמצעות Pub/Sub
Dialogflow CX פיתוח אפליקציה ל-Chat באמצעות Dialogflow CX
Dialogflow ES פיתוח אפליקציה ל-Chat ב-Dialogflow ES
סוכן AI של ערכת פיתוח סוכנים (ADK) פיתוח אפליקציה ל-Chat עם סוכן AI של ADK
סוכן AI מסוג Agent2Agent ‏ (A2A) פיתוח אפליקציית צ'אט עם סוכן AI מסוג A2A
סוכן AI של A2UI פיתוח אפליקציה ל-Chat עם סוכן AI עם ממשק משתמש מבוסס-פעולות
סוכן AI של Gemini Enterprise פיתוח אפליקציית צ'אט עם סוכן AI של Gemini Enterprise

יצירת תכונות אינטראקטיביות

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

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

מגבלות ושיקולים לגבי תוספים ל-Google Workspace

אפליקציות ל-Chat מבוססות על תוספים ל-Google Workspace שמרחיבים את Chat, ולכן חשוב לזכור את המגבלות הבאות:

  • ארכיטקטורת אפליקציית Chat של AppSheet לא זמינה כשמפתחים אותה כתוסף ל-Google Workspace. במקום זאת, אפשר ליצור את אפליקציית הצ'אט באמצעות שירות HTTP,‏ Apps Script,‏ Dialogflow ES,‏ Dialogflow CX או Pub/Sub.
  • אין תמיכה בכרטיסי הרשאה מותאמים אישית ב-Chat. כדי לאמת את השירות שלכם ולתת לו הרשאה מ-Chat, אפליקציית Chat צריכה להחזיר כרטיס הרשאה בסיסי.
  • אין תמיכה בדפי הבית של תוספים בסרגל הצד של Chat. אם הגדרתם טריגר לדף הבית במניפסט (addons.common.homepageTrigger), דף הבית יופיע רק בסרגל הצד של אפליקציות אחרות של Google Workspace שהתוסף מרחיב. במקום זאת, אתם יכולים ליצור דף בית לאפליקציית Chat שמופיע בכרטיסייה דף הבית בצ'אטים ישירים עם אפליקציית Chat.

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

  • הגדרות ההתקנה של Google Workspace Marketplace צריכות לאפשר גם לאנשים פרטיים וגם לאדמינים ב-Google Workspace להתקין את התוסף.
  • המערכת מתעלמת ב-Chat מכל הגדרות התצורה הנפוצות במניפסט של התוסף (addons.common). כדי להגדיר את התוסף כך שיפעל ב-Chat, צריך להפעיל ולהגדיר את Chat API. הוראות מפורטות זמינות במאמר בנושא הגדרת Google Chat API.
  • כדי לפרוס תוסף ב-Chat ולבדוק אותו, צריך להשתמש בהגדרת החשיפה של Chat API. הגדרות הנראות או הבדיקה שהגדרתם ב-Google Workspace Marketplace SDK לא יחולו. כדי לפרוס גרסת בדיקה של התוסף ב-Chat, אפשר לעיין במאמר בדיקת תכונות אינטראקטיביות באפליקציות ל-Google Chat.
  • אם התוסף שלכם פורסם ב-Google Workspace Marketplace, לא תוכלו לשמור טיוטה של שינויים בהגדרות התצורה של Google Chat API. כשמעדכנים את הגדרות התצורה של Chat API, אפליקציית Chat המעודכנת זמינה באופן מיידי לכל המשתמשים הקיימים. כדי לעדכן את כרטיס המוצר ב-Marketplace, אפשר ליצור טיוטה לפני ששולחים שינויים.

אפליקציות ל-Chat שהן לא תוספים: יצירת אפליקציה אינטראקטיבית ל-Google Chat

אפליקציות ל-Chat שלא מבוססות על Google Workspace Add-ons API הן אפליקציות ל-Chat בלבד שמקבלות אירועי אינטראקציה עם Chat API ‏ (Event) במקום אובייקטים של אירועים ופעולות של Google Workspace Add-ons API ‏ (EventObject).

אם אתם מנהלים אפליקציית Chat שהיא לא תוסף, אתם יכולים:

  • להמיר אפליקציית Chat שלא מוגדרת כתוסף לתוסף Google Workspace שמרחיב את Google Chat. איך ממירים אפליקציה ל-Google Chat לתוסף ל-Google Workspace
  • בקטעים שניתן להרחיב Chat apps that aren't add-ons בחלק התחתון של כל מדריך לתכונה אינטראקטיבית בסדרת המסמכים הזו, מפורטים הפורמטים של הבקשות והתשובות.