---
title: "התחברות דרך SIP (ללא מספר טלפון)"
description: "נתבו שיחות לסוכן ThunderPhone ישירות מה-PBX, מהספק או מיישום ה-SIP שלכם, באמצעות URI חד-פעמי של SIP לכל שיחה או כתובת SIP קבועה."
---

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

יש שני סוגים של כתובות SIP:

| | **URI של SIP לכל שיחה** | **נקודת קצה של SIP** |
|---|---|---|
| נראה כמו | `sip:c-<token>@sip.thunderphone.com` | `sip:agent-<id>-<letters>@sip.thunderphone.com` |
| נוצר באמצעות | `POST /v1/calls/register-sip`, פעם אחת לכל שיחה | `POST /v1/sip-endpoints`, פעם אחת |
| אימות | האסימון החד-פעמי שבכתובת | שם משתמש וסיסמה של SIP digest (ואפשרותית רשימת כתובות IP מורשות של מקורות) |
| מתאים עבור | אפליקציות שכבר קוראות ל-API לפני העברת שיחה; משתנים לכל שיחה | מרכזיות וספקים שצריכים רק "להפנות trunk" אל ThunderPhone |
| תקף למשך | 5 דקות, שיחה אחת | עד שתמחקו אותה |

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

## URI של SIP לכל שיחה

### 1. רשמו את השיחה

```bash
curl -X POST https://api.thunderphone.com/v1/calls/register-sip \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 12,
    "to_number": "+14155550142",
    "variables": {"customer_name": "Ada"}
  }'
```

```json
{
  "call_id": 862197007562,
  "sip_uri": "sip:c-1790372992.Qm3xT8vLk2PzR7nYw4HbJa.uF6sD1gK9eW2cX5vB8nM0q@sip.thunderphone.com",
  "expires_at": "2026-09-25T21:49:52Z",
  "agent_id": 12,
  "to_number": "+14155550142"
}
```

- `to_number` (אופציונלי) הוא המספר שהמתקשר חייג בצד שלכם. הוא נשמר כיעד השיחה בהיסטוריית השיחות, והסוכן רואה אותו כמספר שלו.
- `variables` (אופציונלי) ממלאים `{{placeholders}}` בהנחיה של הסוכן, באותו אופן כמו עבור [שיחות יוצאות](/he/guides/call-variables).
- `call_id` הוא המזהה שיהיה לשיחה בהיסטוריית השיחות (`GET /v1/calls/{call_id}`) לאחר שהיא תתחבר.

### 2. חייגו ל-URI

שלחו את השיחה אל `sip_uri` בתוך 5 דקות. ה-URI פועל עבור שיחה אחת בלבד: לאחר ששיחה השתמשה בו, הוא נוצל, גם אם אותה שיחה מסתיימת במהירות.

לדוגמה, עם Twilio, החזירו את ה-TwiML הבא עבור השיחה שברצונכם להעביר:

```xml
<Response>
  <Dial>
    <Sip>sip:c-1790372992.Qm3xT8vLk2PzR7nYw4HbJa.uF6sD1gK9eW2cX5vB8nM0q@sip.thunderphone.com;transport=tcp</Sip>
  </Dial>
</Response>
```

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

## נקודת קצה SIP (כתובת קבועה)

### 1. צרו את נקודת הקצה

```bash
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Main PBX"}'
```

```json
{
  "id": 7,
  "name": "Main PBX",
  "agent_id": 12,
  "sip_uri": "sip:agent-12-jhxmginwjx@sip.thunderphone.com",
  "username": "tp409667538f83",
  "password": "8mJ0…",
  "allowed_source_cidrs": [],
  "status": "active",
  "created_at": "2026-09-25T21:46:18Z"
}
```

<Warning>
  הערך `password` מוחזר פעם אחת בלבד, בעת יצירת נקודת הקצה. שמרו אותו
  מיד בתצורת ה-PBX או ספק התקשורת שלכם. אם תאבדו אותו, החליפו אותו באמצעות
  `POST /v1/sip-endpoints/{id}/rotate-password`.
</Warning>

### 2. הפנו את המערכת שלכם אליה

הגדירו trunk או יעד SIP עם:

