تخطَّ إلى المحتوى
تطبيقات الويب والجوال

API وكلاء صوتيين لتطبيقات الويب والجوال

إضافة وكيل صوتي إلى تطبيق تعني عادةً شراء رقم هاتف لا تحتاجه، أو ربط تحويل الكلام إلى نص ونموذج وصوت بنفسك مع إبقاء مفاتيح API بعيدًا عن الجهاز. لفرق المنتجات التي تريد وكيلًا صوتيًا داخل تطبيقها بدل خط هاتفي: الوكلاء والمحركات وقواعد المعرفة وحجز المواعيد نفسها التي ترد على المكالمات الهاتفية، يمكن الوصول إليها من تبويب متصفح أو تطبيق جوال عبر wss://api.voice.wixzel.com/v1/realtime. لا شيء لتربطه، ولا رقم لتشتريه. يُصدر خادمك جلسة للاستخدام مرة واحدة فلا يصل مفتاح API الخاص بك إلى العميل أبدًا، وتستهلك الجلسة من الرصيد المسبق الدفع نفسه بالثانية مثل مكالمة على المحرك نفسه.

آخر تحديث

شاشة تطبيق هاتف فيها شخصية تعريفية خضراء كبيرة، وتحية في فقاعة كلام فوقها، وزر «تحدّث» أسفلها

كيف تبني وكيل صوتي لتطبيق ويب أو جوال باستخدام Wixzel Voice؟

  1. 01
    POST /v1/agents

    أنشئ الوكيل: التعليمات وجملة الافتتاح وقاعدة المعرفة ومحرك صوت. إنه الوكيل نفسه الذي تصل إليه المكالمة الهاتفية.

  2. 02
    POST /v1/realtime/sessions

    من خادمك، بمفتاح API الخاص بك: حدّد الوكيل، واختياريًا أصول المتصفح المسموح بها (origins) وبياناتك الوصفية الخاصة، لتحصل على client_secret يعمل مرة واحدة، لمدة دقيقة واحدة، لذلك الوكيل.

  3. 03
    wss://api.voice.wixzel.com/v1/realtime

    يفتح تطبيقك المقبس (socket) بالرمز السري ويبث الصوت. في المتصفح، يتولى RealtimeSession من wixzel-voice/realtime الميكروفون والتشغيل والمقاطعة؛ وفي Flutter، يتحدث RealtimeConnection من حزمة wixzel_voice بالبروتوكول ويوفّر تطبيقك الميكروفون ومكبر الصوت.

  4. 04
    GET /v1/calls/{id}

    كل جلسة سجل مكالمة بقناة web: النص المكتوب والمدة والتكلفة وبياناتك الوصفية، مع webhook callCompleted نفسه عند انتهائها.

  5. 05
    wixzel-voice/mascot, wixzel_voice_flutter

    اختياري: اعرض الشخصية التعريفية (mascot) للوكيل، وهي وجهه المتحرك، أثناء حديثه. في صفحة ويب، يرسمها mountMascot من wixzel-voice/mascot ويشغّل face.connect(session) المكالمة مع تزامن حركة الفم. في Flutter، يرسمها AgentMascotView من حزمة wixzel_voice_flutter ويُبقيها MascotRealtimeLink متزامنة مع RealtimeConnection.

أي محرك صوتي يناسب وكيل صوتي في تطبيق ويب أو جوال؟

استخدم محرك gemini-live على Wixzel Voice، بسعر $0.0491 لكل دقيقة متصلة. نموذج فوري واحد يتولى الاستماع والتفكير والكلام، فزمن الرد هو ما يقدمه Gemini نفسه، وهو أرخص محرك في الدقيقة. يعمل مسار sarvam عبر المقبس أيضًا للغات الهند، وكذلك classic عندما تحتاج صوتًا محددًا من ElevenLabs.

كم تكلفة وكيل صوتي في تطبيق ويب أو جوال على Wixzel Voice؟

وقت المحرك على Wixzel Voice لجلسات مدتها 4 دقائق على محرك gemini-live، بمعدلات الكلام المعتادة، ويُحتسب بالثانية من الاستخدام الفعلي. لا توجد تكلفة اتصالات لأنه لا يوجد خط هاتف، والجلسات الأقصر تكلّف أقل بالنسبة نفسها.

الجلسات شهريًاالدقائق المتصلةتكلفة المحرك شهريًا
5002,000$98.20
2,50010,000$491
10,00040,000$1,964

