כיצד להתקין את Notiondesk מסנג'ר באתר האינטרנט שלך

התקן את Notiondesk Messenger באתר שלך באמצעות קטע ה-JavaScript או ה-SDK. למד היכן להוסיף את הקוד, לאמת את ההתקנה ולתקן בעיות התקנה נפוצות.

קריאה של דקה אחת

Notiondesk מסנג'ר מביא את מרכז העזרה Notiondesk שלך ישירות לאתר האינטרנט או לאפליקציית האינטרנט שלך.

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

מדריך זה מסביר כיצד להתקין את Notiondesk מסנג'ר באתר אינטרנט סטנדרטי.

לפני שאתם מתחילים

לפני התקנת Notiondesk מסנג'ר, ודא שיש לך:

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

בחר שיטת התקנה

השתמשו בשיטת ההתקנה המתאימה לאתר שלכם.

סוג אתר אינטרנט שיטה מומלצת
אתר HTML סטנדרטי או אתר מרובה עמודים קטע ג'אווהסקריפט
לְהָגִיב Notiondesk ערכת פיתוח תוכנה של מסנג'ר
Next.js Notiondesk ערכת פיתוח תוכנה של מסנג'ר
ויו Notiondesk ערכת פיתוח תוכנה של מסנג'ר
נוקסט Notiondesk ערכת פיתוח תוכנה של מסנג'ר
יישום אחר בן עמוד אחד Notiondesk ערכת פיתוח תוכנה של מסנג'ר

עבור רוב האתרים המסורתיים, קטע ה-JavaScript הוא שיטת ההתקנה הפשוטה ביותר.

התקנת מסנג'ר באתר אינטרנט סטנדרטי

1. העתק את קוד ההתקנה של המסנג'ר שלך

פתח את הגדרות המסנג'ר שלך ב-Notiondesk ומצא את מקטע ההתקנה .

העתק את קטע ההתקנה שנוצר עבור המסנג'ר שלך.

לקוד יש את הפורמט הזה:

YOUR_MESSENGER_ID מזהה את המסנג'ר שאמור להיטען באתר האינטרנט שלך.

העתק את הקטע מלוח המחוונים Notiondesk שלך במקום להעתיק מזהה מסנג'ר מאתר או חשבון אחר.

2. הוסיפו את קטע הקוד לאתר שלכם

הדבק את קטע הטקסט של המסנג'ר מיד לפני התג </body> שסוגר:

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

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

3. פרסמו את השינויים שלכם

שמור ופרוס או פרסם את אתר האינטרנט שלך לאחר הוספת קטע הקוד.

קוד המסנג'ר חייב להיות קיים באתר שפורסם. הוספת הקוד רק לגרסה מקומית או גרסה שלא פורסמה לא תהפוך את המסנג'ר לזמין למבקרים.

<script
  async
  src="https://static.notiondesk.help/messenger/widget.js"
  data-messenger-id="YOUR_MESSENGER_ID">
</script>
<body>
  <!-- Your website -->

  <script
    async
    src="https://static.notiondesk.help/messenger/widget.js"
    data-messenger-id="YOUR_MESSENGER_ID">
  </script>
</body>

אימות ההתקנה

פתח את האתר שפורסם בדפדפן שלך.

התקנה מוצלחת אמורה לטעון את מפעיל המסנג'ר Notiondesk בדפים המכילים את קוד ההתקנה.

פתחו את מסנג'ר וודאו שמופיע התוכן הצפוי Notiondesk.

אתה יכול לבדוק:

  • פתיחה וסגירה של מסנג'ר
  • חיפוש במרכז העזרה שלך
  • פתיחת מאמר
  • התחלת שיחת בינה מלאכותית אם צ'אטבוט הבינה המלאכותית מופעל
  • פתיחת כל מדור אחר במסנג'ר שהפעלת

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

React, Next.js, Vue, Nuxt ו-SPAs

React, Next.js, Vue, Nuxt ואפליקציות אחרות בעלות עמוד יחיד צריכות להשתמש בחבילת @notiondesk-so/messenger-js-sdk הרשמית במקום להוסיף ידנית את קטע הסקריפט הסטנדרטי.

התקן את החבילה עם:

ניתן גם להתקין אותו באמצעות Yarn או pnpm.

ערכת פיתוח התוכנה (SDK) מספקת אינטגרציות ייעודיות עבור:

npm install @notiondesk-so/messenger-js-sdk
  • ג'אווהסקריפט ו-TypeScript
  • לְהָגִיב
  • Next.js
  • ויו
  • נוקסט

ערכת פיתוח התוכנה (SDK) מספקת גם שיטות להצגה, הסתרה, החלפה, הגדרה והשמדה של Messenger.

אינטגרציות Framework חייבות לאתחל את Notiondesk Messenger בצד הלקוח. אין לאתחל את ה-SDK של Messenger במהלך רינדור בצד השרת.

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

להגדרה מלאה של המסגרת, עיין במדריך התקנת Notiondesk Messenger עם React ו-Next.js.

פתרון בעיות


המסנג'ר לא מופיע

בדוק את הדברים הבאים:

  1. ודא שקטע הקוד של Messenger קיים בדף
  1. ודא שהקטע מכיל את data-messenger-id הנכון
  1. ודא שהשינויים האחרונים שלך באתר פורסמו
  1. רענן את הדף לאחר הפריסה
  1. בדוק את קונסולת הדפדפן עבור שגיאות JavaScript או מדיניות אבטחת תוכן
  1. בדוק את לוח הרשת וודא ש-widget.js אינו חסום

המסנג'ר מופיע בחלק מהדפים אך לא באחרים

Notiondesk מסנג'ר נטען רק בדפים המכילים את קוד ההתקנה.

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

מופיע המסנג'ר הלא נכון

ה-data-messenger-id קובע איזה Notiondesk מסנג'ר נטען.

העתק שוב את קטע ההתקנה מה-Messenger הנכון בלוח המחוונים Notiondesk שלך.

מסנג'ר חסום על ידי מדיניות אבטחת תוכן

מדיניות אבטחת תוכן מגבילה יכולה למנוע טעינה של בקשות JavaScript או רשת של צד שלישי. בדוק את קונסולת הדפדפן עבור שגיאות CSP אם סקריפט המסנג'ר קיים אך אינו נטען.

מדיניות אבטחת התוכן של האתר שלך חייבת לאפשר את המשאבים הנדרשים על ידי Notiondesk Messenger.

המסנג'ר עובד לאחר רענון אבל לא במהלך ניווט SPA

יישומים בעלי עמוד בודד אינם מבצעים טעינה מלאה של העמוד במהלך ניווט רגיל.

השתמשו ב-@notiondesk-so/messenger-js-sdk עבור React, Next.js, Vue, Nuxt ויישומים אחרים מבוססי SPA במקום להסתמך על קטע ההתקנה הסטנדרטי.

משתמש מזוהה אינו מזוהה

ודא שהשרת האחורי שלך מייצר אסימון משתמש Notiondesk תקף ולא פג תוקפו.

אל תיצור את הטוקן בקוד הדפדפן.

כאשר משתמש מתנתק, יש להסיר את אסימון המשתמש מתצורת Messenger או להשמיד את מופע Messenger לפני תחילת סשן משתמש נוסף.

המסנג'ר מוסתר מאחורי אלמנט אחר

ערכת פיתוח התוכנה של Messenger תומכת בתצורה מותאמת אישית של zIndex.

הגדל את ערך הערימה של Messenger אם אלמנט קבוע או צף אחר מוצג מעל מפעיל או לוח המסנג'ר.

מאמרים קשורים

האם הדף הזה היה מועיל?