تتيح أداة ElevenLabs لزوار الموقع طرح أسئلة بصوتهم. هذا الدليل لمن يدير الصفحة ووكيل ElevenLabs معاً. يغطي إعداد أسئلة شائعة عامة ومحدودة النطاق، من إعداد الوكيل إلى فحص الصفحة المنشورة، ثم يوضح فحص الوصول وسجلات المحادثات والاستخدام. تستند الخطوات إلى وثائق ElevenLabs التي فُحصت في 20 أكتوبر 2026. لم تنشئ BIG CHANGE وكيلاً، ولم تُدرج الأداة أو تُجرِ مكالمة اختبار.
التغيير الأبرز
- ما الذي تغيّر: توثّق ElevenLabs أداة للمواقع تعمل مع وكيل ElevenAgents عام، ويكون الصوت وضعها الافتراضي.
- كيف تعمل: تحمّل الصفحة عنصراً مخصصاً باستخدام معرّف الوكيل الظاهر. وتحدد قائمة أسماء المضيفين المسموح بها في الوكيل مصادر المواقع التي يمكنها الاتصال.
- لماذا يهم ذلك: يستطيع مالك الموقع فحص مسار مساعدة صوتية للزائر على صفحة واحدة، لكن عليه الموافقة على المعلومات العامة وإشعار الزائر ورسوم المكالمات المحتملة قبل إتاحته. ولا تحدد قائمة أسماء المضيفين هوية كل زائر.
جهّز أسئلة شائعة عامة واختباراً صغيراً
تحتاج إلى إذن بإدارة وكيل ElevenLabs واحد وتحرير صفحة واحدة في الموقع ونشرها. جهّز صفحة HTTPS ومتصفحاً بميكروفون يعمل، وشخصاً يستطيع اعتماد الأسئلة الشائعة والاستماع إلى إجاباتها. يجب أن تسمح أداة نشر الموقع بالعنصر المخصص والبرنامج النصي الموثّقين؛ استخدم طريقتها الحالية لإضافة HTML مخصص. المثال أدناه هو شفرة الإدراج العادية بلغة HTML التي يوفرها المزوّد، وليس تعليمات تثبيت خاصة بمنصة معينة.
دوّن بضع حقائق عامة معتمدة يمكن للوكيل الإجابة عنها، مع وسيلة للتواصل مع شخص عند ورود طلب خارج النطاق. اختر سؤالاً توجد إجابته ضمن تلك الحقائق وسؤالاً ينبغي للوكيل رفضه أو إحالته إلى شخص. أبقِ سجلات العملاء والسياسات الخاصة وتفاصيل الحساب وأسرار API خارج هذا الوكيل العام. حدد من يمكنه اعتماد صوت الموقع والإشعار الموجّه للزوار. تحقق من أن صوت ElevenLabs المختار وشروط حسابك يسمحان بالاستخدام المقصود في الموقع؛ فهذا الدليل لا يثبت حقاً تجارياً عاماً في استخدام أي صوت.
قبل أي اختبار صوتي، افحص خطة ElevenLabs الفعلية والرصيد المتبقي وإعداد الدفع حسب الاستخدام ومعلومات تكلفة النموذج المختار. تقول ElevenLabs إن إنشاء الوكيل مجاني، بينما تستهلك المكالمات الصوتية المتصلة من الاستخدام وقد تُحسب رسوم LLM بصورة منفصلة. قد تتجاوز مدة الاتصال مدة الكلام. احصل على موافقة الموقع على إنفاق مكالمات لوحة التحكم والموقع المنشور قبل بدء أي منهما. يقيّد الحد الزمني لكل مكالمة محادثة واحدة؛ ولا يمثل سقفاً للإنفاق الشهري.
اضبط الوكيل المخصص
- أنشئ وكيلاً عاماً منفصلاً للأسئلة الشائعة في لوحة تحكم ElevenLabs. استخدم إعداداً فارغاً أو قالباً معتمداً، ثم افحص المعرفة والأدوات الموروثة. أزل أي معرفة خاصة أو حجز أو CRM أو webhook أو إجراء آخر لا تحتاج إليه الأسئلة الشائعة العامة. حدد الغرض وحدود الإجابة من الحقائق المعتمدة، وأضف وسيلة التواصل مع شخص، واختر صوتاً ولغة مأذوناً لك باستخدامهما. لا تحوّل وكيلاً خاصاً موجوداً إلى هذه الأداة العامة بتعطيل مصادقته.
- ضمن Channels → Widget → Interface، اختر واجهة الصوت المقصودة وراجع النص والشروط الظاهرين للزوار. ويسمي الدليل الحالي جزءاً من ذلك أيضاً علامة تبويب Widget ، لذا تحقق من عناصر التحكم المحفوظة في لوحة التحكم. تتطلب طريقة الإدراج أدناه وكيلاً عاماً مع تعطيل المصادقة، وهو إعداد يضعه الدليل في Advanced. سيظهر معرّف الوكيل في مصدر الصفحة؛ وهو ليس سراً. أبقِ مفاتيح API والمعلومات الشخصية أو الخاصة بالزائر خارج شفرة الصفحة وتجاوزات إعدادات الأداة.
- في علامة التبويب Security الخاصة بالوكيل، أضف اسم مضيف الموقع المطابق تماماً إلى Allowlist، واحفظه ثم اقرأ الإعداد مجدداً. تقول ElevenLabs إنها تطابق أسماء المضيفين تماماً، وتسمح بعشرة كحد أقصى، وتتطلب إضافة كل نطاق فرعي بصورة منفصلة. لا تضف اسم مضيف اختبار محلياً إلا إذا احتجت فعلاً إلى ذلك المصدر للاختبار. تقيد القائمة موضع بدء الاتصال؛ ولا تصادق على هوية المتحدث.
- راجع عناصر خصوصية الوكيل للاحتفاظ بالنصوص وتخزين الصوت، واعتمد إشعار الزائر وإجراءات الموافقة المناسبة لموقعك. يمكن للأداة إظهار شروط يزودها المالك قبل المكالمة، لكن تلك الشاشة وإذن الميكروفون في المتصفح لا يحسمان الالتزامات القانونية لموقعك. ضمن Advanced → Call limits، اضبط واحفظ قيمة مناسبة للإعداد Max conversation duration. توثّق ElevenLabs قيمة افتراضية قدرها 600 ثانية ونطاقاً من 60 إلى 7,200 ثانية. اقرأ إعدادات الخصوصية والمدة والوصول المحفوظة مجدداً قبل اختبار قابل للفوترة.
أضف شفرة الإدراج إلى مسودة صفحة واحدة
ضع ما يلي في جسم الصفحة باستخدام وسيلة HTML المخصص أو البرامج النصية التي يدعمها موقعك. استبدل YOUR_PUBLIC_AGENT_ID بمعرّف الوكيل المخصص. احصر الإطلاق الأولي في الصفحة المعتمدة الواحدة.
<elevenlabs-convai agent-id="YOUR_PUBLIC_AGENT_ID"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>هذه هي شفرة إدراج الأداة الرسميةالحالية. عنوان URL لبرنامجها النصي غير مثبت على إصدار محدد؛ سجّل ما ثبّتّه وراجع الدليل عند صيانة الصفحة. في معاينة المسودة، تأكد من ظهور الأداة مرة واحدة ومن عدم حجبها عناصر تحكم أساسية في الصفحة. إذا كان موقعك يفرض Content Security Policy، فاطلب من المسؤول فحص طلبات البرنامج النصي أو الاتصال المحجوبة فعلياً وإجراء تعديل محدود يخضع للمراجعة. تعطيل السياسة أو إضافة محارف بدل واسعة ليس خطوة إعداد.
افحص الوكيل ثم مسار الزائر في الموقع المنشور
بعد مراجعة التكلفة والخصوصية، اطرح السؤال القابل للإجابة والسؤال الخارج عن النطاق في اختبار الصوت بلوحة التحكم. قارن الإجابات بالحقائق المعتمدة وحدود الإحالة إلى شخص. عدّل الوكيل واختبره مجدداً إذا كانت أي إجابة غير آمنة أو غير مدعومة. تؤكد مكالمة لوحة التحكم ذلك المسار وحده؛ ولا تثبت عمل الأداة المدرجة في الموقع.
اطلب من مالك الصفحة مراجعة المحتوى والإشعار والموضع ونتيجة الاختبار قبل النشر. على الصفحة المنشورة عند اسم المضيف المسموح به، افتح الأداة في متصفح، وامنح إذن الميكروفون عن قصد، واطرح السؤالين نفسيهما، واستمع إلى الإجابتين، ثم أنهِ المكالمة. تحقق من انطفاء مؤشر الميكروفون ومن بقاء الأداة قابلة للاستخدام في عرض بحجم هاتف. قارن ما قالته فعلياً بالإجابات المعتمدة؛ فطلاقة الإجابة لا تثبت صحة حقائقها. سجّل وقت الاختبار والوكيل لتتمكن من تتبع الاستخدام. هذا فحص يجريه القارئ، وليس نتيجة رصدتها BIG CHANGE.
افتح Call history للوكيل إذا كان إعداد الاحتفاظ المختار يحفظ سجلاً، وافحص المحادثة مقابل السؤالين. ضمن Analytics، رشّح النتائج إلى ذلك الوكيل وفترة زمنية ضيقة وراجع عدد المكالمات والمدة والتكلفة. هذه أرقام مجمّعة؛ ولا تكفي وحدها لإثبات أي مكالمة أنتجت رسوماً. إذا كان إعداد الاحتفاظ المعتمد يحذف سجلات المحادثات، فاحتفظ فقط بأقل ملاحظة يعتمدها المالك عن الإجابة المباشرة وراجع الاستخدام المجمّع المتاح. لا تمدد الاحتفاظ لمجرد إكمال هذا الفحص. غياب سجل محفوظ لا يثبت أن المكالمة مجانية.
إذا أخفق الفحص
إذا لم تظهر الأداة، فقارن شفرة الصفحة المنشورة فعلياً مع شفرة الإدراج الموثّقة، وافحص تكرار العناصر أو البرامج النصية وأخطاء البرنامج النصي أو CSP المحددة في المتصفح. إذا ظهرت دون أن تتصل، فاقرأ مجدداً إعداد المصادقة العامة للوكيل المخصص واسم المضيف المنشور المطابق في قائمة السماح وإذن الميكروفون والرصيد المتاح وأي خطأ في لوحة التحكم. إذا تعطل الصوت، فتحقق من الميكروفون المختار وإذن المتصفح وسياق الصفحة الآمن، ثم افحص سجل المكالمة المتاح. أنهِ الجلسة غير المؤكدة وافحص الاستخدام قبل دفع تكلفة محاولة أخرى.
إذا اختلق الوكيل إجابة أو خرج عن الأسئلة الشائعة، فأزل شفرة الإدراج من الصفحة أثناء تعديل الحقائق والتعليمات المعتمدة. كرر سؤالي لوحة التحكم والموقع المنشور قبل إعادتها. إذا تجاوز الاستخدام المعتمد، فأزل شفرة الإدراج وافحص التحليلات المرشحة وفوترة الحساب، ثم أعد النظر في مدة المحادثة ونطاق الإطلاق. تمنع إزالة شفرة هذه الصفحة تقديم مكالمات جديدة منها؛ ولا تثبت انتهاء مكالمة قائمة أو إزالة الوصول إلى الوكيل العام من مضيف آخر مسموح به.
لتطبيق صوتي محلي داخل المتصفح يبنيه مطوّر، يتناول دليلنا إلى OpenAI Realtime مهمة مختلفة. يستخدم هذا الدليل أداة ElevenLabs العامة المستضافة. يسرد دليل الأداة سمة signed-url في موضع آخر، لكن تعليمات الإدراج الأساسية تتطلب صراحة وكيلاً عاماً؛ ولا تمثل تلك السمة وحدها وصفة مختبرة لأداة خاصة.
المصادر وقراءات إضافية
- تخصيص أداة ElevenLabs: اشتراط الوكيل العام وعناصر الواجهة وشفرة الإدراج الحالية. عنوان URL للبرنامج النصي غير مثبت على إصدار محدد.
- مصادقة الوكيل: سلوك قائمة أسماء المضيفين المطابقة وحد العشرة مضيفين والتمييز عن مصادقة كل مستخدم.
- تدفق المحادثة و عناصر الخصوصية: إعدادات المدة والاحتفاظ وتخزين الصوت.
- البدء السريع مع ElevenAgents، Analytics و مساعدة التكاليف: اختبارات لوحة التحكم والسجل والاستخدام المجمّع وأساس احتساب الرسوم. تحدد شروط الحساب المخصصات والفاتورة الفعليتين.
