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

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

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

ספקים נתמכים

ספק	מזהה `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 שתעבירו לשלב היצירה, כדי שלא יחויבו פעמיים עבור בדיקות של פרטי הגישה.

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" }
  }'

Response

{
  "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 שקיבלתם זה עתה:

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 עם status="connected". פרטי הגישה נשמרים בצד השרת ולעולם אינם מוחזרים כטקסט גלוי בבקשות GET עוקבות — כדי להחליף אותם, הריצו test חדש ושלחו PATCH עם הראיות החדשות.

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

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

curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

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

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"]}'

כל ייבוא הופך למשאב מספר טלפון בארגון שלכם, עם source="voip" ו-status="provisioning".

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

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

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. הקצו סוכנים וקבלו שיחה

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

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

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

# 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"
  }'

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

השלבים הבאים

הפניה לחיבורי VoIP

כל שדה בתגובות החיבור, הראיות והייבוא.

הפניה למספרי טלפון

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

ביצוע שיחות יוצאות

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

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

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

ספקים נתמכים

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

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

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

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

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

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

השלבים הבאים

הפניה לחיבורי VoIP

הפניה למספרי טלפון

ביצוע שיחות יוצאות

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

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

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

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

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

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

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

​השלבים הבאים

הפניה לחיבורי VoIP

הפניה למספרי טלפון

ביצוע שיחות יוצאות

ספקים נתמכים

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

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

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

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

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

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

השלבים הבאים