تخطَّ إلى المحتوى
التكامل مع Telnyx

اربط SIP trunk من Telnyx بـ Wixzel Voice

لتشغيل وكيل صوتي بالذكاء الاصطناعي على رقم من Telnyx، اربط SIP Connections من Telnyx بـ Wixzel Voice: أضِف platform_ip الذي يُرجعه الـ trunk إلى authorised addresses on an IP-authenticated SIP Connection لكي تُقبل المكالمات الصادرة، ووجّه المكالمات الواردة إلى origination_uri الخاص به لكي تصل إليك. يواصل Telnyx محاسبتك على الخط بأسعارك؛ ويحاسبك Wixzel Voice على محرك الصوت بالثانية من رصيد مسبق الدفع.

آخر تحديث

نُشر في

Telnyx هو مزوّد الاتصالات؛ وWixzel Voice هو API الذكاء الاصطناعي الصوتي الذي يشغّل الوكيل فوقه. ويعملان معًا عبر SIP القياسي. Telnyx علامة تجارية مملوكة لصاحبها، وWixzel Voice غير تابع لـ Telnyx ولا يحظى بتأييده.

Telnyx
Wixzel Voice
وكيلك

ما الذي تحتاجه قبل أن تبدأ؟

  • حساب لدى Telnyx مع SIP Connections، ومضيف الـ trunk وبيانات اعتماده.
  • رقم هاتف تملكه لدى Telnyx، مربوط بذلك الـ trunk. لا يبيع Wixzel Voice الأرقام ولا ينقلها. إذا ربطت حسابك في Telnyx من لوحة التحكم، يمكنك أيضًا شراء رقم على ذلك الحساب من صفحة أرقام الهاتف. ويحاسبك عليه Telnyx بسعره.
  • مفتاح API من Wixzel Voice وبعض الرصيد المسبق الدفع. الحد الأدنى للشحن $5؛ ولا توجد خطة مجانية.
  • يشغّل Wixzel Voice افتراضيًا 5 مكالمات متزامنة لكل حساب، ويُرفع الحد عند الطلب؛ وتُحتسب جلسات الويب والتطبيقات ضمن الحد نفسه.

كيف تُنشئ trunk الخاص بـ Telnyx في Wixzel Voice؟

عنوان SIP الذي تعرضه Mission Control للاتصال الخاص بك. لا يذكر دليل الإعداد مضيفًا لـ Telnyx، لذلك انسخه من لوحة التحكم وليس من هنا.

cURL
curl https://api.voice.wixzel.com/v1/sip-trunks \
  -H "Authorization: Bearer $WIXZEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Telnyx",
    "host": "<the SIP host Telnyx shows for the connection>",
    "transport": "udp"
  }'

أضِف username وpassword إلى جسم الطلب إذا كان Telnyx يصادق ببيانات الاعتماد بدلًا من عنوان IP. تُخزَّن كلمة المرور مشفّرة، ولا يُرجعها API مرة أخرى أبدًا. وتحمل الاستجابة platform_ip وorigination_uri: القيمتين اللتين تحتاجهما الخطوة التالية.

ما الذي تضبطه لدى Telnyx؟

الإعداداسمه لدى Telnyxالقيمة
السماح بالمكالمات من Wixzel Voiceauthorised addresses on an IP-authenticated SIP Connection187.126.120.231
توجيه المكالمات الواردة إلى Wixzel Voiceوجهة المكالمات الواردة؛ وتذكر خطوات الإعداد اسم الحقلsip:187.126.120.231:5090

القيمتان صالحتان اليوم: اقرأ platform_ip وorigination_uri من GET /v1/sip-trunks بدلًا من نسخهما من صفحة. ثم سجّل كل رقم على الـ trunk باستخدام POST /v1/phone-numbers وأعطه inbound_agent_id، ليرد عليه وكيل. تجد هذه الطلبات في الشرح التفصيلي لـ API المكالمات الهاتفية بالذكاء الاصطناعي، وتمر خطوات الإعداد الكاملة لـ Telnyx على لوحة التحكم حقلًا حقلًا.

ما الذي يتعطل على Telnyx؟

  • عدم تطابق بروتوكول النقل يبدو كأن مزوّد الاتصالات يتجاهلك. أبقِ الاتصال والـ trunk على بروتوكول النقل نفسه؛ وUDP على الطرفين هو الافتراضي.
  • يتوقع Telnyx وجود + في البداية، لذلك اترك send_plus على قيمته الافتراضية true.

