ربط مزود 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، أنشئ قناة اتصال تحتوي على بيانات اعتماد صادرة، وأدخل نطاقها (على سبيل المثال your-trunk.sip-us.vonage.com) وبيانات الاعتماد، وأضف نقطة نهاية SIP الخاصة بـ ThunderPhone باعتبارها SIP URI الوارد للقناة، واربط أرقامك بالقناة.
• Plivo: أنشئ قناة صادرة تحتوي على بيانات اعتماد وأدخل نطاق SIP للإنهاء (<trunk-id>.zt.plivo.com) واسم المستخدم وكلمة المرور؛ أنشئ قناة واردة يكون URI الأساسي لها هو نقطة نهاية SIP الخاصة بـ ThunderPhone متبوعة بـ ;transport=tcp؛ ثم عيّن نوع التطبيق لكل رقم إلى تلك القناة.

النتيجة هي اتصال 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.

• حقول خطاف الويب الخاصة به فارغة عن قصد. لا يشارك أي خطاف ويب أو تطبيق Call Control أو تطبيق TeXML أو هاتف SIP مسجّل.
• لا تنقل الأرقام المستوردة إلى اتصال أو تطبيق آخر، ولا تسجّل جهازًا عليه.
• إذا أدخلت معرّف الاتصال الخاص بك عند الاتصال، يستخدم ThunderPhone ذلك الاتصال بدلًا منه ولا يغيّره أبدًا؛ ويجب أن يكون اتصال FQDN يشير إلى نقطة نهاية SIP الخاصة بـ ThunderPhone.

قبل 30 أغسطس 2026، كان الاتصال thunderphone-… الذي أنشأه ThunderPhone هو اتصال بيانات اعتماد، ولا يمكنه استقبال المكالمات. إذا كان اتصالك لا يزال يظهر كاتصال بيانات اعتماد، فاتصل بالدعم وسنحوّله.

التكوين اليدوي لـ 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 للمكالمات الواردة من مشغل الاتصالات لديك. ينفذ زران المهمة الأساسية:

• إنشاء دليل إعداد الذكاء الاصطناعي — ينشئ تعليمات خاصة بالموفر لتكوين جانب الوصلة الذي تحتاج إليه.
• اختبار الاتصال وحفظه — يتحقق من أن نقطة نهاية SIP تُحل إلى عنوان عام، وأنها تقبل اتصالاً على المنفذ المختار في حالة TCP/TLS (تتلقى مضيفات UDP فحص DNS فقط)، ثم يحفظ. لا يمكنه إجراء مكالمة بعد لأن الاتصال لا يحتوي على أرقام؛ ويأتي الإثبات الفعلي عند الاستيراد (أدناه).

يؤدي تعديل اتصال لاحقاً إلى إعادة إجراء الفحص نفسه على إعداداتك المعدلة قبل حفظ أي شيء، ثم يعيد إنشاء الخط ويتحقق مجدداً من كل رقم في الاتصال عبر مكالمة اختبار قصيرة في الخلفية — تظهر الأرقام بحالة قيد التهيئة إلى أن تنجح مكالمة الاختبار الخاصة بها. يختلف تغيير عناوين IP المصدر المسموح بها فقط في اتصال متصل: فهو لا يؤثر مطلقاً في المكالمات الصادرة، لذا يحدّث ThunderPhone القائمة على الخط الوارد فوراً وتبقى الأرقام نشطة. يُعاد ضبط اختبار مكالماتها الواردة إلى لم يُختبر؛ شغّله مجدداً، أو أجرِ مكالمة حقيقية عبر مشغل الاتصالات لديك، للتأكد من أن القائمة الجديدة تسمح بدخول المكالمات. يفشل الاختبار إذا كانت مكالمته ستُرفض بموجب القائمة. لا تُعرض كلمات المرور المخزنة مجدداً مطلقاً؛ اترك حقل كلمة المرور فارغاً للاحتفاظ بها، أو حدّد "إزالة كلمة المرور المخزنة" لخط موثّق عبر IP.

إدراج عناوين IP في القائمة المسموح بها ومصادقة الوصلة#

بعض شركات الاتصالات (DIDWW، واتصالات Telnyx المصادَق عليها عبر IP، ومعظم أنظمة 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 وخطافات الويب، وهي تغطي المكالمات التي تتم معالجتها في مناطق كندا والاتحاد الأوروبي والهند واليابان والولايات المتحدة. أسماء المناطق لنقطة نهاية مثبّتة: canada، eu، india، japan، us.

بعض القواعد العامة للوصلة نفسها:

• ThunderPhone لا يسجّل. لا يرسل مطلقًا SIP REGISTER إلى شركة الاتصالات لديك، لذا اضبط الوصلة للمصادقة المستندة إلى 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 بدلًا من خطاف ويب 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 الرقم إليه.

الخطوات التالية#