חזרה ללוח הבקרה

תיעוד

למד כיצד להשתמש ב-Asyntai

כיצד להוסיף צ'אטבוט AI של Asyntai ל-Umbraco

מדריך צעד אחר צעד לאתרי Umbraco CMS

קבלת קוד הטמעה

שלב 1: קבל את קוד ההטמעה שלך

ראשית, עבור ללוח הבקרה של Asyntai וגלול למטה לחלק "קוד הטמעה". העתק את קוד ההטמעה הייחודי שלך שייראה כך:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

הערה: הקוד למעלה הוא רק דוגמה. עליך להעתיק את קוד ההטמעה הייחודי שלך מלוח הבקרה שלך כיוון שהוא מכיל את מזהה הווידג'ט האישי שלך.

שלב 2: עריכת תבנית Master (מומלץ)

הדרך הקלה ביותר להוסיף את הצ'אטבוט לכל הדפים היא על ידי עריכת תבנית ה-Master:

  1. היכנסו לBackoffice של Umbraco
  2. עבור ל-Settings בסרגל הצד השמאלי
  3. הרחיבו את Templates
  4. לחצו על תבנית Master שלכם (או תבנית ה-layout הראשית שהאתר שלכם משתמש בה)
  5. מצא את תג הסגירה </body>
  6. הדבק את קוד ההטמעה של Asyntai ממש לפני תג </body>
  7. לחץ על "Save"

טיפ: הוספת הסקריפט לפני תגית הסגירה </body> מבטיחה שהוא נטען לאחר תוכן העמוד, מה שמומלץ לווידג'טים של צ'אט ולא יאט את טעינת העמוד שלך.

חלופה: שימוש ב-Document Type של הגדרות אתר

לגמישות רבה יותר, ניתן להוסיף שדה מותאם אישית לניהול סקריפטים בפוטר:

  1. עברו אל Settings → Document Types
  2. ערכו את ה-Site Settings document type שלכם (או צרו אחד אם הוא לא קיים)
  3. הוסיפו מאפיין חדש בשם "Footer Scripts" עם סוג נתונים Textarea
  4. שמרו את ה-Document Type
  5. עברו אל Content וערכו את צומת Site Settings שלכם
  6. הדביקו את קוד ההטמעה של Asyntai בשדה Footer Scripts
  7. בתבנית Master שלכם, הוסיפו קוד זה לפני </body>:
    @Html.Raw(Model.Value("footerScripts"))
  8. שמרו הן את התוכן והן את התבנית

הערה: שימוש ב-@Html.Raw() חשוב כדי לרנדר את תגיות הסקריפט כראוי ללא קידוד HTML.

חלופה: שימוש בתיקיית Scripts

ניתן גם ליצור קובץ JavaScript ב-Backoffice של Umbraco:

  1. עברו אל Settings → Scripts
  2. לחצו לחיצה ימנית על Scripts ובחרו "Create"
  3. צרו קובץ חדש בשם asyntai-chatbot.js
  4. הוסף את הקוד הבא:
    (function() {
      var script = document.createElement('script');
      script.async = true;
      script.src = 'https://asyntai.com/static/js/chat-widget.js';
      script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
      document.body.appendChild(script);
    })();
  5. החלף את YOUR_WIDGET_ID במזהה הווידג'ט האמיתי שלך
  6. שמור את הקובץ
  7. כללו סקריפט זה בתבנית Master שלכם לפני </body>:
    <script src="/scripts/asyntai-chatbot.js"></script>

חלופה: ספציפי לדף עם RenderSection

אם אתה רוצה את הצ'אטבוט רק בעמודים ספציפיים:

  1. בתבנית Master שלכם, הוסיפו לפני </body>:
    @RenderSection("footerScripts", required: false)
  2. בתבנית הדף הספציפית שבה אתם רוצים את הצ'אטבוט, הוסיפו:
    @section footerScripts {
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }

שלב 3: אמת את ההתקנה

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

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