הרכיב

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

הטמעה

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

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

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

איך הוא נטען

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

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

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

במה הווידג'ט יכול לגעת ובמה לא

הווידג'ט אטום ומופרד בכוונה מהדף שבו הוא שוכן. במונחים מעשיים:

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

השלבים הבאים