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

# הביאו מספרים משלכם (VoIP, API)

> חברו את Twilio או Telnyx — או כל קו SIP — וייבאו מספרי טלפון מהחשבון הקיים שלכם.

מספרי דמו מתאימים לאבות טיפוס, אך תעבורת ייצור צריכה
להשתמש במספרים שבבעלותכם דרך ספק ה-VoIP שלכם. מדריך זה מציג
את התהליך בן שלושת השלבים: **בדיקת פרטי גישה → יצירת
חיבור → ייבוא מספרים → אימות**.

<Note>
  בלוח הבקרה יש גרסה מודרכת של כל התהליך הזה תחת
  **חיבורים → VoIP** (`/dashboard/voip-connections`): הגדרה
  מודרכת של Telnyx שמלווה את יצירת החשבון ומפתחות ה-API, נתיב
  לחיבור חשבון קיים וטופס SIP ידני עם מחולל מדריך הגדרה מבוסס AI.
</Note>

## ספקים נתמכים

| ספק        | מזהה `provider` | הערות                                                              |
| ---------- | --------------- | ------------------------------------------------------------------ |
| Twilio     | `twilio`        | מפתח API + סוד                                                     |
| Telnyx     | `telnyx`        | מפתח API; תהליך הצטרפות מודרך זמין (`setup_method: guided_telnyx`) |
| SignalWire | `signalwire`    | **בקרוב** — התחברו כיום באמצעות SIP ידני                           |
| Vonage     | `vonage`        | **בקרוב** — התחברו כיום באמצעות SIP ידני                           |
| SIP ידני   | `manual`        | כל trunk של SIP — הביאו תצורה משלכם                                |

## 1. בדיקת פרטי גישה

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

```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/voip-connections/test \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider":    "telnyx",
    "credentials": { "apiKey": "KEY...", "connectionId": "123456" },
    "sip_config":  { "domain": "acme.sip.telnyx.com" }
  }'
```

```json Response theme={null}
{
  "status": "pass",
  "verification_evidence_id": "b9a2...",
  "suggested_connection_name": "Telnyx: Acme Main (+15550001234)",
  "checks": {
    "credentials_valid": true,
    "inbound_reachable": true,
    "outbound_authorized": true
  }
}
```

אם בדיקה כלשהי נכשלת, ערך `status` בתגובה יהיה `fail` ו-`checks`
יציג איזה שלב נכשל. תקנו את התצורה בצד הספק (הקצאת trunk,
רשימת היתרי IP, הרשאת שיחות יוצאות) ונסו שוב.

## 2. יצירת החיבור

העבירו את ה-`verification_evidence_id` שקיבלתם זה עתה:

```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/voip-connections \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":         "Acme Telnyx Main",
    "provider":     "telnyx",
    "setup_method": "api_key",
    "credentials":  { "apiKey": "KEY...", "connectionId": "123456" },
    "sip_config":   { "domain": "acme.sip.telnyx.com" },
    "verification_evidence_id": "b9a2..."
  }'
```

התגובה היא [אובייקט VoipConnection](/api-reference/voip-connections#connection-object)
עם `status="connected"`. פרטי הגישה נשמרים בצד השרת ולעולם אינם
מוחזרים כטקסט גלוי בבקשות GET עוקבות — כדי להחליף אותם, הריצו
`test` חדש ושלחו PATCH עם הראיות החדשות.

## 3. הצגת מספרים וייבואם

בדקו את המספרים הגלויים לפרטי הגישה שלכם שעדיין אינם
בארגון ThunderPhone:

```bash theme={null}
curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

לאחר מכן ייבאו את המספרים הרצויים:

```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/voip-connections/5/import-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers": ["+15550001234", "+15550009999"]}'
```

כל ייבוא הופך ל[משאב מספר טלפון](/api-reference/phone-numbers)
בארגון שלכם, עם `source="voip"` ו-`status="provisioning"`.

## 4. אמתו כל מספר שיובא

הייבוא רושם את המספר כ-*זמין*; ניתוב שיחות דרכו בפועל
דורש אימות הלוך ושוב (בדיקת חיוג נכנס + בדיקת הרשאה לשיחות יוצאות).

```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/phone-numbers/{id}/verify-voip \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

במקרה של הצלחה, `voip_verification_status` משתנה ל-`verified` והמספר
נכנס ל-`status="active"`. במקרה של כישלון, התגובה מפרטת
מה נכשל — תקנו זאת (לעיתים קרובות מדובר בהקצאת trunk חסרה בלוח הבקרה של הספק) והתקשרו שוב.

## 5. הקצו סוכנים וקבלו שיחה

לאחר אימות המספר, הקצו סוכנים לשיחות נכנסות / יוצאות באותו
אופן כמו עבור מספר הדגמה. ראו
[טיפול בשיחות נכנסות](/he/guides/handle-inbound-calls) ו-
[ביצוע שיחות יוצאות](/he/guides/place-outbound-calls).

## החלפת פרטי גישה

כאשר מפתח ספק מתחלף, הריצו שוב את תהליך הבדיקה ולאחר מכן העדכון:

```bash theme={null}
# 1. Test the new credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/test ...

# 2. PATCH the connection with the new evidence
curl -X PATCH https://api.thunderphone.com/v1/voip-connections/{id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "credentials": { "apiKey": "NEW_KEY..." },
    "verification_evidence_id": "fresh-evidence-id"
  }'
```

החיבור נשאר במקומו — אין צורך לייבא מחדש מספרים.

***

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

<CardGroup cols={2}>
  <Card title="הפניה לחיבורי VoIP" icon="phone-volume" href="/api-reference/voip-connections">
    כל שדה בתגובות החיבור, הראיות והייבוא.
  </Card>

  <Card title="הפניה למספרי טלפון" icon="phone" href="/api-reference/phone-numbers">
    הקצו סוכנים, העבירו בין ארגונים ושחררו מספרים.
  </Card>

  <Card title="ביצוע שיחות יוצאות" icon="arrow-up-right" href="/he/guides/place-outbound-calls">
    כעת, לאחר שהמספר בבעלותכם, התחילו לבצע שיחות יוצאות.
  </Card>
</CardGroup>