חיבור ספק VoIP

חברו ספק שאתם כבר משתמשים בו (Twilio או Telnyx באמצעות מפתח API; SignalWire, Vonage, Plivo או כל מערך SIP באמצעות SIP), או פתחו חשבון Telnyx חדש עם הגדרה מודרכת.

תעבורת ייצור צריכה לפעול על מספרים שבבעלותכם דרך ספק ה-VoIP שלכם. דף חיבורים → VoIP בלוח הבקרה (/dashboard/voip-connections) מחבר את חשבון הספק שלכם; לאחר החיבור, ייבאו מספרים שתומכים בשיחות נכנסות ויוצאות.

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

חברו ספק שאתם כבר משתמשים בו#

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

עבור Twilio ו-Telnyx, הדביקו את פרטי הגישה ולחצו על חברו ובדקו. ThunderPhone מאמת את הפרטים ומגדיר עבורכם את צד הספק. עבור Telnyx, ThunderPhone מוסיף חיבור SIP משלו לחשבון Telnyx שלכם (בשם thunderphone-production-<org>-outbound-<id>) ומבצע דרכו שיחות יוצאות, כך ש-Telnyx מחייבת אתכם עבור שיחות אלה. הוא משתמש בפרופיל הקול היוצא של חיבור Telnyx שעליו נמצאים המספרים שלכם, ולכן המדינות המותרות ומגבלות ההוצאה של אותו פרופיל חלות. אם לחיבור הזה אין פרופיל קול יוצא ולחשבון שלכם יש בדיוק פרופיל מופעל אחד, ThunderPhone משתמש בו. כדי להשתמש בפרופיל אחר, הקצו אותו לחיבור בפורטל Telnyx ושמרו שוב את חיבור ThunderPhone. אם לחשבון אין פרופיל מופעל, או שיש בו כמה פרופילים, הקצו אחד לחיבור בפורטל Telnyx ושמרו שוב את חיבור ThunderPhone. עד אז, שיחות יוצאות נכשלות עם outbound_trunk_unavailable; שיחות נכנסות ממשיכות לפעול.

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

הגדרת SIP עבור SignalWire, Vonage ו-Plivo#

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

• SignalWire: צרו פרטי גישת SIP לשיחות יוצאות, הזינו את דומיין ה-SIP, שם המשתמש והסיסמה, והגדירו לכל מספר סקריפט SWML שמחבר שיחות נכנסות לנקודת הקצה SIP של ThunderPhone.
• Vonage: בלוח הבקרה של SIP Trunking, צרו trunk עם פרטי גישה לשיחות יוצאות, הזינו את הדומיין שלו (לדוגמה your-trunk.sip-us.vonage.com) ואת פרטי הגישה, הוסיפו את נקודת הקצה SIP של ThunderPhone כ-URI ה-SIP הנכנס של ה-trunk, וקשרו את המספרים שלכם ל-trunk.
• Plivo: צרו trunk יוצא עם פרטי גישה והזינו את Termination SIP Domain שלו (<trunk-id>.zt.plivo.com), שם משתמש וסיסמה; צרו trunk נכנס שה-Primary URI שלו הוא נקודת הקצה SIP של ThunderPhone ולאחריה ;transport=tcp; לאחר מכן הגדירו את סוג היישום של כל מספר לאותו trunk.

התוצאה היא חיבור SIP ידני (provider: "manual" ב-API), שנבדק ומאומת בדיוק כמו חיבור שהוזן ידנית. כרטיס החיבור מציג את שם הספק, לדוגמה SignalWire · SIP.

הגדירו חשבון Telnyx חדש#

עדיין אין לכם ספק? התהליך המודרך ילווה אתכם בפתיחת חשבון Telnyx ובחיבורו:

1. יצירת החשבון

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

2. קבלת מפתח API

   לחצו על פתיחת דף מפתחות ה-API, צרו מפתח והדביקו אותו בשדה מפתח API (v2). ניתן לתת לחיבור שם, אם תרצו.