مسبق الدفع: أضف رصيدًا بدءًا من $5 وتستهلكه الجلسات. قدّر مزيج استخدامك.

ما الأدلة التي تشرح كيفية بناء وكيل صوتي لتطبيق ويب أو جوال على Wixzel Voice؟

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

هل يمكنني وضع وكيل صوتي مبني على Wixzel Voice في موقعي أو تطبيق الجوال الخاص بي؟

نعم. يستدعي خادمك POST /v1/realtime/sessions بمفتاح API الخاص بك ويتلقى client_secret؛ ثم تفتح صفحتك أو تطبيقك wss://api.voice.wixzel.com/v1/realtime به وتبث الصوت في الاتجاهين. الوكيل والمحرك والتعليمات وقاعدة المعرفة هي نفسها التي تستخدمها المكالمة الهاتفية. لا حاجة إلى SIP trunk ولا إلى رقم هاتف.

هل يحتاج المتصفح أو التطبيق إلى مفتاح API الخاص بي؟

لا، ويجب ألا يحصل عليه أبدًا. لا يحمل العميل إلا client_secret يُصدره خادمك، ويعمل مرة واحدة، لمدة دقيقة واحدة، لوكيل واحد. للمتصفحات، مرّر allowed_origins عند إصداره فيُرفض المقبس من أي موقع آخر، وبذلك يصبح الرمز السري المنسوخ من صفحتك عديم الفائدة في أي مكان آخر.

ما حزم SDK التي تدعم API الفوري (realtime)؟

حزمة TypeScript SDK (wixzel-voice على npm) تتضمن عميلًا للمتصفح، RealtimeSession، يطلب الوصول إلى الميكروفون، ويرمّز الصوت ويشغّله، ويتعامل مع مقاطعة المستخدم للوكيل. وحزمة Dart SDK (wixzel_voice على pub.dev) تتضمن RealtimeConnection لـ Flutter وDart، التي تتحدث بالبروتوكول بينما يوفّر تطبيقك الميكروفون ومكبر الصوت. أي بيئة أخرى تستخدم البروتوكول مباشرة: إطارات JSON عبر WebSocket، والصوت بترميز base64 G.711 µ-law بتردد 8 kHz.

ما جودة الصوت في جلسات الويب والتطبيقات؟

جودة الهاتف. الصوت G.711 µ-law بتردد 8 kHz في الاتجاهين، مثل خط الهاتف، لأن الجلسات تمر عبر مسار الوسائط نفسه الذي تمر به المكالمات. هذا يكفي للكلام، وهو قيد حقيقي مقارنة بالمنصات التي يكون صوت المتصفح فيها عريض النطاق؛ نذكره هنا بدل أن تكتشفه لاحقًا.

كيف تُحتسب جلسة الويب أو التطبيق؟

تمامًا مثل مكالمة هاتفية على المحرك نفسه: سعر الدقيقة نفسه، من الرصيد المسبق الدفع نفسه، بالثانية، ومفصّلة في GET /v1/usage/events. لا توجد تكلفة اتصالات لأنه لا يوجد خط هاتف. تُحتسب الجلسة ضمن حد المكالمات المتزامنة للحساب، وهو خمس افتراضيًا. إصدار الجلسة لا يكلّف شيئًا، فالمستخدم الذي يفتح صفحتك ويرفض الوصول إلى الميكروفون لا يكلّفك شيئًا.

كم يمكن أن تستمر الجلسة؟

عشر دقائق افتراضيًا. حدّد max_duration_seconds عند إصدار الجلسة، من 10 ثوانٍ إلى ساعة، وسينهي الخادم الجلسة عند ذلك الحد. ويمكن للوكيل أيضًا إنهاؤها، وكذلك تطبيقك.

هل يعمل في Flutter؟

نعم. يتولى RealtimeConnection في Dart SDK المقبس والبروتوكول. يسجّل تطبيقك صوت PCM بدقة 16 بت وبتردد 8 kHz بأي إضافة تسجيل، ويحوّله إلى µ-law بالدالة المساعدة التي توفرها SDK، ويشغّل صوت الوكيل بأي مشغّل PCM. فعّل إلغاء الصدى، وإلا سيسمع الوكيل صوته عبر مكبر الصوت.

هل يمكن أن يعرض تطبيقي وجه الوكيل أثناء حديثه؟