| הגדרה | ערך |
|---|---|
| URI של SIP | הערך `sip_uri` של נקודת הקצה |
| שם משתמש / סיסמה | `username` / `password` (אימות digest; ThunderPhone מאתגרת כל שיחה) |
| תעבורה | TCP ביציאה 5060 או TLS ביציאה 5061 (מומלץ), או UDP ביציאה 5060 |
| רכיבי Codec | G.711 ‏(PCMU/PCMA) או G.722 |

<Note>
  העדיפו TCP או TLS. UDP פועל מכתובות ציבוריות ומרוב תצורות NAT, אך
  מאחורי NAT "סימטרי" (שמשתמש ביציאה חדשה לכל יעד) הניתוקים וההעברות של
  הסוכן עשויים שלא להגיע למערכת שלכם. רשימת היתרים של כתובות IP מקור
  (בהמשך) דורשת גם היא TCP או TLS. באמצעות TLS, איתות SIP נשאר
  מוצפן גם לאחר `sip.thunderphone.com`, עד לשרתים שמטפלים בשיחה.
</Note>

הגדרות תעבורה ורכיבי codec אלה חלות גם על URI לכל שיחה. שני פרטי רשת
חשובים לשני סוגי הכתובות:

- **עקבו אחר Record-Route.** לאחר ה-INVITE הראשון, שאר איתותי השיחה
  (ACK, ניתוק, העברות) נשלחים לשרת ThunderPhone הספציפי שענה, אשר מצוין
  בכותרת `Record-Route`
  (`sip-1.thunderphone.com` או `sip-2.thunderphone.com`, או כתובת ה-IP שלו).
  אם אתם מגבילים SIP יוצא, אפשרו את המארחים האלה בנוסף ל-
  `sip.thunderphone.com`: `172.170.39.202` (`sip`), `13.86.104.121`
  (`sip-1`) ו-`20.80.98.90` (`sip-2`).
- **השמע עובר למקום אחר.** `sip.thunderphone.com` נושא איתות בלבד.
  אפשרו מדיה (RTP) לכתובות וליציאות שבתשובת SDP.

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

### העבירו את המספר שאליו חויג (אופציונלי)

כדי לתעד לאיזה מהמספרים שלכם המתקשר חייג, שלחו אותו ב-INVITE בכותרת
`X-Original-To` (לדוגמה `X-Original-To: +14155550142`) או בכותרת
התקנית `Diversion`. ThunderPhone שומרת אותו כיעד השיחה.

היעד נבחר בסדר הבא: `to_number` שניתן בעת רישום URI לכל שיחה, לאחר מכן
מספר ב-`X-Original-To`, ולאחר מכן מספר ב-`Diversion`.
אם אף אחד מהם אינו מספק מספר, הוא מוצג כ-`sip:agent-12-jhxmginwjx` (כתובת
נקודת הקצה) עבור נקודת קצה, או כ-`sip:call` עבור URI לכל שיחה.

