> ## Documentation Index > Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt > Use this file to discover all available pages before exploring further. # CDN / תג סקריפט > הוסיפו את וידג'ט הקול של ThunderPhone לכל אתר ללא באנדלר גרסת ה-CDN כוללת את React באופן פנימי, כך שתוכלו להשתמש בווידג'ט באתרים סטטיים, ב-WordPress, ב-Webflow או בכל דף שבו תוכלו להוסיף HTML. אין צורך ב-npm, בכלי bundler או במסגרת עבודה. ## כתובות URL של CDN ```html Latest (recommended) theme={null} ``` ```html Pinned version theme={null} ``` כתובות ה-URL של `latest` הן אלו שמחולל מקטע ההטמעה בלוח הבקרה יוצר. הן נשמרות במטמון למשך 5 דקות ומקבלות מהדורות יציבות חדשות באופן אוטומטי. נתיבי `/widget/vX.Y.Z/` מקובעים אינם ניתנים לשינוי ונשמרים במטמון לטווח ארוך -- אם אתם מקבעים גרסה, התאימו אותה למהדורת npm של `@thunderphone/widget` שמולה אתם מפתחים. *** ## שימוש בסיסי ```html theme={null}

``` הווידג'ט נטען לתוך רכיב היעד ומוצג כ-**סרגל במיקום קבוע באחת מפינות אזור התצוגה** (ברירת המחדל היא `bottom-right`, ונשלטת באמצעות האפשרות `position`). רכיב הטעינה הוא רק שורש ה-React -- מיקומו בדף אינו משפיע על המקום שבו הווידג'ט מופיע. *** ## אפשרויות טעינה `ThunderPhone.mount()` מקבלת את אותן אפשרויות כמו רכיב ה-React, בנוסף למאפיין `element`: | אפשרות | סוג | חובה | ברירת מחדל | תיאור | | ---------------- | -------------------------------------------------------------- | ---- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `element` | `string \| HTMLElement` | כן | -- | בורר CSS (לדוגמה, `'#thunderphone'`) או הפניה לרכיב DOM. | | `publishableKey` | `string` | כן | -- | מפתח API לפרסום (`pk_live_...`). הסוכן מזוהה אוטומטית מתצורת הווידג'ט של המפתח. | | `theme` | `'light' \| 'dark'` | לא | `'light'` | ערכת צבעים. | | `primaryColor` | `string` | לא | `'#000000'` (בהיר) / `'#ffffff'` (כהה) | מחרוזת צבע CSS המשמשת כצבע הדגשה. | | `title` | `string` | לא | `'Voice assistant'` | הטקסט שמוצג בסרגל הווידג'ט. | | `position` | `'bottom-right' \| 'bottom-left' \| 'top-right' \| 'top-left'` | לא | `'bottom-right'` | מיקום קבוע באזור התצוגה. | | `apiBase` | `string` | לא | `'https://api.thunderphone.com/v1'` | דריסה של כתובת ה-URL הבסיסית של ה-API. | | `language` | `string` | לא | -- | דריסת שפה לכל סשן -- קוד שפה או הגדרת אזור, כגון `en`, `es` או `fr-FR`. כאשר האפשרות אינה מוגדרת, מוחלת השפה שהוגדרה עבור הסוכן. | | `voice` | `string` | לא | -- | דריסת קול לכל סשן -- שם קול כגון `maria`. כאשר האפשרות אינה מוגדרת, מוחל הקול שהוגדר עבור הסוכן. | | `context` | `string` | לא | -- | הקשר עובדתי של דף או אתר לכל סשן, שמועבר לסוכן. נחתך בצד השרת ל-12,000 תווים. | | `onConnect` | `() => void` | לא | -- | נקראת כאשר סשן הקול מתחבר. | | `onDisconnect` | `() => void` | לא | -- | נקראת כאשר הסשן מסתיים. | | `onError` | `(error) => void` | לא | -- | נקראת במקרה של שגיאות. לשגיאה יש שדות `error` (קוד) ו-`message`. | | `ringtone` | `boolean \| string` | לא | `false` | השמעת צלצול בזמן ההתחברות. `true` עבור צלצול ברירת המחדל, או מחרוזת URL עבור שמע מותאם אישית. | *** ## ניקוי `ThunderPhone.mount()` מחזירה מופע וידג'ט עם שיטות ניקוי: ```html theme={null} ``` גם `unmount()` וגם `destroy()` מבצעות את אותה פעולה -- הן מנתקות כל סשן קולי פעיל ומסירות את הווידג'ט מה-DOM. השתמשו בזו שמתאימה יותר לקריאות הקוד שלכם. נקו תמיד את הווידג'ט בעת ניווט ביישומים בעלי דף יחיד או כאשר הרכיב המכיל מוסר. כך תבטיחו שסשנים קוליים פעילים מנותקים כראוי. *** ## דוגמאות ### ערכת נושא כהה עם צבע מותאם אישית ```html theme={null}

``` ### מיקום מותאם אישית ```html theme={null}

``` ### עם קריאות חזרה של אירועים ```html theme={null}

``` ### עם צלצול ```html theme={null}

``` ### שימוש בהפניה לרכיב DOM ```html theme={null}

``` ### שילוב עם WordPress / CMS הוסיפו זאת לבלוק HTML מותאם אישית או לכותרת התחתונה של ערכת הנושא שלכם: ```html theme={null} ``` ניתן למקם את ה-`

` בכל מקום -- הוא משמש רק כנקודת העגינה. הווידג'ט עצמו מוצג כשכבת-על קבועה בפינת אזור התצוגה (המוגדרת באמצעות האפשרות `position`) ואינו זורם עם התוכן שמסביב. *** ## פתרון בעיות ודאו שקובצי ה-CSS וה-JS נטענים. בדקו במסוף הדפדפן שגיאות רשת. ודאו שרכיב היעד קיים ב-DOM לפני הקריאה ל-`ThunderPhone.mount()`. הסקריפט עדיין לא נטען. ודאו שתגית ה-`