نعم. لكل وكيل في Wixzel Voice شخصية تعريفية (mascot)، وهي وجه متحرك يُرسم من مواصفات صغيرة في حقل mascot الخاص بالوكيل. في صفحة ويب، يرسمها mountMascot من wixzel-voice/mascot (wixzel-voice 0.10.0 على npm) على canvas، ويبدأ face.connect(session) المكالمة الفورية مع تحرك الفم متزامنًا مع صوت الوكيل. في Flutter، تحتوي حزمة wixzel_voice_flutter على pub.dev على AgentMascotView لرسمها وMascotRealtimeLink لجعلها تستمع وتفكر وتتحدث مع RealtimeConnection. لا تسجّل أيٌّ منهما الصوت ولا تشغّله نيابةً عنك في Flutter؛ أما أداة الويب فتقوم بالأمرين.

هل توجد نسخة لا تحتاج إلى أي برمجة؟

نعم، للمواقع: أداة الشخصية التعريفية (widget). فعّلها للوكيل، وأدرج موقعك في embed_origins، والصق وسم script واحدًا، فيتمكن الزوار من الاتصال بالوكيل من زاوية الصفحة. تستخدم API الفوري نفسه في الخلفية وتُحتسب بالطريقة نفسها. راجع صفحة المساعد الصوتي بالذكاء الاصطناعي لموقعك.

ماذا تبني الوكالات والمطوّرون أيضًا على Wixzel Voice؟

حجز المواعيد

ابنِ وكيلًا يرد على الهاتف ويتحقق من المواعيد المتاحة ويحجز موعدًا، عبر SIP trunk الخاص بك، ويُسجَّل الحجز عبر API.

تأهيل العملاء المحتملين بالمكالمات الصادرة

ارفع قائمة العملاء المحتملين، وابدأ حملة، ودع وكيلًا يتصل بكل واحد منهم عبر SIP trunk الخاص بك ويطرح أسئلة التأهيل التي تحددها. كل مكالمة سجل يتضمن حالتها ونصها المكتوب، ومرتبط بالعميل المحتمل.

خط دعم للمكالمات الواردة

رُدّ على رقم الدعم بوكيل يقرأ من قاعدة معرفة ترفعها، ويتعامل مع الأسئلة الشائعة، ويترك نصًا مكتوبًا لكل مكالمة.

لغات الهند

شغّل وكلاء الهاتف بلغات الهند على نماذج مصممة لها، مع محرك sarvam الذي يغطي تحويل الكلام إلى نص والنموذج اللغوي وتحويل النص إلى كلام من البداية إلى النهاية.

مساعد صوتي للموقع

ضع مساعدًا يتحدث بالذكاء الاصطناعي على موقعك بوسم script واحد: وكيل مصنوع من موقعك، مع شخصية تعريفية متحركة يتصل بها الزوار من المتصفح، وبيانات المتصلين، وإعدادات من يحق له الاتصال، وحدود يومية.

مكالمات هاتفية من وكلاء الذكاء الاصطناعي

اربط Claude Code أو Codex أو Cursor أو أي عميل MCP بحسابك، ودع وكيل ذكاء اصطناعي يربط مزوّد اتصالات، ويبني وكيلًا صوتيًا، ويجري المكالمات، ويشغّل الحملات، ويقرأ النصوص المكتوبة، مع طلب الإذن أولًا في كل أداة تنفق المال.

مكالمات ذكاء اصطناعي منخفضة التكلفة

أجرِ مكالمات هاتفية بالذكاء الاصطناعي ببضعة سنتات في الدقيقة: احتساب بالثانية من رصيد مسبق الدفع، بلا اشتراك ولا حد أدنى، عبر SIP trunk الخاص بك دون أي هامش على الاتصالات، مع تفصيل كل رسم.

أفاتار ذكاء اصطناعي يتحدث

امنح الوكيل الصوتي وجهًا: أفاتار متحرك تتزامن حركة شفاهه مع كلام الوكيل، لموقع ويب أو رابط مشاركة أو تطبيق ويب أو تطبيق Flutter، دون رسوم على الأفاتار.

للوكالات

ابنِ وكيلًا هاتفيًا لكل عميل على حسابه ولدى مزوّد الاتصالات الخاص به، وبلغته، وتقاضَ رسومًا شهرية ثابتة فوق تكلفة تُحتسب بالثانية.

كل حقائق Wixzel Voice

المشغّل والأسعار والحدود والاسترداد وموقع البيانات، في صفحة واحدة.