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

> מקצה לקצה: הגדירו סוכן, הקצו אותו למספר טלפון, קבלו שיחה ובדקו את התמלול.

<Note>
  בונים את הסוכן הראשון שלכם ידנית? לוח הבקרה מוביל אתכם בדיוק
  בתהליך הזה — בניית הסוכן, הוספת מספר, סימולציה, סקירה — באמצעות
  אשף מודרך. התחילו ב-
  [מדריך המהיר של לוח הבקרה](/he/quickstart-dashboard).
</Note>

התהליך הקנוני של "מענה לטלפון באמצעות AI", ישירות מהמסוף שלכם.
תבצעו:

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

סך כל קריאות ה-API: ארבע. זמן כולל: פחות מחמש דקות.

## 1. צרו סוכן

סוכן מאגד את ההנחיה, הקול ורמת המוצר שינהלו
את השיחה. ראו [סוכנים](/api-reference/agents) עבור כל שדות
התצורה; המינימום הוא:

```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "spark"
  }'
```

שמרו את ה-`id` שהוחזר — תצטרכו אותו בשלב 2.

<Tip>
  בחרו ב-`spark` לשאלות ותשובות פשוטות בעלות הנמוכה ביותר, וב-`bolt` כאשר
  המהירות חשובה יותר מכול. שדרגו ל-`storm-base-with-ack` כאשר ההנחיה שלכם
  דורשת הסקה מעמיקה יותר ויכולה לסבול משפט מילוי של חצי שנייה בזמן
  שהמודל חושב. ראו
  [רמות מוצר](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. קבלו מספר טלפון

אם אתם רק צריכים מספר שאפשר לחייג אליו, הקצו מספר הדגמה
מהמאגר של ThunderPhone:

```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'
```

התשובה כוללת `id` ו-`number` בפורמט E.164. מספרי הדגמה
מתחילים ב-`status="provisioning"` והופכים ל-`active` בתוך כמה
שניות — בצעו תשאול מחזורי של
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number)
כדי לעקוב אחר המעבר אם זה חשוב לכם.

<Note>
  עבור ייצור, דלגו על מספרי הדגמה
  [והביאו מספרים משלכם באמצעות VoIP](/he/guides/bring-your-own-numbers).
  מספרי הדגמה מיועדים לשיחות נכנסות בלבד ומוגבלים בנפח.
</Note>

## 3. הקצו את הסוכן

שייכו את הסוכן משלב 1 לכיוון השיחות הנכנסות של המספר:

```bash theme={null}
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'
```

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

## 4. קבלו שיחה

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

במהלך השיחה, היא מופיעה ב-
[`GET /v1/calls`](/api-reference/calls#list-calls) עם
`status="in_progress"`. כשהיא מסתיימת, הרשומה מתעדכנת עם
`end_reason`, `duration_seconds`, `billable_minutes` ועם הזמן גם
כתובת URL של הקלטה ודירוג AI.

## 5. בדקו את התוצאות

אחזרו את רשימת השיחות האחרונות:

```bash theme={null}
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

אחזרו את התמלול:

```bash theme={null}
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

ואת כתובת ה-URL של ההקלטה (קצרת-מועד וחתומה):

```bash theme={null}
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

אם נרשמתם ל-
[`telephony.complete` webhook](/he/webhooks/events)
תקבלו את אותם הנתונים כ-POST לשרת שלכם — ראו
[call.complete](/he/webhooks/call-complete).

***

## השלבים הבאים

<CardGroup cols={2}>
  <Card title="הגדרה דינמית לכל שיחה" icon="bolt" href="/he/guides/dynamic-call-config">
    בחרו סוכן שונה לכל מתקשר לפי מספר הטלפון או
    לוגיקה מותאמת אישית ב-webhook.
  </Card>

  <Card title="הוספת אינטגרציות לכלים" icon="screwdriver-wrench" href="/he/guides/build-tool-integration">
    אפשרו לסוכן לקרוא לממשקי ה-API שלכם במהלך השיחה.
  </Card>

  <Card title="קבלת webhooks מסוג call.complete" icon="bolt" href="/he/webhooks/call-complete">
    הזרימו כל שיחה שהסתיימה אל צינור ה-CRM / האנליטיקה שלכם.
  </Card>

  <Card title="דירוג באמצעות AI ודוחות בעיות" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    דרגו כל שיחה באופן אוטומטי והעבירו שיחות שסומנו לבדיקה.
  </Card>
</CardGroup>