API של זמן הריצה של הרכיב

ברגע שהרכיב נטען, הוא מתקין אובייקט window.syncanix שאפשר לקרוא לו מהקוד שלכם.

מה אפשר לעשות

• open() — פתיחת חלונית הצ׳אט באופן תכנותי.
• setPosition(position) — העברת המשגר לפינה אחרת.
• unmount() — הסרת הרכיב מהעמוד.
• registerComponent() / unregisterComponent() / getComponentCatalog() — רשמו רכיבי React משלכם כדי שהעוזר יציג אותם, מאומתים בסכמה.
• setContext() / clearContext() — הזינו את המצב החי של האפליקציה (משתמש, עמוד, עגלה) לתור הבא. JSON תחום בלבד — לעולם לא סודות.
• setTokenProvider(fn) — ספקו את האסימון של משתמש הקצה לכל תור (גובר על מאפיין ה-data).
• setStepUpProvider(fn) — ספקו את זרימת האימות-מחדש המוגבר.

דוגמה

// Open the chat programmatically
window.syncanix.open();

// Feed live host-app context into the next turn (bounded JSON, no secrets)
window.syncanix.setContext({ page: 'checkout', cartItems: 3 });

// Provide the signed-in user's token per turn (recommended for SSR apps)
window.syncanix.setTokenProvider(async () => await getAccessToken());

מה העוזר יכול להציג — ומה הוא לא יכול לראות

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

הווידג׳ט לעולם אינו סורק, מזהה אוטומטית או לוכד את ה-DOM של הדף שלכם אל המודל. קריאת תוכן דף מארח לתוך הקשר של AI היא משטח לדליפת נתונים ולהזרקה; לכן לכידת DOM חי נשארת בתיווך הלקוח: אתם מחליטים מה ניתן להטמעה על ידי רישומו.

נטען פעם אחת

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

השלבים הבאים