התאמות אישיות של HTML ב-Dialogflow CX Messenger

אפשר להחיל הרבה התאמות אישיות של HTML על תיבת דו-שיח של צ'אט.

אפשרויות של רכיב הצ'אט ב-HTML

הרכיב הצאצא של הרכיב df-messenger יכול להיות אחד מהבאים:

  • ‫df-messenger-chat: תיבת הדו-שיח של הסוכן תמיד פתוחה.
  • ‫df-messenger-chat-bubble: אפשר לפתוח או לסגור את תיבת הדו-שיח של הנציג באמצעות כפתור בועה לפתיחה או לסגירה.

התאמות אישיות של HTML עבור df-messenger

לרכיב ה-HTML‏ df-messenger יש את המאפיינים הבאים:

מאפיין מדיניות הקלט ערך
agent-id חובה מזהה הסוכן שמשויך לסוכן Dialogflow CX.
allow-feedback אופציונלי מגדירים את הערך all כדי לאפשר למשתמשי הקצה לתת משוב על התשובות של הנציג.
language-code חובה קוד השפה שמוגדר כברירת מחדל.
project-id חובה מזהה הפרויקט של הנציג.
location אופציונלי האזור של הנציג. ערך ברירת המחדל הוא global.
intent אופציונלי אירוע מותאם אישית שמופעל כשתיבת הדו-שיח של הצ'אט נפתחת. אם הצ'אט פתוח בהתחלה (כמו ב-df-messenger-chat או ב-expanded/minimized df-messenger-chat-bubble), האירוע מופעל בטעינת דף. אפשר להשתמש בגורם מטפל באירועים שמופעל באירוע הזה ומפיק את ההודעה הראשונה של הנציג.
oauth-client-id אופציונלי נדרש לאימות OAuth. ברירת המחדל היא null. אם לא תספקו את הערך הזה ותפעילו גישה לא מאומתת ל-Dialogflow CX Messenger, משתמשים לא מאומתים יוכלו לקיים אינטראקציה עם הנציג. אם תספקו את הערך הזה, בתיבת הדו-שיח של הנציג תופיע שכבת-על של "בקשת אימות" שמחייבת את המשתמשים להיכנס לחשבון לפני שהם יכולים להשתמש בנציג (אתם יכולים לשלוט בטקסט באמצעות המאפיין request-auth-text).
storage-option אופציונלי מציין את האחסון המקומי של הודעות בשיחות. אם לא רוצים לשמור את ההודעות, משתמשים ב-none. אם משתמשים ב-none, כל ההודעות נמחקות כשהדף מתרענן או נטען מחדש. ברירת המחדל היא sessionStorage.
session-ttl אופציונלי צריך להגדיר משך זמן בשניות כדי לשמור על הסשן. משך הזמן חייב להיות קצר מ-86,400 (יום אחד). ברירת המחדל היא 1,800 (30 דקות).
url-allowlist אופציונלי מאפשרת לטעון תמונות מרשימה מופרדת בפסיקים של תחיליות של כתובות URL. כתובות URL של תמונות שמופיעות בתשובות בפורמט HTML או Markdown חייבות להתחיל באחת מהתחיליות שברשימה. כדי לאפשר את כל כתובות ה-URL, צריך להשתמש ב-*.
max-query-length אופציונלי מגדיר את האורך המקסימלי של שאילתת טקסט. אם הערך שלילי, האורך לא מוגבל. ברירת המחדל היא 256. מסמכים נוספים.

התאמות אישיות של HTML עבור df-messenger-chat

סרגל הצד של Dialogflow CX Messenger

לרכיב ה-HTML‏ df-messenger-chat יש את המאפיינים הבאים:

מאפיין מדיניות הקלט ערך
chat-title אופציונלי הכותרת של תיבת הצ'אט. הוא מופיע בחלק העליון של תיבת הצ'אט.
chat-subtitle אופציונלי כותרת המשנה של תיבת הצ'אט. מוצג מתחת לchat-title.
chat-title-icon אופציונלי הסמל שמוצג בכותרת של תיבת הצ'אט. מוצג מעל תיבת הצ'אט, משמאל ל-chat-title כברירת מחדל.
bot-writing-text אופציונלי הטקסט שמוצג בזמן שהנציג כותב.
bot-writing-image אופציונלי התמונה שמוצגת בזמן שהנציג כותב. מקבל עדיפות על פני bot-writing-text.
request-auth-text אופציונלי הטקסט של הלחצן במקרה שנדרש אימות.
placeholder-text אופציונלי הטקסט שיוצג בשדה להזנת קלט כשהוא ריק. ברירת המחדל היא "אפשר לשאול משהו…".
bot-actor-image אופציונלי מקור התמונה שישמש לתמונת השחקן של הנציג. מוצג בכל קבוצה של תשובות מהנציג.
user-actor-image אופציונלי מקור התמונה שמשמשת כתמונת השחקן של המשתמש. מוצג בכל הודעה של משתמש.

התאמות אישיות של HTML עבור df-messenger-chat-bubble

בועת הצ'אט של Dialogflow CX Messenger

לרכיב ה-HTML‏ df-messenger-chat-bubble יש את אותם מאפיינים כמו ל-df-messenger-chat, וגם את המאפיינים הנוספים הבאים:

מאפיין מדיניות הקלט ערך
expanded אופציונלי ערך בוליאני שקובע אם הצ'אט פתוח בהתחלה. אם המדיניות לא מוגדרת, הצ'אט זוכר את המצב האחרון שלו.
chat-icon אופציונלי הסמל של בועת הצ'אט. ה-URI צריך להיות זמין לכולם.
chat-close-icon אופציונלי סמל הסגירה של בועת הצ'אט. ה-URI צריך להיות זמין לכולם.
chat-collapse-icon אופציונלי הסמל של כפתור הכיווץ בסרגל הכותרת. ה-URI צריך להיות זמין לכולם.
anchor אופציונלי מגדירה את המיקום של תיבת הדו-שיח של הצ'אט ביחס לבועה הפתוחה או הסגורה. הערך הוא שתי מילים לציון כיוון (top, ‏ bottom, ‏ left, ‏ right) שמופרדות באמצעות -. ערך ברירת המחדל הוא top-left. הכיוון הראשון מגדיר את נקודת העיגון, והכיוון השני מגדיר את כיוון ההרחבה הראשי הרחק מהבועה. לדוגמה: top-left ממוקם מעל הבועה ומתרחב שמאלה ולמעלה (הרחק מהבועה).
chat-width אופציונלי מגדיר את רוחב חלון הצ'אט. ערכים מספריים (בפיקסלים). ברירת המחדל היא 320 פיקסלים.
chat-height אופציונלי מגדיר את הגובה של חלון הצ'אט. ערכים מספריים (בפיקסלים). ברירת המחדל היא 480px.
allow-fullscreen אופציונלי ההגדרה קובעת אם חלון הצ'אט יכול להיפתח במסך מלא. אם הערך הוא always, נפתח במסך מלא בכל גודל מסך. אם הערך הוא small, נפתח במסך מלא במסכים בגודל של פחות מ-500 פיקסלים, אחרת נפתח כחלון רגיל. אם מגדירים את chat-width, chat-height ו-anchor, יכול להיות שהם יבטלו את ההגדרה הזו.
minimized אופציונלי ההגדרה הזו קובעת אם הצ'אט ייפתח בהתחלה בצורה ממוזערת. משתמש באותו היגיון כמו anchor. אם מציינים את המאפיין הזה, הוא מקבל עדיפות על פני expanded. הפעולה הזו גם מפעילה את ה-intent הראשוני בטעינה.