اربط trunk أي مزوّد SIP بـ Wixzel Voice
لتشغيل وكيل صوتي بالذكاء الاصطناعي على أرقام من أي مزوّد اتصالات، اربط SIP trunk الخاص بمزوّد الاتصالات بـ Wixzel Voice: أضِف platform_ip الذي يُرجعه الـ trunk إلى قائمة السماح لكي تُقبل المكالمات الصادرة، ووجّه المكالمات الواردة إلى origination_uri الخاص به. يواصل مزوّد الاتصالات محاسبتك على الخط بأسعارك؛ ويحاسبك Wixzel Voice على محرك الصوت بالثانية من رصيد مسبق الدفع.
آخر تحديث
نُشر في
Wixzel Voiceما الذي تحتاجه قبل أن تبدأ؟
- SIP trunk من أي مزوّد اتصالات، مع مضيفه، واسم مستخدم وكلمة مرور إن كان يستخدم التسجيل (registration).
- رقم هاتف تملكه لدى مزوّد الاتصالات الذي تستخدمه، مربوط بذلك الـ trunk. لا يبيع Wixzel Voice الأرقام ولا ينقلها.
- مفتاح API من Wixzel Voice وبعض الرصيد المسبق الدفع. الحد الأدنى للشحن $5؛ ولا توجد خطة مجانية.
- يشغّل Wixzel Voice افتراضيًا 5 مكالمات متزامنة لكل حساب، ويُرفع الحد عند الطلب؛ وتُحتسب جلسات الويب والتطبيقات ضمن الحد نفسه.
كيف تُنشئ الـ trunk في Wixzel Voice؟
مضيف SIP الذي يعطيك إياه مزوّد الاتصالات للـ trunk.
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My carrier",
"host": "sip.carrier.example",
"transport": "udp"
}'أضِف username وpassword إلى جسم الطلب إذا كان مزوّد الاتصالات الذي تستخدمه يصادق ببيانات الاعتماد بدلًا من عنوان IP. تُخزَّن كلمة المرور مشفّرة، ولا يُرجعها API مرة أخرى أبدًا. وتحمل الاستجابة platform_ip وorigination_uri: القيمتين اللتين تحتاجهما الخطوة التالية.
ما الذي تضبطه لدى مزوّد الاتصالات الذي تستخدمه؟
| الإعداد | اسمه لدى مزوّد الاتصالات الذي تستخدمه | القيمة |
|---|---|---|
| السماح بالمكالمات من Wixzel Voice | IP ACL أو قائمة السماح أو العنوان المصرّح به | 187.126.120.231 |
| توجيه المكالمات الواردة إلى Wixzel Voice | Origination URI، أو الاسم الذي يطلقه مزوّد الاتصالات عليه | sip:187.126.120.231:5090 |
القيمتان صالحتان اليوم: اقرأ platform_ip وorigination_uri من GET /v1/sip-trunks بدلًا من نسخهما من صفحة. ثم سجّل كل رقم على الـ trunk باستخدام POST /v1/phone-numbers وأعطه inbound_agent_id، ليرد عليه وكيل. تجد هذه الطلبات في الشرح التفصيلي لـ API المكالمات الهاتفية بالذكاء الاصطناعي، وتمر خطوات الإعداد الكاملة لـ أي مزوّد SIP على لوحة التحكم حقلًا حقلًا.
ما الذي يتعطل لدى مزوّد اتصالات غير مألوف؟
- يتعرض أي منفذ SIP مفتوح للفحص بحثًا عن احتيال المكالمات (toll fraud) خلال ساعات من ظهوره. أبقِ ضوابط مكافحة الاحتيال لدى مزوّد الاتصالات مفعّلة.
- تشترط بعض الأسواق التحقق من الهوية قبل المكالمات الصادرة. يمكن لحساب لم يُكمل KYC، أو تسجيل الوجهات حيث يشترطه السوق، أن يحمل رصيدًا موجبًا ومع ذلك تُنهى كل مكالماته الصادرة فورًا.
- الرصيد المدفوع مسبقًا لدى مزوّد الاتصالات ضروري لكنه غير كافٍ. تأكّد من أن نطاق الوجهة المحدد مفعّل في الحساب، وليس فقط من وجود رصيد.
لماذا لم تتصل مكالمة عبر مزوّد الاتصالات الذي تستخدمه؟
رموز الفشل الأكثر ظهورًا على مزوّد الاتصالات الذي تستخدمه:
| failure_code | ما قاله مزوّد الاتصالات | المعنى | ما يجب فعله |
|---|---|---|---|
| 1 | 404 | مزوّد الاتصالات لا يتعرّف على الرقم. | تحقّق من صيغة الرقم. إذا كان المزوّد يحتاج إلى بادئة اتصال تقنية، فاضبط dial_prefix في الـ trunk. |
| 3 | - | لا يملك مزوّد الاتصالات مسارًا إلى هذه الوجهة. | الوجهة على الأرجح غير مفعّلة في حسابك لدى المزوّد. اطلب من المزوّد فتح المسار. |
| 28 | 484 | رفض مزوّد الاتصالات صيغة الرقم. | إذا كان المزوّد يحتاج إلى بادئة اتصال تقنية، فاضبط dial_prefix في الـ trunk. |
| 102 | 408 | لم يستجب مزوّد الاتصالات في الوقت المحدد. | تحقّق من host وport في الـ trunk، ومن أن المزوّد يقبل SIP من platform_ip. إذا كان المزوّد يعرض المكالمة على أنها استُلمت ولم يُرد عليها، فاضبط send_plus على false. |
المكالمة التي رفضها مزوّد الاتصالات الذي تستخدمه تحمل status: "failed"، وfailure_code (سبب Q.850 من مزوّد الاتصالات)، وfailure_reason يوضح ما يجب فعله، ولا تكلّف شيئًا. تجد كل رموز الفشل وكل حالات الرفض وطريقة تصحيح أخطاء الـ trunk في صفحة مزوّدي الاتصالات.
كم تكلّف مكالمة بالذكاء الاصطناعي عبر مزوّد الاتصالات الذي تستخدمه؟
يحاسبك مزوّد الاتصالات على الخط بأسعارك؛ ولا يحاسبك Wixzel Voice إلا على محرك الصوت، بالثانية حسب الاستخدام الفعلي، من $0.0491 لكل دقيقة متصلة على gemini-live إلى $0.1851 على deepgram-agent. سعر كل محرك.
الأسئلة الشائعة
هل يعمل Wixzel Voice مع مزوّدي اتصالات ليس لهم دليل هنا؟
يردّ مزوّد الاتصالات الخاص بي بـ 408 Request Timeout. ماذا أغيّر؟
send_plus على false في الـ trunk عبر PATCH /v1/sip-trunks/{id}. لا يستطيع كثير من مزوّدي الجملة تحليل + في بداية request URI: فهم يقبلون INVITE، ويفشلون في توجيهه، ثم تنتهي المهلة. وضبط dial_prefix يؤدي إلى الشيء نفسه، لأن البادئة التقنية تُطابق حرفيًا وتُحذف +.مزوّدو اتصالات آخرون
Elastic SIP Trunking. أضِف عنوان IP المنصة إلى Termination IP ACL، واضبط Origination SIP URI للمكالمات الواردة.
SIP Connection بمصادقة IP. أضِف عنوان IP المنصة كعنوان مصرّح به، واختر منطقة للمكالمات الواردة، وطابِق بروتوكول النقل.
Zentrunk. trunk صادر يتضمن عنوان IP المنصة في IP ACL الخاصة به، وtrunk وارد منفصل يشير Primary URI فيه إلى المنصة.
Programmable SIP. أضِف عنوان IP المنصة إلى ACL الخاصة بالـ trunk في SIP Dashboard، وأرسل المكالمات الواردة إلى origination URI.
لا يوجد SIP REGISTER، لذلك يلزم عنوان IP ثابت. أضِف عنوان IP المنصة إلى الموقع (location)، واضبط Termination وOrigination كلًّا على حدة، أو استخدم بيانات اعتماد network bridge.
Virtual SIP Trunking (vSIP)، لأرقام الهند، عبر TCP. عنوان IP المنصة مربوط بالـ trunk كـ ACL، وDestination URI موجّه إلى منفذ TCP الخاص بالمنصة للمكالمات الواردة.
نطاق SIP لكل trunk كمضيف، وعنوان IP المنصة في IP ACL الخاصة بالـ trunk، وعبارة «origination URI» تعني عكس ما تعنيه في Twilio.
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.
كيف يعمل نصفا الـ trunk، وكل رموز الفشل، وكل أدلة مزوّدي الاتصالات في صفحة واحدة.
ابنِ أول وكيل صوتي لك