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

# מושגי יסוד

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

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

סרגל הצד בלוח הבקרה משקף מבנה זה:

<CardGroup cols={2}>
  <Card title="ליבה" icon="cube">
    [סוכנים](#agents), [מספרי טלפון](#phone-numbers),
    [וידג'טים לאתר](#web-widgets), [שיחות](#calls),
    [מאגרי ידע](#knowledge-bases).
  </Card>

  <Card title="מעורבות" icon="megaphone">
    [ניטור בזמן אמת](#live-monitoring) ו-
    [קמפיינים](#campaigns) יוצאים.
  </Card>

  <Card title="חיבורים" icon="plug">
    [אפליקציות, ממשקי API, שרתי MCP וספקי VoIP](#connections) שבהם
    הסוכנים שלכם יכולים להשתמש.
  </Card>

  <Card title="איכות ובדיקות" icon="flask">
    [סימולציות](#simulations), [ניסויים](#experiments),
    [בעיות](#issues), [דוחות](#reports),
    [תצפיתיות](#observability).
  </Card>

  <Card title="ארגון" icon="building">
    [צוות ותפקידים](#team-and-roles), [מפתחות API](#organizations),
    [התראות](#alerts), [חיוב](#billing).
  </Card>

  <Card title="אירועים" icon="bolt">
    [Webhooks](#webhooks) ו[כלי פונקציה](#function-tools) עבור
    הקוד שלכם.
  </Card>
</CardGroup>

***

## ארגונים

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

מפתח ה-API מסוג `sk_live_` שתיצרו תחת **ארגון → מפתחות** מקושר
לארגון אחד. קישור זה הוא מה שהופך את REST API לשטוח כל כך:
לעולם לא תצטרכו להוסיף מזהה ארגון לנתיבי URL, מכיוון שהמפתח שלכם כבר
מזהה אותו.

**בלוח הבקרה:** מחליף הארגונים (בתחתית סרגל הצד) והגדרות
**ארגון** — כרטיסיות עבור כללי, מפתחות, התראות, הגדרות חיוב
והיסטוריית חיובים.

**ב-API:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).

***

## סוכנים

**סוכן** הוא תצורת ה-AI שמפעילה שיחה. הוא כולל:

* **הנחיה** שקובעת מה הסוכן אומר וכיצד הוא מתנהג —
  כולל פעולות שיחה כגון העברות, לחיצות על מקשי חיוג וניתוק,
  שהן שורות הנחיה רגילות ולא תצורה נפרדת.
* **רמת מנוע** (`spark`, `bolt`, `storm-*`): Spark מותאם
  לעלות, Bolt למהירות ו-Storm לאינטליגנציה בהנחיות מורכבות.
* **קול** לצד **שפה ראשית** ו**שפות נוספות** אופציונליות —
  הסוכן עובר אוטומטית כאשר המתקשר מחליף שפה. ראו [שפות נתמכות](/he/guides/supported-languages).
* יכולות מצורפות: [אפליקציות מחוברות](#connections),
  [חיבורי API](#connections), [מאגרי ידע](#knowledge-bases),
  [שרתי MCP](#connections) ו[כלי פונקציה](#function-tools)
  מוטמעים.
* הגדרות התנהגות: סדר דיבור, מצב אישור, פס קול ברקע,
  פסק זמן להמתנה.

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

**בלוח הבקרה:** **סוכני קול** → כלי בניית הסוכן
(`/dashboard/agents`). ראו
[בניית סוכן הקול הראשון שלכם](/he/guides/build-an-agent).

**ב-API:** [`/v1/agents`](/api-reference/agents) — CRUD,
שכפול, העברה, היסטוריית גרסאות ועזרי הנחיות.

***

## מספרי טלפון

**מספר טלפון** שייך לארגון ומנתב שיחות נכנסות אל
סוכן (ויכול לשמש גם לשיחות יוצאות). שני מקורות:

* **מספרי הדגמה** — מספרים אמיתיים בארה״ב שמוקצים ממאגר
  ThunderPhone ומוכנים בתוך שניות. לשיחות נכנסות בלבד, הם עונים עם
  הודעת הבהרה קצרה בקול, ולוח הבקרה מגביל ארגון ל-10 מהם. מושלמים
  לבדיקה ראשונה; לא לייצור.
* **מספרי VoIP** — מובאים מהספק שלכם דרך
  [חיבור VoIP](#connections). Twilio ו-Telnyx מתחברים ישירות
  (ל-Telnyx יש הגדרה מודרכת); SignalWire ו-Vonage יתווספו בקרוב —
  כיום ניתן להגיע אליהם באמצעות תצורת SIP ידנית, שמקבלת כל
  SIP trunk. לאחר ייבוא ואימות, מספרי VoIP תומכים בשיחות נכנסות
  ויוצאות.

כל שורת מספר מאפשרת לכם להגדיר מצב ניתוב, לבחור את הסוכן לשיחות
נכנסות ולהוסיף תווית למספר.

**בלוח הבקרה:** **מספרי טלפון** (`/dashboard/phone-numbers`).
ראו [קבלת מספר טלפון](/he/guides/get-a-phone-number).

**ב-API:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/phone-number-labels).

***

## שיחות

כל שיחה נכנסת, שיחה יוצאת, סימולציה והפעלת וידג'ט
הופכות ל**יומן שיחה**. שיחה כוללת את התמליל המלא עם תגיות תפקיד,
היסטוריית התורות המובנית (כולל קריאות לכלים), הקלטה, סכום החיוב,
והערכה אופציונלית של AI ודוחות בעיות.

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

**בלוח הבקרה:** **היסטוריית שיחות** (`/dashboard/call-history`) עבור
הארכיון ופרטי כל שיחה; **פעילות** עבור שיחות שמתנהלות כעת. ראו
[סקירה, האזנה והדרכה של השיחות שלכם](/he/guides/review-calls).

**ב-API:** [`/v1/calls`](/api-reference/calls) — רשימה, תמליל,
היסטוריה, אודיו, הערכה, ייצוא;
[`/v1/issue-reports`](/api-reference/issue-reports).

***

## וידג'טים לאתר

ה**וידג'ט לאתר** מעניק למבקרים באתר שלכם שיחה המבוססת על מיקרופון
עם סוכן — ללא צורך במספר טלפון. הוא מאומת באמצעות
**מפתח שניתן לפרסום** (`pk_live_...`) שמוגבל למקורות של הדומיינים
המותרים שלכם, ולכן בטוח לשימוש בקוד צד לקוח.

מפתחות פועלים באחד משני מצבים: `agent` (מקושר באופן קבוע לסוכן אחד)
או `webhook` (השרת שלכם בוחר את התצורה לכל מבקר — ראו
[תצורה דינמית לכל שיחה](/he/guides/dynamic-call-config)). הפעלות וידג'ט
עוברות דרך אותה תשתית שיחות כמו שיחות טלפון.

**בלוח הבקרה:** **וידג'טים לאתר** (`/dashboard/web-widgets`) —
צרו וידג'טים, הגדירו את המצב והסוכן, נהלו דומיינים מורשים והעתיקו
את קטע ההטמעה. ראו
[יצירת וידג'ט לאתר](/he/guides/embed-a-web-widget-dashboard).

**ב-API:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions), וכן
[תיעוד SDK של הווידג'ט](/he/widget/overview).

***

## בסיסי ידע

**בסיס ידע** הוא אוסף מסמכים שהסוכן שלכם יכול לחפש בו
במהלך שיחה כדי לבסס את תשובותיו — העלו קבצים ישירות או ייבאו אותם מ-
Google Drive, ולאחר מכן צרפו את בסיס הידע לסוכן בבונה. הסוכן
מבצע בו שאילתות באמצעות כלי חיפוש מובנה בכל פעם שהשיחה דורשת זאת.

**בלוח הבקרה:** **ידע** (`/dashboard/knowledge`) עבור
ספריית המסמכים; מקטע **ידע** בבונה כדי לצרף בסיס ידע לסוכן. ראו
[הענקת בסיס ידע לסוכן שלכם](/he/guides/knowledge-base).

***

## חיבורים

חיבורים הם הדרך שבה סוכנים מגיעים לעולם החיצון. ארבעה סוגים, קבוצת
סרגל צד אחת:

* **אפליקציות** (`/dashboard/app-connections`) — חיבורי OAuth אל
  Slack, HubSpot, Salesforce, Google Calendar, Google Sheets ו-Cal.com.
  התחברו פעם אחת, ולאחר מכן הפעילו כלים לפי פעולה (פרסום הודעת
  Slack, יצירה או עדכון של איש קשר ב-HubSpot, קביעת משבצת ב-Cal.com…)
  עבור כל סוכן. ראו [חיבור אפליקציות](/he/guides/connect-apps).
* **ממשקי API** (`/dashboard/api-connections`) — הפכו כל HTTP API
  לפעולת סוכן. הדביקו פקודת cURL ואשף ה-AI ינסח את הגדרת הכלי,
  או בנו אותה ידנית; לחצן **בקשת בדיקה** מפעיל קריאת ארגז חול לפני
  ההשקה לייצור. ראו
  [חיבורי API](/he/guides/api-connections) — הממשק בלוח הבקרה של
  [`/v1/integrations`](/api-reference/integrations).
* **MCP** (`/dashboard/mcp-connections`) — הוסיפו שרת Model Context
  Protocol באמצעות כתובת URL, ואפשרו לסוכן להשתמש בכלים שהוא חושף.
  ראו [הוספת שרת MCP](/he/guides/mcp-servers).
* **VoIP** (`/dashboard/voip-connections`) — פרטי ספק עבור
  [הבאת מספרי הטלפון שלכם](#phone-numbers). ראו
  [חיבור ספק VoIP](/he/guides/voip-providers).

**ב-API:** [`/v1/integrations`](/api-reference/integrations) ו-
[`/v1/voip-connections`](/api-reference/voip-connections); ראו גם
[בניית שילוב כלי](/he/guides/build-tool-integration).

***

## קמפיינים

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

**בלוח הבקרה:** **קמפיינים** (`/dashboard/campaigns`). ראו
[הפעלת קמפיין שיחות יוצאות](/he/guides/outbound-campaigns).

**לשיחות חד-פעמיות באופן פרוגרמטי:**
[API לשיחות יוצאות](/he/guides/place-outbound-calls).

***

## ניטור בזמן אמת

**בשידור חי** מציג כל שיחה שמתנהלת בארגון, ומאפשר לכם
לפתוח כל אחת מהן כדי [להאזין וללחוש](#calls) בזמן אמת. זהו
ממשק הפיקוח: צפו בהנחיה חדשה מקבלת את התעבורה האמיתית הראשונה שלה,
או עקבו אחר קמפיין פעיל.

**בלוח הבקרה:** **בשידור חי** (`/dashboard/live`). ראו
[צפייה ופיקוח על שיחות בזמן אמת](/he/guides/monitor-live-calls).

***

## סימולציות

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

תרחישים מתקבצים ל**חבילות** שמגדירות שיעור מעבר מינימלי ויכולות
לחסום מהדורות ב-CI; נסיגות ביחס לקו הבסיס שאושר מדווחות עבור כל
תרחיש.

**בלוח הבקרה:** **סימולציות** (`/dashboard/simulations`), וכן
לחצן **סימולציה** בתוך בונה הסוכנים. ראו
[סימולציית שיחה](/he/guides/simulate-a-call).

**ב-API:** [`/v1/test-calls`](/api-reference/test-calls) ומריץ
החבילות — ראו [בדיקת סוכן מקצה לקצה](/he/guides/test-agents).

***

## ניסויים

**ניסוי** מבצע בדיקת A/B של תצורות סוכן על תעבורה חיה:
הגדירו וריאנטים (הנחיות, מנועים או הגדרות שונים), חלקו
את התעבורה ביניהם, והשוו תוצאות לכל וריאנט. השתמשו בו במקום
לממש ידנית לוגיקת חלוקה לדליים ב-webhook.

**בלוח הבקרה:** **ניסויים** (`/dashboard/experiments`) והלשונית
**A/B** בבונה הסוכנים. ראו
[ניסויים (בדיקות A/B)](/he/guides/experiments-ab-testing).

***

## בעיות

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

**בלוח הבקרה:** **בעיות** (`/dashboard/issues`), וכן
סימון בעיות לכל שיחה בהיסטוריית השיחות. ראו [מיון בעיות](/he/guides/issues).

**ב-API:** [`/v1/issue-reports`](/api-reference/issue-reports).

***

## דוחות

**דוח** עונה על שאלה בשפה טבעית לגבי נתוני השיחות שלכם
("מה היו שלוש הסיבות העיקריות לכך שמתקשרים ביקשו נציג אנושי בשבוע
שעבר?") באמצעות ניתוח שנכתב על ידי AI, ומוגדר לפי
הסוכנים וטווח התאריכים שתבחרו.

**בלוח הבקרה:** **דוחות** (`/dashboard/reports`). ראו
[דוחות](/he/guides/reports).

***

## תצפיתיות

**תצפיתיות** היא ממשק המדדים: נפח שיחות, תוצאות ואיכות
לאורך זמן, עם אפשרות סינון לפי סוכן וחלון זמן, וייצוא
לניתוח המשכי.

**בלוח הבקרה:** **תצפיתיות** (`/dashboard/observability`).
ראו [תצפיתיות](/he/guides/observability).

***

## התראות

**כלל התראה** עוקב אחר מדד (שיעור הצלחה, שיעור כישלון,
ציון ממוצע, נפח שיחות, נסיגות בסוויטה) לאורך חלון זמן
ומופעל כשהוא חוצה את הסף שהגדרתם. התראות נשלחות לאימייל ול-Slack,
ומפעילות אירוע `alert.triggered` אל
[נקודות הקצה של ה-webhook](/he/webhooks/endpoints) שלכם.

**בלוח הבקרה:** **ארגון → התראות**. ראו
[התראות](/he/guides/alerts).

***

## Webhooks

ThunderPhone שולחת **webhooks מסוג HTTP POST** לשרת שלכם כאשר
אירועים מתרחשים במהלך שיחה ולאחריה. שני מודלי מסירה:

* **נקודות קצה של webhook** (מומלץ): נהלו כתובות URL רבות ב-
  [`/v1/developer/webhook-endpoints`](/he/webhooks/endpoints) עם
  סודות נפרדים לכל נקודת קצה ומינויים לאירועים לכל נקודת קצה.
* **Webhook מדור קודם עם כתובת URL יחידה**: כתובת URL אחת לכל ארגון. מנוהל ב-
  [`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
  או תחת **ארגון → כללי**. נשמר לצורך תאימות לאחור.

האירועים מתחלקים לשתי קטגוריות:

* **אירועים חוסמים** מצפים שהשרת שלכם יחזיר תצורה
  שמשפיעה על השיחה המתנהלת — אלו הם
  [אירועי שיחה נכנסת](/he/webhooks/call-incoming)
  (`telephony.incoming` / `web.incoming`). עומדות לרשותכם עד 10 שניות
  להגיב; במקרה של פסק זמן, הסוכן שהוקצה באופן סטטי מטפל
  בשיחה.
* **אירועים לא חוסמים** הם התראות שנשלחות ללא המתנה, עם ניסיונות חוזרים
  באמצעות השהיה מעריכית — ראו
  [סמנטיקת מסירה](/he/webhooks/overview).

כל בקשה כוללת חתימת HMAC-SHA256 בתוך
`X-ThunderPhone-Signature`. ראו
[אימות חתימה](/he/webhooks/overview).

***

## כלי פונקציה

**כלי פונקציה** הוא נקודת קצה מסוג HTTP שהסוכן שלכם יכול לקרוא לה
במהלך שיחה. אתם מספקים ל-ThunderPhone סכמת פונקציה בסגנון OpenAI
יחד עם כתובת URL של נקודת קצה; הסוכן מחליט מתי לקרוא לה, ו-
ThunderPhone מבצעת את בקשת ה-HTTP החתומה מהשרתים שלה ומחזירה
את התוצאה לסוכן.

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

**בלוח הבקרה:** הקטע **חיבורי API** של הבונה (ראו
[חיבורים](#connections)).

**ב-API:** [`/v1/integrations`](/api-reference/integrations) וכן
[מפרט כלי הפונקציה](/he/tools/overview).

***

## צוות ותפקידים

לכל ארגון יש רשימת חברים עם שני תפקידים: **חברים** בונים
ומתפעלים סוכנים; **מנהלים** מנהלים גם את הצוות ואת החיוב.
הזמינו באמצעות אימייל — ההזמנות פגות לאחר 7 ימים וניתן לבטל אותן;
תפריט ⋯ בשורת חבר משנה תפקידים או מסיר אדם. ניתן להגדיר
כניסה יחידה לכל הארגון — ראו [SSO](/he/guides/sso).

**בלוח הבקרה:** **ארגון → כללי**. ראו
[הזמינו את הצוות שלכם](/he/guides/invite-your-team).

**ב-API:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).

***

## חיוב

ThunderPhone פועל במודל **תשלום מראש**. לכל ארגון יש יתרה בדולר ארה״ב; שיחות מחייבות אותה לפי התעריף לדקה של הסוכן (רמת המנוע בתוספת חיובים — הבונה מציג את התעריף הכולל בזמן אמת בעת שינוי ההגדרות, ו[שפות פרימיום](/he/guides/supported-languages) מוסיפות 2¢/דקה). כשהיתרה מגיעה לאפס, שיחות נכנסות נדחות ושיחות יוצאות מחזירות `402 Payment Required`.

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

**בלוח הבקרה:** **ארגון → הגדרות חיוב** ו**היסטוריית חיובים**. ראו
[הוספת כספים והפעלת טעינה אוטומטית](/he/guides/billing-and-topups).

**ב-API:** [`/v1/billing`](/api-reference/billing).

***

## הקופיילוט בתוך האפליקציה

לוח הבקרה כולל **קופיילוט** מובנה — שאלו אותו "איך עושים X"
והוא עונה על סמך התיעוד הזה, מציע הדרכות מפורטות צעד אחר צעד
שמדגישות את הפקדים בפועל, ויכול להפעיל מחדש כל אחד מהסיורים המודרכים.
זו הדרך המהירה ביותר למצוא פקד שמוזכר בדף זה.
ראו [שאלו את הקופיילוט בתוך האפליקציה](/he/guides/ask-the-copilot).

***

## סיכום

<CardGroup cols={2}>
  <Card title="התחלה מהירה בלוח הבקרה" icon="wand-magic-sparkles" href="/he/quickstart-dashboard">
    האשף בן חמשת השלבים: סוכן → חיוב → מספר → סימולציה → סקירה.
  </Card>

  <Card title="התחלה מהירה עם API" icon="terminal" href="/he/quickstart">
    אותה שיחה ראשונה בארבע קריאות REST.
  </Card>

  <Card title="שימוש בלוח הבקרה" icon="table-columns" href="/he/guides/build-an-agent">
    בנו סוכן, הוסיפו לו כספים, קבלו מספר, הריצו סימולציות וסקו שיחות.
  </Card>

  <Card title="חיבור כלים ונתונים" icon="plug" href="/he/guides/connect-apps">
    אפליקציות OAuth, ממשקי API מותאמים אישית, שרתי MCP וספקי VoIP.
  </Card>

  <Card title="ניתוח ושיפור" icon="chart-line" href="/he/guides/reports">
    דוחות, תצפיתיות, ניסויים, בעיות והתראות.
  </Card>

  <Card title="צוות וחשבון" icon="users" href="/he/guides/invite-your-team">
    הזמנות ותפקידים, מפתחות API, אבטחה ו-SSO.
  </Card>

  <Card title="ספר מתכונים למפתחים" icon="phone-arrow-down-left" href="/he/guides/handle-inbound-calls">
    מתכוני API: שיחות נכנסות, שיחות יוצאות, הגדרה דינמית, כלים ובדיקות.
  </Card>

  <Card title="אימות חתימות webhook" icon="shield-check" href="/he/guides/verify-webhook-signatures">
    הגדירו נכון את בדיקת ה-HMAC פעם אחת והשתמשו בה מחדש בכל מקום.
  </Card>
</CardGroup>