> ## 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.

# וידג'ט קולי שניתן להטמיע

> הוסיפו סוכן AI קולי לכל אתר באמצעות כמה שורות קוד

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

הווידג'ט מוצג כסרגל במראה זכוכית המותאם לערכות נושא בהירות וכהות, עם צבעי הדגשה ומיקום הניתנים להתאמה אישית. הוא מופץ כחבילת npm `@thunderphone/widget` וזמין גם דרך CDN עבור סביבות ללא מאגד מודולים.

<Frame>
  <img src="https://mintcdn.com/thunderphone/4XhPaCl4RGfyS7_M/images/widget-showcase.png?fit=max&auto=format&n=4XhPaCl4RGfyS7_M&q=85&s=17fea4fe853f3548b9b2628c9d4c4fc0" alt="ווידג'ט ThunderPhone בערכות נושא בהירות וכהות עם מגוון צבעי הדגשה" width="1200" height="800" data-path="images/widget-showcase.png" />
</Frame>

## דרישות מקדימות

לפני הטמעת הווידג'ט, השלימו את שלושת השלבים הבאים ב-[לוח הבקרה של ThunderPhone](https://app.thunderphone.com):

<Steps>
  <Step title="צרו מפתח API שניתן לפרסום">
    עברו אל **מפתחים** בהגדרות לוח הבקרה וצרו מפתח שניתן לפרסום. מפתחות שניתנים לפרסום מתחילים ב-`pk_live_` ובטוחים לשילוב בקוד בצד הלקוח.
  </Step>

  <Step title="הגדירו דומיינים מורשים">
    באותן הגדרות מפתחים, הוסיפו את הדומיינים שבהם הווידג'ט יוטמע. `localhost` מורשה תמיד לצורכי פיתוח. תווים כלליים נתמכים (לדוגמה, `*.example.com`).
  </Step>

  <Step title="צרו ווידג'ט Web">
    עברו אל **ווידג'טים של Web** בלוח הבקרה וצרו ווידג'ט. בחרו את הסוכן שברצונכם לחשוף ואת המפתח שניתן לפרסום שבו תרצו להשתמש. הסוכן נפתר אוטומטית מתצורת המפתח שניתן לפרסום.
  </Step>
</Steps>

<Warning>
  מפתחות שניתנים לפרסום (`pk_live_...`) **אינם** זהים לאסימוני ה-API הסודיים שלכם. מפתחות שניתנים לפרסום מיועדים לשימוש בצד הלקוח ומוגבלים להפעלות ווידג'ט בדומיינים המורשים שלכם. לעולם אל תשתמשו באסימון ה-API הסודי שלכם בקוד בצד הלקוח.
</Warning>

***

## התחלה מהירה

התקינו את החבילה:

```bash theme={null}
npm install @thunderphone/widget
```

הוסיפו את הווידג'ט לאפליקציה שלכם:

```tsx theme={null}
import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'

function App() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
      theme="dark"
      primaryColor="#8b5cf6"
    />
  )
}
```

זה הכול. המשתמשים שלכם יראו סרגל שיחה במראה זכוכית שמחבר אותם לסוכן ה-AI שלכם בלחיצה אחת.

***

## התאמה אישית

לווידג'ט יש ארבעה מאפייני מראה:

| מאפיין         | ברירת מחדל                             | תיאור                                                                            |
| -------------- | -------------------------------------- | -------------------------------------------------------------------------------- |
| `theme`        | `'light'`                              | `'light'` עבור זכוכית לבנה, `'dark'` עבור זכוכית כהה                             |
| `primaryColor` | `'#000000'` (בהיר) / `'#ffffff'` (כהה) | צבע הדגשה ללחצן ההתחלה, לצורת הגל ולמחוון ההתחברות                               |
| `title`        | `'Voice assistant'`                    | הטקסט שמוצג בווידג'ט                                                             |
| `position`     | `'bottom-right'`                       | פינת חלון התצוגה: `'bottom-right'`, `'bottom-left'`, `'top-right'`, `'top-left'` |

<CodeGroup>
  ```tsx Light theme (default) theme={null}
  <ThunderPhoneWidget
    publishableKey="pk_live_your_publishable_key"
  />
  ```

  ```tsx Dark theme with custom color theme={null}
  <ThunderPhoneWidget
    publishableKey="pk_live_your_publishable_key"
    theme="dark"
    primaryColor="#8b5cf6"
    title="Ask our AI"
  />
  ```
</CodeGroup>

שלושה מאפיינים נוספים מתאימים את ההפעלה במקום את המראה -- כולם מועברים לבקשת ההפעלה כאשר מתחילה שיחה:

| מאפיין     | תיאור                                                                   |
| ---------- | ----------------------------------------------------------------------- |
| `language` | דריסת שפה לכל הפעלה -- קוד או אזור כגון `en`, `es` או `fr-FR`           |
| `voice`    | דריסת קול לכל הפעלה -- שם קול כגון `maria`                              |
| `context`  | הקשר עובדתי של הדף או האתר שמועבר לסוכן (מקוצר בצד השרת ל-12,000 תווים) |

עיינו ב-[הפניה לרכיב React](/he/widget/react) לקבלת טבלת המאפיינים המלאה.

לממשק משתמש מותאם אישית לחלוטין, השתמשו ב-[hook ללא ממשק](/he/widget/headless-hook) כדי לנהל את ההפעלה הקולית בזמן שאתם בונים ממשק משלכם. ה-hook חושף רמות שמע בזמן אמת לבניית תצוגות חזותיות המגיבות לשמע.

***

## אפשרויות שילוב

בחרו את שיטת השילוב המתאימה למערך שלכם:

<CardGroup cols={3}>
  <Card title="רכיב React" icon="react" href="/he/widget/react">
    רכיב ממשק משתמש מוכן מראש עם בקרות שיחה מובנות ותצוגת סטטוס. ייבאו, העבירו מאפיינים, וסיימתם.
  </Card>

  <Card title="Hook ללא ממשק" icon="code" href="/he/widget/headless-hook">
    שליטה מלאה בממשק המשתמש. ה-Hook `useThunderPhone` מנהל את סשן הקול בזמן שאתם בונים ממשק משלכם.
  </Card>

  <Card title="CDN / תגית Script" icon="globe" href="/he/widget/cdn-script-tag">
    אין צורך ב-bundler. טענו את הווידג'ט באמצעות תגית script עבור אתרים סטטיים, WordPress וסביבות אחרות שאינן React.
  </Card>
</CardGroup>

***

## עיצוב

הווידג'ט כולל ערכות נושא בהירות וכהות מובנות, הנשלטות באמצעות המאפיין `theme`, וצבע הדגשה הנשלט באמצעות המאפיין `primaryColor`. להתאמה אישית מעמיקה יותר, תוכלו לדרוס מאפיינים מותאמים אישית ומחלקות CSS. לפרטים, עיינו ב[מדריך העיצוב](/he/widget/styling).

<Note>
  זקוקים לעזרה? צרו איתנו קשר בכתובת [support@thunderphone.com](mailto:support@thunderphone.com)
</Note>