דלג לתוכן הראשי
עיון בתיעוד

הרכיב

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

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

הטמעה

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

<script
  type="module"
  src="https://cdn.syncanix.com/widget.js"
  data-key="pk_live_..."
  data-position="bottom-right"
></script>

יש לטעון את הסקריפט כ-type="module". זו הדרישה היחידה.

איך הוא נטען

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

בטוח כברירת מחדל

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

השלבים הבאים