My Website

` הוא נקודת העיגון — לוח הצ'אט מרונדר בתוכו וממלא את ממדיו. עצבו את ה-div כרצונכם (הגדירו לו גובה קבוע, הניחו אותו בתוך קונטיינר flex, מקמו אותו בתא בתוך grid וכו') ולוח הצ'אט יתאים את עצמו. אתם זקוקים רק לתג ` ``` {% endcode %} קטע הקוד המוטבע נושא אותו ב-`

` במקום זאת, כך שדף אחד יכול להכיל מספר צ'אטים המופנים למקומות שונים: {% code overflow="wrap" %} ```html

``` {% endcode %} עבור נציג, הניסוח משתנה ל-`?agent=AGENT_ID` או `data-agent="AGENT_ID"`. כמה דברים שכדאי לדעת: - השתמש בלחצן ההעתקה במקום להקליד את המזהה (ID) ידנית. אם המזהה אינו תואם לקמפיין או לנציג בחשבונך, הצ'אט עדיין יעבוד אך יחזור לניתוב ברירת המחדל שלך. - מי שנמצא באמצע שיחה יישאר עם מי שהתחיל איתו, גם אם יגיע מאוחר יותר לדף שמפנה למקום אחר. זה מונע מהשיחה לשנות את אופייה באמצע. - יעד ספציפי לדף מקבל עדיפות על פני ברירת המחדל של החשבון שלך ועל פני מילות מפתח מפעילות. ### אמרו לווידג'ט מי הוא המבקר (מתקדם) אם אתם מציבים את ווידג'ט הצ'אט בתוך אזור חברים, פורטל לקוחות או אפליקציה שבה אנשים כבר מחוברים, האתר שלכם כבר יודע מי הם. אתם יכולים להעביר את המידע הזה לווידג'ט כדי שלא יבקש מהמבקר פרטים שכבר סיפק לכם, וכדי שה-AI שלכם יוכל להשתמש במה שאתם כבר יודעים עליו. הוסיפו בלוק הגדרות קטן **לפני** הסקריפט של הווידג'ט: {% code overflow="wrap" %} ```html ``` {% endcode %} הדף שלכם אמור למלא את הערכים האלה בצד השרת, מתוך מי שמחובר כרגע. שני דברים קורים: - **טופס ה-"לפני שנתחיל..." מדלג.** עם שם ואימייל שסופקו, המבקר עובר ישירות לשיחה, והפרטים האלה נשמרים באיש הקשר שלו בדיוק כאילו הוא הקליד אותם בעצמו. - **כל מה שנמצא תחת `data` מועבר ל-AI שלכם.** כל דבר שתשימו שם — תוכנית, מספר הזמנה, תאריך חידוש, יתרת אשראי, כמה מושבים יש להם — הופך לחלק ממה שה-AI יודע על אותו אדם, כך שהוא יכול לענות על "מתי התוכנית שלי מתחדשת?" מבלי לבקש מהם להסביר מי הם קודם לכן. השתמשו בכל שמות שדות שנראים לכם הגיוניים; הם יופיעו באיש הקשר תחת שדות מותאמים אישית (Custom Fields). עד 20 ערכים, שנשלחים מחדש עם כל הודעה, כך שאם התוכנית משתנה באמצע השיחה, ה-AI יראה את הערך החדש. עבור הטמעות מוטבעות (inline embeds), אתם יכולים לשים את אותו מידע על ה-`

` במקום זאת, מה ששימושי כאשר דף אחד מכיל מספר צ'אטים: {% code overflow="wrap" %} ```html