עם Twilio תוכלו להוסיף את הכותרת ל-URI של SIP:
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tcp?X-Original-To=%2B14155550142`.

### הגבילו כתובות IP מקור (אופציונלי)

הגדירו את `allowed_source_cidrs` כדי לקבל שיחות רק מכתובות האיתות שלכם,
בנוסף לשם המשתמש ולסיסמה:

```bash
curl -X PATCH https://api.thunderphone.com/v1/sip-endpoints/7 \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allowed_source_cidrs": ["203.0.113.0/28"]}'
```

שיחות מכל כתובת אחרת נדחות לפני שהן מגיעות לסוכן. השתמשו בכתובות שמהן
המערכת שלכם שולחת איתות SIP (עבור ספק תקשורת כגון Twilio, בטווחי כתובות
ה-IP המפורסמים שלה לאיתות), ולא בכתובות המדיה שלכם.

<Warning>
  רשימת ההיתרים נבדקת רק עבור שיחות דרך TCP או TLS. ניתן לזייף כתובת מקור
  של UDP, לכן נקודת קצה עם רשימת היתרים דוחה כל שיחה שמגיעה דרך UDP.
  שלחו אליה שיחות עם `;transport=tcp` (יציאה 5060) או באמצעות
  TLS (יציאה 5061).
</Warning>

## מה שהמתקשרים והמערכת שלכם רואים

- **מזהה מתקשר:** חלק המשתמש בכותרת `From` נשמר בתור המתקשר.
  מספר טלפון (ספרות, עם `+`, רווחים, מקפים, נקודות או
  סוגריים לפי הצורך) מנורמל ל-E.164; כל ערך אחר, כגון שם משתמש של SIP,
  נשמר כפי שנשלח. נשמרים לכל היותר 32 תווים, ומתקשר חסר נשמר
  בתור `anonymous`.
- **שיחות שנדחו:** URI לא מוכר או שפג תוקפו עבור שיחה בודדת מקבל SIP
  `404 Not Found`. URI שכבר נעשה בו שימוש עבור שיחה בודדת, נקודת קצה מושבתת או
  מקור שמחוץ לרשימת המורשים (כולל כל שיחת UDP אל נקודת קצה עם
  רשימת מורשים) מנותקים לפני שהסוכן מתחיל: המערכת שלכם עשויה לראות את
  השיחה נכשלת, או מתחברת ולאחר מכן מסתיימת מיד. דחיות אלה אינן יוצרות
  רשומה בהיסטוריית השיחות. אם לארגון שלכם אין יתרה או שהוא
  הגיע למגבלת ההוצאה שלו, השיחה נדחית ומוצגת בהיסטוריית השיחות בתור
  שיחה שנכשלה ללא חיוב. כדי לנסות שוב ניסיון עבור שיחה בודדת, רשמו URI חדש.
- **העברות:** העברות קרות של הסוכן פועלות (ThunderPhone שולחת SIP
  `REFER`, שהמערכת שלכם חייבת לקבל). העברות חמות אינן זמינות בשיחות לכתובות SIP,
  מכיוון שאין מספר ThunderPhone להצגה כמזהה מתקשר עבור המקטע
  השני. עם Twilio, ה-TwiML שלמעלה מחבר את הסוכן אך אינו מטפל בהעברות: הוסיפו
  `referUrl="https://YOUR_SERVER/sip-transfer"` אל `<Dial>`, והגדירו את
  ה-webhook כך שיקרא את `ReferTransferTarget` ויחזיר
  TwiML שמחייג ליעד ההעברה (ראו את
  [מדריך SIP REFER של Twilio](https://www.twilio.com/docs/voice/api/refer-to-twilio)).
- **הודעות טקסט:** כתובת ה-SIP והמספר שחויג אינם יכולים לשלוח הודעות טקסט.
  הסוכן יכול לשלוח הודעת טקסט במהלך שיחה לכתובת SIP רק אם מוגדר עבורו מספר
  נפרד בעל יכולת SMS לשליחת הודעות טקסט; אחרת כלי ה-SMS שלו אינו
  זמין.
- **רישום:** ThunderPhone אינה מקבלת SIP `REGISTER`. שלחו שיחות אל
  הכתובת; אל תירשמו אליה.

## תמחור

שיחות לכתובות SIP מחויבות לפי התעריף הרגיל לדקה של הסוכן. אין
חיוב עבור מספר טלפון, מכיוון שאף מספר ThunderPhone אינו נושא את השיחה. ספק
התקשורת שלכם מחייב עבור הצד שלו בשיחה כרגיל. ראו
[תמחור](/he/guides/pricing).

## בדקו זאת

1. צרו URI עבור שיחה בודדת או נקודת קצה כמתואר למעלה.
2. חייגו אליו מהמערכת שלכם, או מכל טלפון תוכנה של SIP (עבור נקודת קצה, הזינו
   את שם המשתמש והסיסמה).
3. לאחר ניתוק השיחה, פתחו את השיחה ב-**שיחות** בלוח הבקרה, או אחזרו אותה
   באמצעות `GET /v1/calls/{call_id}`. היא מציגה את המתקשר, את היעד
   (ראו את הסדר תחת "העבירו את המספר שחויג") ואת התמלול.

פרטי API: [עיון ב-API של כתובות SIP](/api-reference/sip-addresses).