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

תיעוד

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

איך להוסיף צ'אטבוט AI של Asyntai לכל אתר

מדריך אוניברסלי ל-HTML, אתרים מותאמים אישית ומחוללים סטטיים

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

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

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

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

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

שלב 2: הוספה לקובץ HTML שלך

הדרך הפשוטה ביותר להוסיף את הצ'אטבוט היא להדביק את קוד ההטמעה ישירות לקובץ HTML שלך:

  1. פתח את קובץ HTML שלך בעורך טקסט
  2. מצא את תג הסגירה </body>
  3. הדבק את קוד ההטמעה של Asyntai ממש לפני תג </body>
  4. שמור את הקובץ
<!DOCTYPE html>
<html>
<head>
  <title>My Website</title>
</head>
<body>
  <!-- Your website content -->

  <!-- Asyntai Chatbot - Add before closing body tag -->
  <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</body>
</html>

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

לאתרים מרובי עמודים

אם לאתר שלך מספר עמודי HTML, יש לך מספר אפשרויות:

אפשרות A: הוספה לכל עמוד

הוסף את קוד ההטמעה לכל קובץ HTML שבו אתה רוצה שהצ'אטבוט יופיע.

אפשרות B: שימוש ב-footer include משותף

אם אתה משתמש ב-server-side includes (SSI), PHP includes או דומה:

  1. צור קובץ footer.html (או footer.php)
  2. הוסף את קוד ההטמעה של Asyntai לקובץ זה
  3. כלול קובץ footer זה בכל העמודים שלך:
    <!-- For PHP -->
    <?php include 'footer.php'; ?>

    <!-- For SSI -->
    <!--#include virtual="/footer.html" -->

אפשרות C: טעינה דינמית של JavaScript

צור קובץ JavaScript יחיד שטוען את הצ'אטבוט בכל העמודים:

  1. צור קובץ בשם asyntai-loader.js:
    (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);
    })();
  2. החלף את YOUR_WIDGET_ID במזהה הווידג'ט האמיתי שלך
  3. כלול סקריפט זה בכל העמודים שלך:
    <script src="/js/asyntai-loader.js"></script>

עבור מחוללי אתרים סטטיים

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

Jekyll

הוסף ל-_includes/footer.html או _layouts/default.html

Hugo

הוסף ל-layouts/partials/footer.html או layouts/_default/baseof.html

Gatsby

הוסף ל-gatsby-browser.js או השתמש ב-gatsby-ssr.js

Next.js

הוסף ל-pages/_document.js או השתמש ברכיב next/script

Nuxt.js

הוסף ל-nuxt.config.js תחת head.script

Eleventy (11ty)

הוסף לפריסת הבסיס שלך ב-_includes/

Astro

הוסף ל-src/layouts/Layout.astro לפני </body>

VuePress

הוסף ל-.vuepress/config.js תחת head

עבור אפליקציות React / Vue / Angular

עבור אפליקציות עמוד יחיד (SPAs), ניתן להוסיף את הסקריפט ל-index.html שלך או לטעון אותו באופן דינמי:

React (שיטת index.html)

<!-- In public/index.html, before </body> -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

React (שיטת useEffect)

// In your App.js or a component
useEffect(() => {
  const script = document.createElement('script');
  script.src = 'https://asyntai.com/static/js/chat-widget.js';
  script.async = true;
  script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
  document.body.appendChild(script);
  return () => document.body.removeChild(script);
}, []);

Vue (ב-main.js או App.vue)

// In mounted() or onMounted()
const script = document.createElement('script');
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.async = true;
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);

Angular (ב-index.html)

<!-- In src/index.html, before </body> -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

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

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

לא רואה את הווידג'ט? בדוק שהסקריפט ממוקם כראוי לפני תגית </body>. ודא שאין שגיאות JavaScript במסוף הדפדפן שלך (לחץ F12 כדי לפתוח כלי מפתחים). נסה לנקות את מטמון הדפדפן או לצפות בחלון גלישה פרטית.

חשוב: הצ'אטבוט דורש שהאתר שלך יוגש דרך HTTP או HTTPS (לא נפתח ישירות כקובץ). אם אתה בודק מקומית, השתמש בשרת פיתוח מקומי.