3. התחברות ובדיקה

   לחצו על התחברות ובדיקה — ThunderPhone מאמת את פרטי הגישה ומבצע את ההקצאות הדרושות בצד של Telnyx לפני השמירה.

מה ThunderPhone מגדיר ב-Telnyx#

אלא אם תזינו מזהה חיבור משלכם, שני מסלולי Telnyx (הגדרה מודרכת והדבקת מפתח API) משאירים את אותו הדבר בחשבון Telnyx שלכם: חיבור SIP אחד בשם thunderphone-<your organization id>. זהו חיבור FQDN שרשומת ה-FQDN שלו מצביעה על נקודת הקצה של SIP ב-ThunderPhone, וכל מספר שתייבאו מוקצה אליו. Telnyx שולחת שיחות עבור מספרים אלה ישירות אל ThunderPhone דרך SIP.

• שדות ה-webhook שלו ריקים בכוונה. אין שימוש ב-webhook, ביישום Call Control, ביישום TeXML או בטלפון SIP רשום.
• אל תעבירו מספרים שיובאו לחיבור או ליישום אחר, ואל תרשמו מכשיר מולו.
• אם הזנתם מזהה חיבור משלכם בעת ההתחברות, ThunderPhone משתמשת בחיבור זה במקום זאת ולעולם אינה משנה אותו; הוא חייב להיות חיבור FQDN שמצביע על נקודת הקצה של SIP ב-ThunderPhone.

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

תצורת SIP ידנית#

האריחים של SignalWire, Vonage ו-Plivo פותחים טופס זה, וכך גם אכניס כל הגדרה בעצמי תחת ספק אחר. כל קו SIP נתמך, כולל DIDWW או PBX שאתם מפעילים בעצמכם. הזינו את שם החיבור, תחום / URI של SIP, שם משתמש וסיסמה אופציונליים, יציאה ותעבורה; הגדרות מתקדמות מוסיפות הצפנת מדיה (SRTP). הטופס מציג גם את כתובת ה-SIP שאליה הקו שלכם חייב לשלוח שיחות נכנסות: sip.thunderphone.com, ביציאה 5060 עבור UDP או TCP, או 5061 עבור TLS. באמצעות TLS, איתות ה-SIP נשאר מוצפן עד ל-LiveKit Cloud, שבה ThunderPhone מטפל בשיחה; שמע לעולם אינו עובר דרך sip.thunderphone.com, ולכן SRTP פועל כבעבר. הפנו כל שיחה אל המספר שחויג בפורמט E.164, עם אותו מספר, כולל ה-+, גם בשורת הבקשה וגם בכותרת To: לדוגמה sip:+14155550142@sip.thunderphone.com. ה-+ מאפשר ל- ThunderPhone לטפל בשיחה באזור הנכון (ראו את ההערה תחת רשימת היתרים של IP). קווים שהוגדרו קודם לכן עם כתובת <your-project>.sip.livekit.cloud ימשיכו לפעול כל עוד כתובות IP מקור מורשות ריק; אינכם צריכים לשנות אותם. ThunderPhone ממיר הגדרות אלה לזוג ייעודי של קווי SIP ב-LiveKit Cloud: שיחות יוצאות מהמספרים של החיבור מנותבות אל תחום ה-SIP שלכם עם פרטי ההזדהות שלכם, ושיחות נכנסות אל מספרים אלה מתקבלות מכל כתובת, אלא אם תמלאו את השדה האופציונלי כתובות IP מקור מורשות. מלאו אותו רק אם הספק שלכם מפרסם כתובות IP קבועות לאיתות: רשימה שגויה או חלקית גורמת ל-ThunderPhone לדחות שיחות נכנסות מהספק שלכם. שני לחצנים מבצעים את עיקר העבודה:

• יצירת מדריך הגדרה באמצעות AI — יוצר הוראות ספציפיות לספק עבור תצורת צד הקו הנדרשת לכם.
• בדיקה ושמירת חיבור — בודק שנקודת הקצה של SIP נפתרת לכתובת ציבורית, ועבור TCP/TLS, מקבלת חיבור ביציאה שנבחרה (מארחי UDP מקבלים בדיקת DNS בלבד), ולאחר מכן שומר. עדיין לא ניתן לבצע שיחה מפני שלחיבור אין מספרים; ההוכחה האמיתית מגיעה בזמן הייבוא (בהמשך).

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

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

