اتصالات أعمال أبسط
تطبيقات الهاتف والكمبيوترالمطورونحالة IllyVoIPمركز المساعدة

Voice API

منطق تطبيقك،
ومكالمتك،
تحت تحكمك.

أضف المكالمات إلى تطبيقك. أنشئ المكالمات وأجب عنها وشغّل الصوت واجمع المدخلات وتحكم فيما يحدث بعدها عبر IllyVoIP API.

استكشف APIشاهد مثال طلب

الأدوات الأساسية
لبناء تجربة صوتية.

استخدم أوامر منفردة للتحكم المباشر، أو نفذ سلسلة أوامر مرتبة في طلب واحد.

إنشاء المكالمات والرد عليها

ابدأ مكالمات صادرة أو أجب عن مكالمات واردة موجهة إلى Voice API Control.

اطّلع على الوثائق

تحدث واستمع

شغّل صوتاً، وانطق نصاً، واجمع كلام المتصل أو إدخاله من لوحة الأرقام.

اطّلع على الوثائق

وجّه المحادثة

حوّل المكالمة أو ضعها قيد الانتظار أو استأنفها أو أرسل DTMF أو أنهِها وفق حاجة تطبيقك.

اطّلع على الوثائق

مثال عملي لسلسلة أوامر

تحدث،
ثم استمع،
وابنِ الخطوة التالية.

يشغّل هذا الطلب تحية ويجمع رداً منطوقاً في مكالمة قائمة. ويقرر تطبيقك كيف يستخدم النتيجة.

المصادقة
X-Api-Key
صيغة الطلب
application/json
مطلوب لنقطة النهاية هذه
Idempotency-Key

استبدل القيم التوضيحية ببيانات اعتمادك المخزنة على الخادم وجلسة تحكم بالمكالمة صالحة. ولا تعِد استخدام مفتاح منع التكرار إلا لطلب مطابق تماماً.

اقرأ مرجع سلسلة الأوامر
محتوى الطلب · JSON
POST/api/v1/voice/call-control/execute
{
  "call_control_id": "YOUR_CALL_CONTROL_ID",
  "actions": [
    {
      "type": "speak",
      "text": "Welcome to our support line."
    },
    {
      "type": "gather",
      "input": "speech",
      "prompt_text": "How can we help?",
      "speech_language": "en-US",
      "timeout_ms": 8000,
      "save_as": "request"
    }
  ]
}

المكالمات الواردة

رقمك،
واستجابة تطبيقك.

وجّه رقم IllyVoIP إلى Voice API Control. اشترك في حدث الرنين، وأجب عن المكالمة المؤهلة، ثم استخدم معرّف التحكم بالمكالمة المسترجع للأوامر اللاحقة.

اقرأ دليل المكالمات الواردة
رقم الهاتفالتوجيه إلى Voice API Control
حدث الرنينcall_ringing
تطبيقكالرد ثم التحكم بالمكالمة

Webhooks

دع أحداث المكالمات
تحدد الخطوة التالية.

استقبل أحداث دورة حياة المكالمة على نقطة النهاية في تطبيقك. استخدمها لتحديث السجلات أو متابعة تقدم المكالمة أو تشغيل خطوة تالية في نظامك.

استكشف Webhooks
call_initiatedcall_ringingcall_answeredcall_completed

تحقق من التوقيعات وأكد الاستلام سريعاً وامنع التكرار باستخدام معرّف الحدث. فقد تؤدي إعادة محاولة التسليم إلى وصول الحدث أكثر من مرة.

اختر طريقة
البناء المناسبة لك.

استخدم التحكم بالمكالمات لتنفيذ منطق تطبيقك، واربط الأدوات الأخرى التي تحتاجها تجربتك الصوتية.

Webphone SDK

أضف الاتصال من المتصفح إلى واجهتك باستخدام SDK الموثق والمصادقة برموز قصيرة الصلاحية.

اقرأ وثائق SDK

الوكلاء الصوتيون بالذكاء الاصطناعي

أعد مساعداً للمكالمات الواردة بقاعدة معرفة ومسارات مرئية من لوحة التحكم.

اكتشف الوكلاء الصوتيين

قبل أول
عملية تكامل.

اسأل فريقنا
هل Voice API هو نفسه خط SIP؟+

لا. يربط اتصال SIP نظام هاتف أو منصة. أما Voice API فيوفر أوامر تحكم تطلبها تطبيقاتك، مثل نطق النص وجمع المدخلات وتحويل المكالمة.

هل يدعم المكالمات الواردة والصادرة؟+

نعم. تشمل الوثائق إنشاء المكالمات الصادرة والرد على الواردة. للمكالمات الواردة، وجّه رقم هاتف إلى Voice API Control واتبع مسار حدث الرنين والرد الموثق.

هل يمكن جمع الكلام وإدخالات لوحة الأرقام؟+

نعم. تدعم نقطة gather إدخال الكلام وDTMF. راجع وثائقها لاختيار خيارات الإدخال واللغة والمهلة المدعومة لمسارك.

هل يمكن استخدام خدمات الصوت خارج مكالمة مباشرة؟+

نعم. تتوفر نقاط مستقلة لتحويل الكلام إلى نص والنص إلى كلام في مرجع API. استخدمها لتحويل الملفات الصوتية والنصوص، واستخدم gather وspeak داخل المكالمات.

كيف تُسعّر خدمات معالجة الصوت؟+

تنشر لوحة التحكم الأسعار الحالية لتحويل الكلام إلى نص والنص إلى كلام. ويستخدم Voice API هذه الأسعار لعمليتي gather وspeak. راجع الأسعار الحالية ورسوم المكالمات المنطبقة على إعدادك.

أين ينبغي حفظ مفتاح API؟+

احتفظ بمفاتيح API للحساب في تطبيقك على الخادم. يستخدم الاتصال من المتصفح مسار الرموز قصيرة الصلاحية الموثق في Webphone SDK، بدلاً من كشف مفتاح API الخاص بالحساب.

هل يمكنني الاستكشاف قبل ربط تطبيقي؟+

تتضمن لوحة التحكم مرجع نقاط النهاية وأمثلة الطلبات والاستجابات ومواصفة OpenAPI وساحة تجربة API. وقد تنفذ طلبات ساحة التجربة عمليات حقيقية؛ راجع الطلب المختار قبل تشغيله.

ابنِ مسار المكالمات
الذي يحتاجه تطبيقك.

ابدأ بمرجع نقاط النهاية وأمثلة الطلبات الحالية.

افتح وثائق Voice APIتحدث إلى فريقنا