الوثائق

الهاتف في الوقت الفعلي

الصوت الوارد / الصادر عبر LiveKit + SIP، بثّ ASR/TTS، المقاطعة (barge-in)، متعدّد اللغات.

الهاتف في الوقت الفعلي

تتيح قناة الهاتف لـpipeline في betool الردّ على المكالمات أو إجراءها. والصوت في الوقت الفعلي، والنسخ النصّي بالبثّ، وتركيب الكلام بزمن استجابة منخفض، والمقاطعة (barge-in) — كلها مدعومة.

البنية

خلف الكواليس:

  • يتولّى LiveKit نقل الصوت في الوقت الفعلي.
  • يربط LiveKit-SIP خدمة LiveKit بخطّ ناقلك (SIP).
  • ينسّق worker مخصّص المكالمة: ASR (Deepgram، OpenAI Whisper)، LLM (Claude، GPT-4o، نموذج خاص)، TTS (ElevenLabs، OpenAI TTS، Azure).

تعمل هذه الحزمة كـعملية منفصلة عن الواجهة الخلفية الرئيسية. ولا تقوم أنت بتهيئتها مباشرةً — بل يُعِدّ مشغّل نسختك جسر SIP.

المتطلبات المسبقة

  • خطّ SIP من ناقل (Twilio، Voxbone، OVH، Sewan، أو مشغّل وطني).
  • رقم وارد و/أو القدرة على إجراء مكالمات صادرة.
  • مفتاح من مزوّد ASR وTTS — أو نموذج خاص في خطة Enterprise.

في خطة Enterprise، يمكن لـbetool توفير خطّ SIP ومزوّدي الصوت نيابةً عنك. وإلا، فأدخِل بيانات الاعتماد في لوحة الإدارة.

الإعداد في الإدارة

  1. الإدارة ← الهاتف ← الخطوط — أدخِل بيانات اعتماد SIP لناقلك.
  2. الإدارة ← الهاتف ← الأرقام — اربط رقمًا بخطّ، ثم بـpipeline مستهدَف.
  3. الإدارة ← نماذج الصوت — اختر ASR (الإدخال) وTTS (الإخراج). وتُعرَض عدّادات الاستخدام بالوحدة.

تصميم pipeline صوتي

يبدأ الـpipeline الصوتي دائمًا بعقدة Start مزوّدة بالمستقبِل phone_gateway. ومن هناك، يستقبل الـpipeline:

  • exchange.user_message — كل دورة كلام منسوخة
  • exchange.intent — النيّة المُكتشَفة (إذا فعّلت وكيل تصنيف)
  • exchange.channel.source_type — مضبوطة على phone_gateway

يمكن للعُقد اللاحقة أن تُعيد نصًّا يقرؤه TTS بصوت مسموع. وتتوفّر تلقائيًا أدوات صوتية متخصّصة (المقاطعة، إنهاء المكالمة، التحويل، موسيقى الانتظار) للوكلاء عندما يكون في الـpipeline phone_gateway في الأعلى.

أفضل الممارسات

  • اجعل المهام موجزة. زمن استجابة الردّ مهم: وكيل يتردّد لمدة 4 ثوانٍ يبدو متجمّدًا في المكالمة. فضّل النماذج السريعة (Haiku، GPT-4o-mini) إلا في الدورات الحاسمة للقرار.
  • فعّل المقاطعة (barge-in). يجب أن يتمكّن المتصلون من مقاطعة الوكيل. وهذا مفعَّل افتراضيًا.
  • حُدّ من الحلقات (loops). الـpipeline الذي يكرّر أكثر من 3 مرّات في الدورة نفسها يُحدِث صمتًا مقلقًا للمتصل. راقِب عدّاد التكرار.

التكاليف

راجع التسعير. إرشاديًا: 200 credit لكل دقيقة مكالمة + ASR / TTS / LLM. مكالمة مدّتها 5 دقائق تكلّف عادةً من 0.20 إلى 0.80 دولار حسب نموذج LLM المختار.

القيود المعروفة

  • لا يوجد دعم لـالفيديو (بعد).
  • التحويل إلى إنسان يتطلّب خطّ SIP يدعم REFER (وTwilio متوافق).
  • لا يستطيع الوكيل (بعد) تحديد هوية المتصل دون تكامل CRM.