ספקים מסוימים (DIDWW, חיבורי IP-auth של Telnyx, רוב מרכזיות PBX שמאחורי חומת אש) מקבלים תעבורת SIP רק מכתובות שאתם מוסיפים לרשימת ההיתרים, או מאמתים שיחות יוצאות לפי כתובת IP מקור. ThunderPhone משתמשת בשתי קבוצות של כתובות.

קצה SIP. שיחות נכנסות שאתם שולחים אל sip.thunderphone.com עוברות דרך קצה ה-SIP של ThunderPhone, שמעביר איתות SIP בלבד. בקשת ה-INVITE הראשונה נשלחת אל sip.thunderphone.com; שאר האיתות של השיחה (ACK, ניתוק, העברות) מתבצע בין הספק שלכם לשרת הקצה שקיבל את השיחה, sip-1 או sip-2. אם חומת האש שלכם מסננת איתות SIP, אשרו את שלושתם, ביציאת UDP ו-TCP 5060 וביציאת TLS 5061:

LiveKit Cloud. השמע (RTP) של כל שיחה, ואיתות ה-SIP של שיחות יוצאות, מתבצעים בין הספק שלכם לבין LiveKit Cloud, ולעולם לא דרך קצה ה-SIP. אשרו כל טווח שלהלן, הן עבור איתות SIP והן עבור מדיה:

LiveKit מחיל טווחים אלה על Realtime, איתות ומדיה של SIP ו-Webhooks, והם מכסים שיחות המטופלות באזורי קנדה, האיחוד האירופי, הודו, יפן וארצות הברית שלו. שמות האזורים עבור נקודת קצה מוצמדת: canada, eu, india, japan, us.

כמה כללי אצבע עבור הקו עצמו:

• ThunderPhone אינה נרשמת. היא לעולם אינה שולחת REGISTER של SIP אל הספק שלכם, לכן הגדירו את המערך לאימות מבוסס IP ו/או אישורים (שם משתמש וסיסמה), ולא לרישום.
• שיחות יוצאות צריכות להשתמש באישורים. הפעילו אימות באמצעות שם משתמש/סיסמה בצד הספק והזינו את אותם ערכים בטופס ה-SIP הידני. התייחסו לרשימת ההיתרים של כתובות IP כשכבה שנייה, ולא כשכבה היחידה — שיחות יוצאות ליעדים מחוץ לאזורים המכוסים עשויות לצאת מכתובות אחרות.
• שיחות נכנסות הן בכיוון ההפוך. השדה האופציונלי כתובות IP מקור מורשות בטופס הוא המקום שבו אתם מזינים את כתובות האיתות של הספק שלכם, כדי ש-ThunderPhone תקבל שיחות רק מהן. הזינו כתובות IP או טווחי CIDR; שמות מארחים לעולם אינם תואמים. השאירו את השדה ריק אלא אם הספק שלכם מפרסם רשימה קבועה. ThunderPhone בודקת את הרשימה בכל שיחה נכנסת מול הכתובת שקצה ה-SIP שלה רואה, לכן לאחר הגדרת הרשימה, שלחו את השיחות שלכם אל sip.thunderphone.com. שיחה מכתובת שאינה ברשימה, או שיחה שנשלחת ישירות לכתובת <your-project>.sip.livekit.cloud, נדחית: היא נכשלת או מתחברת ומסתיימת מיד.

הטווחים מתפרסמים על ידי LiveKit בכתובת אזורים, נקודות קצה אזוריות וכתובות IP סטטיות; ThunderPhone בודק דף זה מדי שבוע ומעדכן מדריך זה כאשר הוא משתנה.

לאחר החיבור#

