כדי למנוע מעבר להקשר אחר כשמשתמשים משתפים קישור ב-Google Chat, אפליקציית Chat יכולה לצרף כרטיס להודעה שלהם כדי להציג תצוגה מקדימה של הקישור. הכרטיס הזה מכיל מידע נוסף ומאפשר לאנשים לבצע פעולות ישירות מ-Google Chat.
לדוגמה, נניח שיש מרחב משותף ב-Google Chat שכולל את כל נציגי שירות הלקוחות של חברה מסוימת, וגם אפליקציית Chat בשם Case-y. נציגי התמיכה משתפים לעיתים קרובות קישורים לבקשות תמיכה במרחב המשותף ב-Chat, וכל פעם שהם עושים זאת, הקולגות שלהם צריכים לפתוח את הקישור לבקשה כדי לראות פרטים כמו המשתמש שהוקצה, הסטטוס והנושא. כמו כן, אם מישהו רוצה לקבל בעלות על בקשת תמיכה או לשנות את הסטטוס שלה, הוא צריך לפתוח את הקישור.
התכונה 'תצוגה מקדימה של קישורים' מאפשרת לאפליקציית Chat במרחב המשותף, Case-y, לצרף כרטיס עם פרטי המשתמש שהוקצה לבקשת התמיכה, הסטטוס והנושא שלה בכל פעם שמישהו משתף קישור לבקשת תמיכה. לחצנים בכרטיס מאפשרים לנציגי התמיכה לקבל בעלות על הפנייה ולשנות את הסטטוס ישירות מתוך שיחת הצ'אט.
איך פועלת התצוגה המקדימה של הקישורים
כשמישהו מוסיף קישור להודעה שלו, מופיע צ'יפ שמציין שיכול להיות שהקישור יוצג בתצוגה מקדימה באפליקציית Chat.
אחרי שליחת ההודעה, הקישור נשלח לאפליקציית Chat, שמפעילה את היצירה של הכרטיס ומצרפת אותו להודעה של המשתמש.
לצד הקישור, בכרטיס מוצג מידע נוסף על הקישור, כולל רכיבים אינטראקטיביים כמו לחצנים. אפליקציית Chat יכולה לעדכן את הכרטיס המצורף בתגובה לאינטראקציות של המשתמשים, כמו קליקים על לחצנים.
אם מישהו לא רוצה שמערכת Chat תציג תצוגה מקדימה של הקישור שלו על ידי צירוף כרטיס להודעה, הוא יכול למנוע את הצגת התצוגה המקדימה בלחיצה על
בצ'יפ התצוגה המקדימה. המשתמשים יכולים להסיר את הכרטיס המצורף בכל שלב בלחיצה על הסרת התצוגה המקדימה.דרישות מוקדמות
Node.js
אפליקציית Google Chat שמופעלות בה תכונות אינטראקטיביות. כדי ליצור אפליקציה אינטראקטיבית ל-Chat באמצעות שירות HTTP, תוכלו להיעזר במדריך למתחילים הזה.
Python
אפליקציית Google Chat שמופעלות בה תכונות אינטראקטיביות. כדי ליצור אפליקציה אינטראקטיבית ל-Chat באמצעות שירות HTTP, תוכלו להיעזר במדריך למתחילים הזה.
Java
אפליקציית Google Chat שמופעלות בה תכונות אינטראקטיביות. כדי ליצור אפליקציה אינטראקטיבית ל-Chat באמצעות שירות HTTP, תוכלו להיעזר במדריך למתחילים הזה.
Apps Script
אפליקציית Google Chat שמופעלות בה תכונות אינטראקטיביות. כדי ליצור אפליקציה אינטראקטיבית ל-Chat ב-Apps Script, תוכלו להיעזר במדריך למתחילים.
הגדרת תצוגות מקדימות של קישורים
כדי שתוכלו לראות תצוגה מקדימה של קישורים ספציפיים – כמו example.com
, support.example.com
ו-support.example.com/cases/
– באפליקציית Chat, צריך לרשום אותם כתבניות של כתובות URL בדף ההגדרות של אפליקציית Chat במסוף Google Cloud.
- פותחים את מסוף Google Cloud.
- לצד 'Google Cloud', לוחצים על החץ למטה ופותחים את הפרויקט של אפליקציית Chat.
- בשדה החיפוש, מקלידים
Google Chat API
ולוחצים על Google Chat API. - לוחצים על ניהול > הגדרה.
- בקטע 'תצוגה מקדימה של קישורים', מוסיפים או עורכים תבנית של כתובת URL.
- כדי להגדיר תצוגות מקדימות של קישורים לתבנית חדשה של כתובת URL, לוחצים על הוספת תבנית של כתובת URL.
- כדי לערוך את ההגדרה של תבנית כתובת URL קיימת, לוחצים על החץ למטה .
בשדה Host pattern (תבנית מארח), מזינים את הדומיין של תבנית ה-URL. אפליקציית Chat תציג תצוגה מקדימה של קישורים לדומיין הזה.
כדי שאפשר יהיה לראות תצוגה מקדימה של קישורים בתת-דומיין ספציפי באפליקציית Chat, כמו
subdomain.example.com
, צריך לכלול את תת-הדומיין.כדי שאפשר יהיה לראות תצוגה מקדימה של קישורים לדומיין כולו באפליקציית Chat, צריך לציין תו כללי לחיפוש עם כוכב (*) בתור תת-הדומיין. לדוגמה, הערך
*.example.com
תואם ל-subdomain.example.com
ול-any.number.of.subdomains.example.com
.בשדה Path prefix, מזינים נתיב להוספה לדומיין של תבנית המארח.
כדי להתאים לכל כתובות ה-URL בדומיין של תבנית המארח, משאירים את השדה Path prefix (תחילית הנתיב) ריק.
לדוגמה, אם דפוס המארח הוא
support.example.com
, כדי להתאים כתובות URL לבקשות תמיכה שמתארחות ב-support.example.com/cases/
, מזיניםcases/
.לוחצים על סיום.
לוחצים על שמירה.
מעכשיו, בכל פעם שמישהו יכלול בהודעה במרחב משותף ב-Chat קישור שתואם לדפוס של כתובת URL לתצוגה מקדימה של קישור, האפליקציה שלכם תציג תצוגה מקדימה של הקישור.
הצגת תצוגה מקדימה של קישור
אחרי שמגדירים תצוגה מקדימה של קישור מסוים, אפליקציית Chat יכולה לזהות את הקישור ולהציג תצוגה מקדימה שלו על ידי צירוף מידע נוסף אליו.
במרחבים משותפים ב-Chat שכוללים את אפליקציית Chat, כשהודעה של משתמש מכילה קישור שתואם לדפוס של כתובת URL של תצוגה מקדימה של קישור, אפליקציית Chat מקבלת אירוע אינטראקציה מסוג MESSAGE
. עומס העבודה (payload) של ה-JSON באירוע האינטראקציה מכיל את השדה matchedUrl
:
JSON
message: {
matchedUrl: {
url: "https://support.example.com/cases/case123"
},
... // other message attributes redacted
}
על ידי בדיקה של נוכחות השדה matchedUrl
בתוכן של האירוע MESSAGE
, אפליקציית Chat יכולה להוסיף מידע להודעה עם הקישור שמוצג בתצוגה המקדימה. אפליקציית Chat יכולה לענות בהודעת טקסט בסיסית או לצרף כרטיס.
מענה בהודעת טקסט
בתשובות בסיסיות, אפשר להציג תצוגה מקדימה של קישור באפליקציית Chat על ידי שליחת הודעת טקסט פשוטה אל הקישור. בדוגמה הזו מצורפת הודעה שמציגה שוב את כתובת ה-URL של הקישור שתואמת לתבנית של כתובת URL של תצוגה מקדימה של קישור.
Node.js
Python
Java
Apps Script
צירוף כרטיס עם תצוגה מקדימה של הקישור
כדי לצרף כרטיס לקישור שמוצג בתצוגה מקדימה, צריך להחזיר ActionResponse
מסוג UPDATE_USER_MESSAGE_CARDS
. בדוגמה הזו מצורף כרטיס בסיסי.
Node.js
Python
Java
Apps Script
בדוגמה הזו, ההודעה על הכרטיס נשלחת על ידי החזרת card JSON. אפשר גם להשתמש בשירות הכרטיסים של Apps Script.
עדכון כרטיס תצוגה מקדימה של קישור
אפליקציית Chat יכולה לעדכן כרטיס של תצוגה מקדימה של קישור כשמשתמשים יוצרים איתו אינטראקציה, למשל לוחצים על לחצן בכרטיס.
כדי לעדכן את הכרטיס, אפליקציית Chat צריכה לטפל באירוע האינטראקציה CARD_CLICKED
ולהחזיר את הערך actionResponse
בהתאם למי ששלח את ההודעה שמכילה את התצוגה המקדימה של הקישור:
- אם משתמש שלח את ההודעה, מגדירים את הערך של
actionResponse.type
ל-UPDATE_USER_MESSAGE_CARDS
. - אם ההודעה נשלחה מאפליקציית Chat, מגדירים את הערך של
actionResponse.type
בתורUPDATE_MESSAGE
.
כדי לקבוע מי שלח את ההודעה, אפשר להשתמש בשדה message.sender.type
של אירוע האינטראקציה כדי לראות אם השולח היה משתמש HUMAN
או BOT
.
בדוגמה הבאה מוסבר איך אפליקציית Chat מעדכנת את התצוגה המקדימה של הקישור בכל פעם שמשתמש לוחץ על הלחצן הקצאה אליי, על ידי עדכון השדה הקצאה בכרטיס והשבתה של הלחצן.
Node.js
Python
Java
Apps Script
בדוגמה הזו, ההודעה על הכרטיס נשלחת על ידי החזרת card JSON. אפשר גם להשתמש בשירות הכרטיסים של Apps Script.
מגבלות ושיקולים
כשמגדירים תצוגות מקדימות של קישורים באפליקציית Chat, חשוב לשים לב למגבלות ולשיקולים הבאים:
- בכל אפליקציית Chat יש תמיכה בתצוגות מקדימות של קישורים עד 5 דפוסי כתובות URL.
- באפליקציות Chat מוצגת תצוגה מקדימה של קישור אחד בכל הודעה. אם יש כמה קישורים שאפשר להציג תצוגה מקדימה שלהם בהודעה אחת, רק הקישור הראשון שאפשר להציג תצוגה מקדימה שלו יוצג.
- אפליקציות צ'אט מציגות תצוגה מקדימה רק של קישורים שמתחילים ב-
https://
, כך ש-https://support.example.com/cases/
מציגה תצוגה מקדימה אבלsupport.example.com/cases/
לא. - אלא אם ההודעה כוללת מידע נוסף שנשלח לאפליקציית Chat, כמו פקודת קו נטוי, רק כתובת ה-URL של הקישור נשלחת לאפליקציית Chat באמצעות תצוגות מקדימות של קישורים.
- אם משתמש מפרסם את הקישור, אפליקציית Chat יכולה לעדכן את הכרטיס עם התצוגה המקדימה של הקישור רק אם המשתמשים יוצרים אינטראקציה עם הכרטיס, למשל לוחצים על לחצן. אי אפשר להפעיל את השיטה
update()
של Chat API במשאבMessage
כדי לעדכן הודעה של משתמש באופן אסינכרוני. - אפליקציות צ'אט צריכות להציג תצוגה מקדימה של קישורים לכל המשתתפים במרחב המשותף, ולכן אסור לכלול את השדה
privateMessageViewer
בהודעה.
ניפוי באגים בתצוגות מקדימות של קישורים
כשאתם מטמיעים תצוגה מקדימה של קישורים, יכול להיות שתצטרכו לנפות באגים באפליקציית Chat על ידי קריאת היומנים של האפליקציה. כדי לקרוא את היומנים, אפשר להיכנס לדף Logs Explorer במסוף Google Cloud.