> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# بناء وكيل صوتي

> دليل خطوة بخطوة لإنشاء وكيل صوتي فقط. مكالمات واردة أو صادرة أو ثنائية الاتجاه عبر Twilio أو Telnyx أو SIP Trunk أو مكالمات WhatsApp. المعالج فيه 6 خطوات بهذا الترتيب: الإعدادات الصوتية، المظهر، قاعدة المعرفة، التذاكر والعملاء المحتملين، التَكاملات والأدوات، النشر.

<div dir="rtl" lang="ar" style={{ direction: "rtl" }}>
  {/* wittify-rtl-wrapper */}

  <Note>
    الوكلاء الصوتيون يَتعامَلون مع **المكالمات الهاتفية فقط**. بدون شات. للدخول، اضغط **إنشاء وكيل** في الشريط العلوي للوحة التَحكُّم، ثم **وكيل صوتي** في المُنتقي. يَفتح المعالج على **الخطوة 1: الإعدادات الصوتية**.
  </Note>

  ## ما قبل الإقلاع

  قبل البدء، اِجعَل هذه جاهزة:

  * **اسم** لوكيلك.
  * **وصف موجز** لغرض المكالمة.
  * **حساب مَزوِّد اتصالات** برقم مُخصَّص واحد على الأقل (Twilio أو Telnyx أو SIP Trunk أو مكالمات WhatsApp). ستَوصِله في الخطوة 6.
  * أي **مَصادر معرفة** (ملفات، أسئلة شائعة، روابط) ليُشير إليها الوكيل أثناء المكالمات.

  المعالج يَعمل في `/{lang}/create/voice/{step}`. الخطوة الأولى `voice-settings`.

  ## خطوة بخطوة

  <Steps>
    <Step title="الخطوة 1: الإعدادات الصوتية">
      اختَر صوتاً من **مُنتقي الصوت** (6 مَزوِّدين، أكثر من 50 صوتاً، بحث وفلترة)، اضبط **اللُغَة**، اكتب **التَعليمات الأساسية** (موجِّه الصوت)، اضبط **سرعة الكلام**، **درجة حرارة الصوت**، و7 حقول متَقدِّمة (الحد الأدنى لمدة الصمت، إنهاء المكالمة عند الصمت، الحد الأقصى لمدة المكالمة، الحد الأدنى لمدة الكلام، تأخير ظهور الويدجت، مفتاح طلب الملاحظات)، واختَر **صوتاً خلفياً** (5 خيارات أمبيانس مع شدة الصوت).

      حقل **اسم الوكيل** يَعيش هنا (الصوتي فقط يَتخطَّى الإعدادات النصية كلياً، فيَنتقِل الاسم لهذه الخطوة).

      **مطلوب للمتابعة**: اسم الوكيل، التَعليمات الأساسية (حد أقصى 2,500 حرف).

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Voice-Settings)
    </Step>

    <Step title="الخطوة 2: المظهر">
      صَمِّم ويدجت الصوت: الألوان، الشعار، الأيقونة، أيقونة المُطلِق، الموضع، نَص شاشة الصوت لكل لُغَة، تَقييمات ما بعد المكالمة، الخط.

      النوع الصوتي ليس فيه حقول نَص شاشة الشات. تَستبدلها شاشة الصوت: التَحية، رسالة الاتصال، النص النائب أثناء المكالمة، رسالة إنهاء المكالمة، بالإضافة إلى تَسميات خاصة بالصوت.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Appearance)
    </Step>

    <Step title="الخطوة 3: قاعدة المعرفة">
      ارفع ملفات، أَضِف أسئلة شائعة، اِزحَف على روابط. نفس شكل النوع النصي. يَستخدمها الوكيل أثناء المكالمات للإجابة على الأسئلة.

      هذه الخطوة **اختيارية**.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Knowledge-Base)
    </Step>

    <Step title="الخطوة 4: التذاكر والعملاء المحتملين">
      اضبط جمع البيانات أثناء المكالمات. تبويب **الوكيل الصوتي** هو النشط (تبويب الوكيل النصي مَخفي للصوتي فقط).

      هذه الخطوة **اختيارية**.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Tickets-and-Leads)
    </Step>

    <Step title="الخطوة 5: التَكاملات والأدوات">
      نفس النوع النصي: السوق، MCP، أدوات الوكيل، أدوات API المخصَّصة، Webhooks.

      هذه الخطوة **اختيارية**.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Integrations-and-Tools)
    </Step>

    <Step title="الخطوة 6: النشر">
      تبويبان (التواصل مَخفي للصوتي فقط): **الموقع** (تَضمين لويدجت الصوت على صفحة ويب إن أردت مكالمات تَبدأ من الويب)، **الاتصالات الهاتفية** (4 بطاقات مَزوِّدين)، بالإضافة إلى بطاقة **حالة الوكيل** لـ**التَفعيل**.

      [المرجع الكامل للخطوة ←](/ar/Systems/AI-Agents/Wizard/Deployment)
    </Step>
  </Steps>

  ## ما يُخفيه معالج الصوتي (مقارنة بالهجين)

  الهجين هو المجموعة الأشمل. الصوتي يَقطع:

  * **الإعدادات النصية** (لا توجد خطوة شات فقط). حقل اسم الوكيل يَنتقِل لـالإعدادات الصوتية بدلاً من ذلك.
  * **مفتاح الشات** في لوحة المعاينة الحية. معاينة الويدجت تُظهِر دائماً عرض الصوت.
  * حقول **نَص شاشة الشات** في المظهر.
  * تبويب **التواصل** في النشر (لا WhatsApp / Messenger / Instagram / X / شات Telegram).
  * تبويب **النص** في التذاكر والعملاء المحتملين.

  ## مَزوِّدو الاتصالات

  تُعطيك خطوة النشر أربع بطاقات مَزوِّدين في شبكة من عمودَين:

  | بيانات الاعتماد                                   | الاتجاه                        | المَزوِّد            |
  | ------------------------------------------------- | ------------------------------ | -------------------- |
  | معرف الحساب SID، رمز المصادقة                     | واردة / صادرة / ثنائية الاتجاه | **Twilio**           |
  | مفتاح API                                         | واردة / صادرة / ثنائية الاتجاه | **Telnyx**           |
  | لا شيء، يُولِّد النظام عنوان SIP تُوجِّه إليه PBX | واردة / صادرة / ثنائية الاتجاه | **SIP Trunk**        |
  | معرف رقم الهاتف، رمز الوصول                       | واردة فقط (اليوم)              | **مكالمات WhatsApp** |

  كل مَزوِّد يَدعم حد أقصى **10 أرقام هواتف أو تَحويلات** بنوع **رقم هاتف** أو **تَحويلة**.

  ## اختبر قبل الشحن

  سطحان للاختبار:

  1. **في المعالج**، لوحة المعاينة على اليَمين تُظهِر ويدجت الصوت. اضغط زر المكالمة للاتصال بالوكيل. أول مكالمة تَتطلَّب صلاحية الميكروفون لـ`app.wittify.ai`.
  2. **بعد أول حفظ**، زر **اختبار الوكيل** في الشريط العلوي لكل صفحة من إدارة الوكيل. نفس التَدفُّق، لكن على واجهة إدارة وكيل حقيقية. [اقرأ المزيد ←](/ar/Systems/AI-Agents/Manage-Agent/Test-Your-Agent)

  ## التَفعيل

  عندما تُحفَظ كل الخطوات التي تَهتم بها، اِنتقِل إلى **الخطوة 6: النشر** وانظر بطاقة **حالة الوكيل**. اضغط **تفعيل الوكيل** (أخضر، أيقونة صح). يَذهب الوكيل للحياة ويَبدأ الرد على المكالمات على كل خط مَزوِّد مُتَّصِل. الإشعار: *تم تفعيل الوكيل.*

  المكالمات الواردة وثنائية الاتجاه تَبدأ بالرد لحظة وصول مكالمة لرقم مُتَّصِل. الحملات الصادرة تُجَدوَل بشكل منفصل، انظر [حملات الاتصال الصادر](/ar/Systems/AI-Agents/Manage-Agent/Outbound-Voice-Campaigns).

  ## أسئلة شائعة

  <AccordionGroup>
    <Accordion title="وكيلي الصوتي لا يَتحدَّث عند اختبار المكالمة.">
      ثلاثة فحوصات: (1) اخترت صوتاً في مُنتقي الصوت في الخطوة 1، (2) التَعليمات الأساسية غير فارغة، (3) صلاحية الميكروفون مُمنَوحة لـ`app.wittify.ai`. الويدجت تُظهِر تَلميح "اضغط للحديث" عند انتظار الإدخال.
    </Accordion>

    <Accordion title="الوكيل يَتحدَّث بسرعة.">
      اضبط **سرعة الكلام** في **الإعدادات الصوتية المتَقدِّمة** في الخطوة 1. الافتراضي 1.0، خَفِّضها إلى 0.85-0.9 لكلام أبطأ. النِطاق الصالح من 0.5 إلى 2.0.
    </Accordion>

    <Accordion title="المكالمات تَتَّصِل لكن الوكيل لا يَرد أبداً.">
      راجع بطاقة **حالة الوكيل** في الخطوة 6، الوكيل **مسوَّدة** حتى تَضغط تَفعيل. فَعِّل، أَجرِ مكالمة اختبار مرة أخرى.
    </Accordion>

    <Accordion title="Twilio رَفَض معرف المتَّصِل.">
      Twilio يَتطلَّب معرفات متَّصِل مُوثَّقة للصادرة. في وحدة تَحكُّم Twilio، وَثِّق الرقم الذي تَستخدمه كمعرف متَّصِل، ثم حاول مرة أخرى من المعالج.
    </Accordion>

    <Accordion title="هل أستطيع تَسجيل المكالمات؟">
      المكالمات الصوتية مُسجَّلة افتراضياً للنَسخ ومُلخَّص الذكاء الاصطناعي. التَسجيلات قابلة للوصول في [محادثات الصوت](/ar/Systems/AI-Agents/Manage-Agent/Voice-Conversations) بعد انتهاء كل مكالمة.
    </Accordion>

    <Accordion title="لماذا تبويب نشر التواصل مفقود؟">
      الوكلاء الصوتيون فقط لا يَستطيعون أَخذ زوار شات. تبويب التواصل مَخفي لأنه لا شيء لتَوصيله. إن احتجت شات أيضاً، احذف هذا الوكيل وأَنشِئ هجيناً.
    </Accordion>
  </AccordionGroup>

  ## التالي

  <CardGroup cols={2}>
    <Card title="افتح الخطوة 1" icon="play" href="/ar/Systems/AI-Agents/Wizard/Voice-Settings">
      ابدأ من الإعدادات الصوتية.
    </Card>

    <Card title="رؤية محادثات الصوت" icon="phone" href="/ar/Systems/AI-Agents/Manage-Agent/Voice-Conversations">
      حيث تَعيش المكالمات والتَسجيلات.
    </Card>
  </CardGroup>
</div>