ייבאו מספרים מתוך מספרי טלפון → הוספת מספר → חיבור ספק VoIP (או ישירות מהחיבור). כל מספר שמיובא מאומת לפני שהוא הופך לפעיל. בחיבור SIP ידני, האימות מבצע שיחת בדיקה קצרה (של כמה שניות) מהמספר שלכם, דרך קו ה-SIP שלכם, אל מספר של ThunderPhone — כך ששם המשתמש, הסיסמה, התעבורה וניתוב השיחות היוצאות של ספק התקשורת שלכם נבדקים בפועל. ספק התקשורת שלכם מחייב על שיחה זו כמו על כל שיחה אחרת. אם ספק התקשורת דוחה אותה, המספר נשאר במצב בהקצאה ודף מספרי הטלפון מציג את תשובת הספק (לדוגמה, "נדחו פרטי הגישה של ThunderPhone ‏(SIP 401)"); תקנו את החיבור ואמתו שוב. אם ספק התקשורת שלכם מקבל את הקו אך תכנית הניתוב שלו אינה כוללת את מספר הבדיקה של ThunderPhone ‏(DIDWW משיב "מספר היעד נחסם על ידי תכנית הניתוב"), המספר מוצג כ-מאומת · הספק אישר: ניתן להשתמש בו, אך שיחות ליעדים אחרים לא נבדקו. שיחה זו מוכיחה שהקו שלכם יכול להוציא שיחות באמצעות המספר; היא אינה מוכיחה שאתם הבעלים של המספר, ואינה בודקת שיחות אל המספר; בדיקת השיחות הנכנסות האופציונלית שלהלן כן בודקת זאת. מספרים מאומתים תומכים בשיחות נכנסות ויוצאות — דבר שמאפשר קמפיינים יוצאים ושיחות יוצאות פרוגרמטיות.

בדיקת שיחות נכנסות#

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

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

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

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

פתרון בעיות בשיחות נכנסות#

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

• אתם שומעים הודעה של מפעיל הסלולר שלכם (לדוגמה "ברוכים הבאים ל-Verizon" או "המספר שחייגתם אליו אינו בשירות"): השיחה נכשלה לפני שהגיעה ל-ThunderPhone. בדקו שהמספר פעיל בחשבון הספק שלכם ומוקצה לחיבור או למערך של ThunderPhone.
• צליל תפוס או שהשיחה מצלצלת עד לניתוק: הספק קיבל את השיחה אך לא הצליח להעביר אותה. עם Telnyx, בדקו את ה- חיבור של המספר בפורטל Telnyx: הוא צריך להיות חיבור ה-FQDN thunderphone-… המתואר לעיל, או חיבור FQDN משלכם שמפנה אל נקודת הקצה SIP של ThunderPhone. עם Twilio, המספר צריך להיות מחובר למערך ה-SIP של ThunderPhone ולא ל-webhook של Voice או לאפליקציית TwiML.
• היומנים של המפעיל שלכם מציגים 404 No trunk found (SIP ידני): השיחה הגיעה ל-ThunderPhone אך לא תאמה לאף מערך. בדקו שהמספר מיובא בחיבור זה ושהמערך מפנה אל sip.thunderphone.com. אם הוא מפנה לכתובת <your-project>.sip.livekit.cloud, השדה כתובות IP מורשות של המקור חייב להיות ריק: כאשר מוגדרת רשימה, מתקבלות רק שיחות שנשלחות אל sip.thunderphone.com.
• 404 Not Found מ-sip.thunderphone.com (SIP ידני): השיחה לא הופנתה למספר טלפון, או ששורת הבקשה וכותרת ה- To מציינות מספרים שונים. שלחו את המספר שחויג בשניהם, כפי שמוצג לעיל.
• 403 Forbidden מ-sip.thunderphone.com: שורת הבקשה מציינת מארח אחר. הפנו את השיחה אל sip.thunderphone.com, לדוגמה sip:+14155550142@sip.thunderphone.com.
• השיחה מגיעה ל-ThunderPhone אך סוכן שגוי עונה, או שאף אחד לא עונה: בדקו את הסוכן הנכנס של המספר ב-מספרי טלפון.

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

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