קבלת אינטראקציות עם אפליקציית Google Chat ומענה להן

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

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

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

דוגמה לאירוע אינטראקציה תשובה אופיינית מאפליקציית Chat
משתמש מפעיל אפליקציית Chat על ידי אזכור שלה באמצעות @ או שימוש בפקודה דרך שורת הפקודות. אפליקציית Chat מעבדת את מה שנאמר בהודעה כדי ליצור הודעה. לדוגמה, אפליקציית Chat תענה לפקודה /about עם הודעה עם הסבר על המשימות שאפליקציית Chat יכולה לבצע.
משתמש מוסיף אפליקציה של Chat למרחב משותף. אפליקציית Chat שולחת הודעת הצטרפות שמסבירה מה היא עושה ואיך המשתמשים במרחב המשותף יכולים לתקשר איתה.
משתמש מסיר אפליקציית Chat ממרחב משותף. אפליקציית Chat מסירה את ההתראות הנכנסות שהוגדרו למרחב המשותף (למשל, מחיקת webhook) ומנקה את כל האחסון הפנימי.
משתמש לוחץ על לחצן בכרטיס או בתיבת דו-שיח שנשלחו מאפליקציית Chat. אפליקציית Chat מעבדת ומאחסנת נתונים שהמשתמש שלח, או מחזירה כרטיס או תיבת דו-שיח אחרים.

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

בדף הזה נסביר איך לבצע את הפעולות הבאות:

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

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

בקטע הזה נסביר איך לקבל ולעבד אירועי אינטראקציה באפליקציית Chat.

הגדרה של אפליקציית Chat לקבלת אירועי אינטראקציה

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

אם יצרתם אפליקציית Chat אינטראקטיבית, תצטרכו להגדיר את Google Chat API כך ש-Google Chat יוכל לשלוח לכם אירועי אינטראקציה:

  1. במסוף Google Cloud, פותחים את הדף של Google Chat API:

    לדף Google Chat API

  2. לוחצים על הכרטיסייה Configuration.
  3. בקטע תכונות אינטראקטיביות, לוחצים על המתג הפעלת תכונות אינטראקטיביות למצב 'פעיל'.
  4. בקטע פונקציונליות, מסמנים את אחת מתיבות הסימון הבאות או את שתיהן:
    1. קבלת הודעות אישיות: מאפשרת למשתמשים לתקשר עם אפליקציית Chat במרחבים משותפים של צ'אטים אישיים (DM). אפליקציית Chat מקבלת אירועי אינטראקציה בכל פעם שמשתמש שולח הודעה במרחב המשותף בצ'אטים.
    2. הצטרפות למרחבים משותפים ולשיחות קבוצתיות: מאפשרת למשתמשים להוסיף את אפליקציית Chat שלכם למרחבים משותפים עם יותר מאדם אחד ולהסיר אותה. אפליקציית Chat מקבלת אירועי אינטראקציה בכל פעם שהיא מתווספת או מוסרת מהמרחב המשותף, ובכל פעם שמשתמשים מאזכרים אותם באמצעות @או משתמשים בפקודה דרך שורת הפקודות במרחב המשותף.
  5. בהגדרות החיבור, מציינים לאן יישלחו אירועי אינטראקציה עם אפליקציות מ-Google Chat.
  6. אופציונלי: בפקודות לוכסן, מוסיפים ומגדירים פקודה אחת או יותר של לוכסן. מידע נוסף זמין במאמר הגדרת פקודות דרך שורת הפקודות.
  7. אופציונלי: בתצוגות מקדימות של קישורים, אפשר להוסיף ולהגדיר תבנית URL אחת או יותר שאפליקציית Chat מציגה בתצוגה מקדימה. מידע נוסף זמין במאמר תצוגה מקדימה של קישורים.
  8. לוחצים על שמירה.

אפליקציית Chat מוגדרת לקבל אירועי אינטראקציה מ-Google Chat.

טיפול בניסיונות חוזרים של קריאה ל-HTTP לשירות שלך

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

לעבד אירועי אינטראקציה או להגיב עליהם

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

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

לכל אירוע אינטראקציה, אפליקציות Chat מקבלות גוף בקשה, המטען הייעודי (payload) של JSON שמייצג את האירוע. אפשר להשתמש במידע כדי לעבד תשובה. במאמר סוגים של אירועי אינטראקציה באפליקציות ב-Chat תוכלו לראות דוגמאות למטען ייעודי (payload) של אירועים.

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

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

הצגת התשובות באופן שוטף

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

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

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

תשובה באופן אסינכרוני

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

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