دليل بنية واجهة API الصوتية

واجهات الصوت القابلة للبرمجة قائمة على الأحداث: تستدعيك المنصة أثناء تقدّم المكالمة.

• افهم أحداث دورة حياة المكالمة (بدأت، ترنّ، أُجيب عليها، اكتملت) التي تصدرها واجهتك.معالج webhook لديك هو فعليًا آلة حالة تدفق المكالمة — صمّمه على هذا الأساس.
• صمّم التحكّم بالمكالمات كمعالجات webhook قابلة للـ idempotent تتحمّل إعادة المحاولة والأحداث خارج الترتيب.
• اختر بين مستندات تدفق مكالمات تصريحية والتحكّم الحي عبر API لكل حالة استخدام.
• تعامل مع مفاهيم SIP التي لا يمكن تجنّبها: الوسائط المبكرة، وDTMF، والتحويل، ودلالات re-INVITE.
• خطّط لاستراتيجية الأرقام (E.164)، وعرض هوية المتصل، وقواعد هوية المتصل لكل سوق.

• اختر الترميزات عمدًا: G.711 للجودة، وG.729/Opus حيث يكون النطاق الترددي مقيَّدًا.خطّط ميزانية النطاق الترددي شاملةً حمل IP/UDP/RTP، لا معدل بت الترميز فقط.
• حدّد فاصل تجزئة الحزم (packetization) منطقيًا (عادةً 20 مللي ثانية) موازنًا الحمل مقابل زمن الاستجابة.
• صمّم لتذبذب التوقيت وفقدان الحزم وزمن الاستجابة: صوان تذبذب، وتوقعات MOS واقعية.
• خطّط لمعالجة DTMF (RFC 2833 / SIP INFO / ضمن النطاق) بشكل متسق عبر المسار.
• حدّد احتياجات التسجيل والنسخ مبكرًا — فهي تؤثر على توجيه الوسائط والتخزين.

• تحقّق من توقيعات webhook وارفض الأحداث غير الموقَّعة أو المنتهية الصلاحية.webhook تحكّم مكالمات غير موثَّق مخاطرة استيلاء.
• استجب للـwebhooks بسرعة ونفّذ العمل الثقيل بشكل غير متزامن لتجنّب حجب المكالمة.
• اجعل المعالجات idempotent وأزل التكرار حسب معرّفات الأحداث، لأن إعادة المحاولة متوقَّعة.
• اربط أطراف المكالمة بمعرّف مكالمة/جلسة ثابت عبر التحويل والمؤتمرات.

• حدّد حجم القنوات المتزامنة من CPS × متوسط مدة المكالمة، ثم أضف هامش ذروة.المكالمات المتزامنة ≈ المكالمات في الثانية × متوسط المدة بالثواني.
• وفّر سعة الوصلات/القنوات وتأكّد من حدود التزامن وCPS لدى المزوّد.
• وسِّع معالجات webhook أفقيًا وأبقها عديمة الحالة خلف طابور.
• اختبر الحمل عند ذروة التزامن وتأكّد من تدهور سلس، لا فشلًا حادًّا.

• شفّر الإشارات (SIP عبر TLS) والوسائط (SRTP) حيثما تُعرَض؛ قيّد بعناوين IP مسموحة.
• احمِ من احتيال المكالمات والاحتيال من نوع Wangiri: حدّد المعدل وقيّد الوجهات المميّزة عالية الخطورة.
• صمّم تحوّلًا عبر المناطق/المزوّدين بحيث لا يُسقِط عطل واحد كل المكالمات.
• سجّل سجلات تفصيل المكالمات (CDRs) والأحداث، واحتفظ بالصوت فقط وفق قواعد الامتثال لديك.
• قِس مقاييس الجودة (MOS، وASR، وACD) ونبّه على الانخفاضات لكل مسار.