התאמות אישיות של 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 אופציונלי אירוע בהתאמה אישית שיופעל כשתיבת הדו-שיח של הצ'אט תיפתח. אפשר להשתמש בגורם מטפל באירועים שיופעל עבור האירוע הזה ויפיק את ההודעה הראשונה של הנציג.
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 אופציונלי הגדרת הרוחב של חלון הצ'אט. ערכים מספריים (בפיקסלים). ברירת המחדל היא 320px.
chat-height אופציונלי הגדרת הגובה של חלון הצ'אט. ערכים מספריים (בפיקסלים). ברירת המחדל היא 480px.
allow-fullscreen אופציונלי הגדרה שקובעת אם חלון הצ'אט יכול להיפתח במסך מלא. אם ההגדרה היא always, האפליקציה תיפתח במסך מלא בכל גדלי המסך. אם הערך מוגדר ל-small, החלון ייפתח במסך מלא אם גודל המסך קטן מ-500px, אחרת הוא ייפתח כחלון רגיל. אם ההגדרה מוגדרת, היא עשויה לבטל את ההגדרות chat-width, chat-height ו-anchor.
minimized אופציונלי קובע אם הצ'אט פתוח בהתחלה בצורה ממוזערת. הלוגיקה זהה לזו של anchor. אם מציינים את intent הראשוני, הוא יופעל בזמן הטעינה.