Exotel
اربط Exotel، وأنشئ تدفقًا مرة واحدة في Exotel، واستقبل المكالمات وأجرِها عبر وكيل في Phynxa.
من المفيد أن تعرف. التحويل إلى شخص وتسجيلات المكالمات غير متاحين على Exotel. استخدم Twilio إن احتجت إليهما.
ما الذي ستحققه
يرنّ رقم Exotel الخاص بك على وكيل في Phynxa، ويستطيع الوكيل نفسه الاتصال بالأشخاص من ذلك الرقم.
كيف يختلف Exotel
يستدعي المزوّدون الآخرون Webhook في Phynxa. أما Exotel فلا. بدلًا من ذلك تبني تدفقًا قصيرًا في App Bazaar الخاص بـ Exotel: Call Start ثم تطبيق Voicebot ثم Hangup. يربط تطبيق Voicebot المكالمة بعنوان تنسخه من Phynxa. تبني التدفق مرة واحدة ويخدم كل المكالمات.
جزآن يتمان في لوحة Exotel نفسها (شاشاتها تتحكم بها Exotel وقد تتغير). كل ما عداهما في Phynxa.
المتطلبات المسبقة
- حساب Exotel فيه ExoPhone واحد على الأقل (رقم أعطتك إياه Exotel).
- Account SID وAPI key وAPI token الخاصة بـ Exotel. وهي في لوحة Exotel تحت Settings ثم API Settings. دليل Exotel: How to find my API key, API token, account SID and subdomain.
- تفعيل بث Voicebot على حساب Exotel. لا تفعّله Exotel افتراضيًا. راسل hello@exotel.com واطلب تفعيل تطبيق Voicebot (بث الصوت) على حسابك.
- وكيل في Phynxa منشور.
الإعداد خطوة بخطوة
الجزء 1: في Phynxa، اربط Exotel
- اذهب إلى Phone numbers، وافتح تبويب Providers، وابحث عن بطاقة Exotel واختر Add credentials.
- أدخل Account SID وAPI key وAPI token.
- إن كان حساب Exotel على عنقود مومباي الخاص بـ Exotel، فاكتب
mumbaiفي Account region (optional). اتركه فارغًا لسنغافورة. إن فشل Import numbers برسالة "Exotel returned HTTP 401" رغم صحة بيانات الاعتماد، فاضبطه علىmumbaiوأعد المحاولة. - اختر Save، ثم Import numbers واستورد ExoPhone الخاص بك.
الجزء 2: في Phynxa، أعطِ الرقم لوكيل
- في تبويب Numbers، عيّن ExoPhone لوكيلك (انظر تعيين رقم لوكيل).
- للمكالمات الواردة يجب أن يكون اتجاه الوكيل Inbound أو Inbound / Outbound.
الجزء 3: في Exotel، ابنِ التدفق مرة واحدة
- في Phynxa، افتح Phone numbers ثم تبويب Webhook setup. بجانب Exotel اختر زر النسخ. يبدأ العنوان بـ
wss://وينتهي بـsample-rate=8000. تعامل معه كسرّي: فهو يحمل مفتاح مساحة عملك. - في Exotel، افتح App Bazaar وأنشئ تطبيقًا جديدًا (تدفقًا).
- اسحب تطبيق Voicebot. لا تستخدم Stream ولا Passthru.
- الصق العنوان المنسوخ في حقل URL الخاص بتطبيق Voicebot.
- أضف تطبيق Hangup بعده، ليصبح التدفق Call Start ثم Voicebot ثم Hangup.
- احفظ التطبيق.
الجزء 4: في Exotel، وجّه الرقم إلى التدفق
- في Exotel، افتح ExoPhones وعدّل رقمك.
- تحت App، اختر التدفق الذي بنيته للتو، ثم احفظ.
صارت المكالمات الواردة إلى ذلك الرقم تصل إلى وكيلك.
الجزء 5 (للمكالمات الصادرة فقط): أخبر Phynxa بتدفقك
- في Exotel، افتح App Bazaar ثم My Apps وابحث عن معرّف تدفقك. وهو أيضًا الرقم في نهاية عنوان التدفق،
…/exoml/start_voice/926. - في Phynxa، في بطاقة Exotel اختر Add credentials، واكتب المعرّف في Flow (app) ID (optional) واختر Save.
- تأكد أن اتجاه الوكيل Outbound أو Inbound / Outbound، وأن ExoPhone معيّن له. فهو معرّف المتصل.
تطلب Phynxa من Exotel أن تتصل بالشخص أولًا. وعندما يجيب، تشغّل Exotel تدفقك وتوصله بالوكيل.
تفاصيل الإعداد
- تدفق واحد للاتجاهين. يُستخدم التدفق نفسه Call Start وVoicebot وHangup للمكالمات الواردة والصادرة.
- إنهاء المكالمة. عندما يغلق الوكيل الخط، تغلق Phynxa الاتصال وتنتقل Exotel إلى تطبيق Hangup الذي ينهي المكالمة. لا تتخطَّ تطبيق Hangup.
- معدل العيّنة. يطلب العنوان من Exotel صوتًا بتردد 8 كيلوهرتز (جودة الهاتف العادية). وتقرأ Phynxa المعدل الذي تستخدمه Exotel فعلًا عند بدء المكالمة.
- أبقِ العنوان سرّيًا. فهو يحمل مفتاح مساحة عملك. ومن يملكه يستطيع بدء مكالمة على أحد أرقامك. لا تضعه في أماكن عامة.
- غير متاح على Exotel. التحويل إلى شخص وتسجيلات المكالمات.
- صيغة الرقم. قد تكتب Exotel الرقم
08012345678أو+918012345678. وتعدّهما Phynxa الرقم نفسه.
الاختبار
- وارد. اتصل بـ ExoPhone من هاتف محمول. يجب أن يرد الوكيل بتحيته.
- صادر. في Phone numbers، اختر Test call، واختر الوكيل، وأدخل رقم هاتفك بالصيغة الدولية (مثل
+919876543210) واختر Call. - تحقق من المكالمة في History.
النتيجة المتوقعة
يرنّ هاتفك أو يرد الوكيل، وتسمع التحية، ويعرض History المكالمة بوصفها Inbound أو Outbound.
استكشاف الأخطاء
| العَرَض | السبب المحتمل | الفحص والإصلاح |
|---|---|---|
| يقول Import numbers "Exotel returned HTTP 401" | مفتاح أو رمز خاطئ، أو الحساب على عنقود مومباي | أعد نسخ المفتاح والرمز. إن كانا صحيحين فاضبط Account region (optional) على mumbai. |
| يعرض تبويب Webhooks "Not available yet" لـ Exotel | العنوان العام للمنصة غير مضبوط | تواصل مع الدعم. |
| الاتصال بـ ExoPhone: الخط صامت أو يقول إن المكالمة لا يمكن إتمامها | الرقم غير مرتبط بتدفقك، أو بث Voicebot غير مفعّل | افحص ExoPhones ثم App. اطلب من Exotel تفعيل تطبيق Voicebot. |
| تتصل المكالمة ثم يُغلق الاتصال فورًا | لُصق العنوان من دون مفتاحه أو عُدّل | انسخه مجددًا من Webhook setup والصقه كاملًا. |
| تتصل المكالمة لكن لا يرد أي وكيل | لا وكيل لديه هذا الرقم، أو الوكيل متوقف أو للصادر فقط | في Numbers افحص Answered by؛ انشر الوكيل؛ اضبط اتجاهه على Inbound أو Inbound / Outbound. |
| صادر: "Missing Exotel details: Flow (app) ID" | معرّف التدفق غير محفوظ | نفّذ الجزء 5. |
| صادر: ترفض Exotel المكالمة | ExoPhone أو التدفق أو الرقم غير مسموح في حساب Exotel | اقرأ الرسالة المعروضة؛ وافحص المكالمة في سجل Exotel. |
| صادر: يرنّ الهاتف لكن لا يُقال شيء | التدفق ليس Call Start وVoicebot وHangup، أو العنوان فيه قديم | أعد بناء التدفق كما في الجزء 3. |
| الصوت متقطع أو مشوّه | خط أو شبكة ضعيفة عند أحد الطرفين | اتصل مجددًا من هاتف آخر. وإن استمر ذلك فأخبر الدعم بما تسمعه مع وقت المكالمة. |
أدلة ذات صلة
هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.