لماذا لم تتصل مكالمة عبر Telnyx؟

رمز الفشل الأكثر ظهورًا على Telnyx:

failure_codeما قاله مزوّد الاتصالاتالمعنىما يجب فعله
102408لم يستجب مزوّد الاتصالات في الوقت المحدد.تحقّق من host وport في الـ trunk، ومن أن المزوّد يقبل SIP من platform_ip. إذا كان المزوّد يعرض المكالمة على أنها استُلمت ولم يُرد عليها، فاضبط send_plus على false.

المكالمة التي رفضها Telnyx تحمل status: "failed"، وfailure_code (سبب Q.850 من مزوّد الاتصالات)، وfailure_reason يوضح ما يجب فعله، ولا تكلّف شيئًا. تجد كل رموز الفشل وكل حالات الرفض وطريقة تصحيح أخطاء الـ trunk في صفحة مزوّدي الاتصالات.

كم تكلّف مكالمة بالذكاء الاصطناعي عبر Telnyx؟

يحاسبك Telnyx على الخط بأسعارك؛ ولا يحاسبك Wixzel Voice إلا على محرك الصوت، بالثانية حسب الاستخدام الفعلي، من $0.0491 لكل دقيقة متصلة على gemini-live إلى $0.1851 على deepgram-agent. سعر كل محرك.

الأسئلة الشائعة

ما نوع اتصال Telnyx الذي يعمل مع Wixzel Voice؟

IP authentication. أنشئ SIP Connection في Mission Control مع ضبط نوع الاتصال على IP authentication بدلًا من credentials أو FQDN registration، وأضِف قيمة platform_ip التي يُرجعها trunk الخاص بك على Wixzel Voice كعنوان مصرّح به.

لماذا لا تتصل مكالماتي على Telnyx بعد أن غيّرت بروتوكول النقل؟

يرسل Telnyx عبر UDP افتراضيًا. إذا كانت قيمة transport في trunk الخاص بك على Wixzel Voice هي tcp أو tls، فيجب تغيير SIP Transport Protocol في اتصال Telnyx ليطابقها، وإلا فلن يتوافق الطرفان.

مزوّدو اتصالات آخرون

Twilio

Elastic SIP Trunking. أضِف عنوان IP المنصة إلى Termination IP ACL، واضبط Origination SIP URI للمكالمات الواردة.

Plivo

Zentrunk. trunk صادر يتضمن عنوان IP المنصة في IP ACL الخاصة به، وtrunk وارد منفصل يشير Primary URI فيه إلى المنصة.

Vonage

Programmable SIP. أضِف عنوان IP المنصة إلى ACL الخاصة بالـ trunk في SIP Dashboard، وأرسل المكالمات الواردة إلى origination URI.

Bandwidth

لا يوجد SIP REGISTER، لذلك يلزم عنوان IP ثابت. أضِف عنوان IP المنصة إلى الموقع (location)، واضبط Termination وOrigination كلًّا على حدة، أو استخدم بيانات اعتماد network bridge.

Exotel

Virtual SIP Trunking (vSIP)، لأرقام الهند، عبر TCP. عنوان IP المنصة مربوط بالـ trunk كـ ACL، وDestination URI موجّه إلى منفذ TCP الخاص بالمنصة للمكالمات الواردة.

Vobiz

نطاق SIP لكل trunk كمضيف، وعنوان IP المنصة في IP ACL الخاصة بالـ trunk، وعبارة «origination URI» تعني عكس ما تعنيه في Twilio.

Mobily

Saudi Arabia, ordered through Mobily Business sales and delivered over a private link. No one-step connect: your own SBC on the link relays calls, with G.711 A-law and a one-hour call cap.

أي مزوّد SIP

النمط واحد في كل مكان: أضِف عنوان IP المنصة إلى قائمة السماح، واضبط وجهة المكالمات الواردة على origination URI، وطابِق صيغة الرقم وبروتوكول النقل.

أحضر SIP trunk الخاص بك

كيف يعمل نصفا الـ trunk، وكل رموز الفشل، وكل أدلة مزوّدي الاتصالات في صفحة واحدة.