``` {% endcode %} אם האתר שלכם יודע מי המבקר רק לאחר טעינת הדף — למשל באפליקציית דף יחיד (SPA) שבה ההתחברות מתבצעת ללא רענון דף — קראו לפונקציה הזו בכל פעם שיש לכם את הפרטים, והווידג'ט יעדכן את עצמו: {% code overflow="wrap" %} ```html ``` {% endcode %} כמה דברים שכדאי לדעת: - אם שני אנשים שונים מתחברים מאותו מחשב, השני יתחיל שיחה חדשה במקום לראות את הצ'אט של הראשון. הווידג'ט מזהה את החלפת המשתמש ומאפס את עצמו. - כשלעצמו, זה נועד להקשר, לא לחיבור משתמש. שיחות נשמרות בנפרד כפי שהיו תמיד, לכן העברת `id` לא מאפשרת לאף אחד לפתוח צ'אט של מישהו אחר, ומי שמשתמש במכשיר או בדפדפן אחר יתחיל שם שיחה חדשה. כדי להמשיך את השיחה בין מכשירים, יש לחתום על ה-`id` כמתואר בהמשך. - זה אופציונלי. ווידג'ט בדף ציבורי רגיל אינו זקוק לכל זה ומתנהג בדיוק כפי שהתנהג קודם. #### המשך את אותה שיחה בכל מכשיר (מזהה מבקר מחובר) אם ללקוחות שלך יש חשבונות, באפשרותך לגרום לצ'אט שלהם לעקוב אחריהם: התחברות בטלפון, המשך במחשב נייד, וזו תהיה אותה שיחה עם אותו איש קשר בתיבת הדואר הנכנס שלך, והבינה המלאכותית עדיין תדע את כל מה שנאמר. לשם כך, DM Champ זקוק להוכחה שהמבקר הוא אכן מי שהדף שלך טוען שהוא, אחרת כל אחד יוכל להקליד מספר לקוח בדפדפן שלו ולקרוא את הצ'אט של אותו לקוח. ההוכחה היא חתימה שאתה מחשב בשרת שלך. 1. בלוח ה-**Manage** של הווידג'ט, תחת **Channels & Embed**, מצא את **Signed-in visitors** ולחץ על **Generate secret**. העתק את ה-identity secret. שמור אותו בשרת שלך בלבד; לעולם אל תכניס אותו לדף עצמו. ::: master-only

שורת ה-Signed-in visitors בלוח ה-Manage של ווידג'ט הצ'אט, המציגה את ה-identity secret המוסתר עם כפתורי הצגה, העתקה וריענון, וקטע ההגדרות עם השדות id ו-hash מתחתיו — שורת ה-Signed-in visitors תחת Channels & Embed. הסוד נשאר מוסתר עד שתלחץ על הצג; הקטע שמתחת מראה היכן ה-id והחתימה שלו ממוקמים בדף שלך.

::: 2. כאשר השרת שלך מרנדר דף עבור לקוח מחובר, חשב HMAC-SHA256 של ה-ID של אותו לקוח באמצעות הסוד, כמחרוזת hex באותיות קטנות: {% code overflow="wrap" %} ```js // Node.js const hash = require("crypto").createHmac("sha256", IDENTITY_SECRET).update(customerId).digest("hex"); ``` {% endcode %} {% code overflow="wrap" %} ```php // PHP $hash = hash_hmac('sha256', $customerId, IDENTITY_SECRET); ``` {% endcode %} {% code overflow="wrap" %} ```python # Python import hmac, hashlib hash = hmac.new(IDENTITY_SECRET.encode(), customer_id.encode(), hashlib.sha256).hexdigest() ``` {% endcode %} 3. שים את המזהה ואת ה-hash בבלוק ההגדרות, לצד השם והאימייל שאתה כבר מעביר: {% code overflow="wrap" %} ```html ``` {% endcode %} ה-inline embed מקבל את אותו ערך כמו `data-visitor-hash` ב-`

`, ו-`window.chatWidget.setVisitor({ visitor: { id, hash } })` עובד עבור אפליקציות שמחברות אנשים ללא רענון דף. מה קורה ברגע שהחתימה מאומתת: - הצ'אט של הלקוח נשמר תחת החשבון שלו במקום תחת הדפדפן, כך שזו אותה שיחה בכל מכשיר ובכל דפדפן שבו הוא מחובר, ואיש קשר אחד בתיבת הדואר הנכנס שלך. - ההודעות הקודמות שלו נטענות במכשיר החדש, והבינה המלאכותית ממשיכה מהמקום שבו הפסיקו. - אם החתימה שגויה, הווידג'ט מתנהג בשקט כפי שהתנהג קודם, כצ'אט רגיל לפי דפדפן, ומדפיס את הסיבה בקונסולת הדפדפן כדי שמפתח יוכל לזהות זאת. המבקרים שלך לעולם לא יראו שגיאה. - המזהה מושווה בדיוק כפי ששלחת אותו, לכן חתום על אותו ערך שאתה מעביר כ-`id`, והשתמש באותו מזהה עבור אותו אדם בכל מקום. שני דברים שכדאי לדעת: - **Regenerate** בלוח ה-Manage נותן לך secret חדש. דפים שעדיין חותמים עם הישן יחזרו לצ'אטים רגילים לפי דפדפן עד שהשרת שלך ישתמש ב-secret החדש. שיחות קיימות נשמרות; הן קשורות למזהה הלקוח, לא ל-secret. - שיחה שמישהו ניהל לפני ההתחברות, כמבקר אנונימי, נשארת צ'אט נפרד. השיחה מבוססת-החשבון מתחילה עם ההודעה הראשונה שהם שולחים בזמן שהם מחוברים. ### שינוי הגדרות הווידג'ט מהקוד שלך (API) ניתן לשנות את כל מה שמופיע בלוח ה-**ניהול** (Manage) של הווידג'ט גם באמצעות ה-[REST API](../api/reference.md), דבר שימושי אם אתה מנהל אתרים רבים או רוצה לכבות את כפתור הצירוף באופן אוטומטי עבור לקוח. שלח `PATCH` אל `https://api.dmchamp.com/v1/chat-widget-configs/CONFIG_ID` עם מפתח ה-API שלך ורק את השדות שברצונך לשנות — לדוגמה, `{"show_upload_button": false}` מסתיר את כפתור הצירוף, `{"show_emoji_button": false}` מסתיר את בורר האימוג'י, ו-`{"launcher_icon": "chat-dots"}` מחליף את סמל המפעיל. `CONFIG_ID` הוא אותו מזהה שמופיע בסקריפט ההטמעה שלך. הרשימה המלאה של השדות המקובלים (שם, הודעת פתיחה, צבעים, סמל מפעיל, דומיינים מורשים, טופס פרטי מבקר, הודעת פרטיות, ערכת נושא, סגנון פינה וגופן) נמצאת ב-[מדריך ה-API](../api/reference.md) תחת **ווידג'ט צ'אט** (Chat Widget). אתרים יעדכנו את השינוי בטעינת הדף הבאה. ### למה לצפות לאחר ההתקנה לאחר שתוסיף את הסקריפט לאתר שלך, ווידג'ט הצ'אט ייצור באופן אוטומטי כפתור צ'אט בפינת האתר שלך (כברירת מחדל בפינה הימנית התחתונה). הווידג'ט נשאר במיקום קבוע בזמן שהמשתמשים גוללים בדפים שלך, מה שמבטיח שהוא תמיד נגיש. ::: master-only

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

::: כאשר מבקרים לוחצים על כפתור זה, הוא מתרחב לחלון צ'אט מלא שבו הם יכולים להתחיל שיחה, תוך הצגת הודעת הפתיחה שלך. אם Collect visitor info (איסוף פרטי מבקר) מופעל, יופיע תחילה טופס קטן המבקש את שמם והאימייל שלהם (ואופציונלית טלפון) לפני שהם יוכלו להקליד. ::: master-only

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

::: ממשק הצ'אט מתאים את עצמו אוטומטית לגדלי מסך שונים, כך שהוא עובד בצורה חלקה גם במחשבים שולחניים וגם במכשירים ניידים. ### בדיקת ההטמעה שלכם לאחר הוספת הווידג'ט לאתר שלך, בדוק שהוא עובד: 1. פתח את האתר שלך בדפדפן. 2. לחץ על כפתור הצ'אט כדי לפתוח את הווידג'ט. 3. שלח הודעת בדיקה וודא שאתה מקבל תשובה. 4. חזור על הפעולה במכשיר או בדפדפן אחר כדי לוודא שהוא עובד בכל מקום. ::: master-only

לוח הצ'אט לאחר שמבקר שולח הודעת בדיקה, המציג את בועת ההודעה היוצאת שלו מתחת להודעת הפתיחה — לאחר שליחת הודעה, היא מופיעה כבועה יוצאת בשרשור — ה-AI או הצוות שלך משיבים באותו חלון.

::: אם ווידג'ט הצ'אט אינו מופיע באתר שלך, בדוק את הדברים הבאים: 1. ודא שהחלפת את `CONFIG_ID` במזהה התצורה האמיתי שלך. 2. ודא שתגית הסקריפט ממוקמת לפני תגית הסגירה ``. 3. בדוק את הקוד עבור שגיאות הקלדה. ### מאחורי חומת אש ארגונית אם הווידג'ט נטען עבור הציבור אך לא עבור הצוות ברשת המשרדית, כמעט בוודאות שהרשת חוסמת את הדומיין שממנו הוא נטען. בקש מצוות ה-IT שלך לאפשר, באמצעות HTTPS רגיל בפורט 443: - **הדומיין בקטע הקוד להטמעה שלך** — הכתובת בשורת ה-`