إنشاء أداة ويب في لوحة التحكم

أعِدّ أداة نقر للتحدث لموقعك من صفحة أدوات الويب — دون الحاجة إلى أي استدعاءات API.

تُنشئ صفحة أدوات الويب (/dashboard/web-widgets) وتدير المفاتيح القابلة للنشر التي تشغّل أداة ThunderPhone الصوتية القابلة للتضمين. كل ما يفعله إصدار API من هذا الدليل باستخدام cURL، تفعله هذه الصفحة عبر نموذج — بالإضافة إلى أنها تنشئ رمز التضمين نيابةً عنك.

إنشاء أداة#

1. انقر على أداة مصغّرة جديدة واختر وضعًا
   • وضع الوكيل — تشغّل الأداة المصغّرة دائمًا وكيلًا واحدًا تختاره من القائمة المنسدلة. وهو أبسط إعداد.
   • وضع Webhook — في كل جلسة للأداة المصغّرة، يستدعي ThunderPhone رابط Webhook الخاص بك ويعيد خادمك إعدادات الوكيل لذلك الزائر (توجيه حسب الصفحة، والمستخدمون المسجّل دخولهم، وعمليات الإطلاق التدريجي). اترك الرابط فارغًا لاستخدام Webhook الافتراضي لمؤسستك؛ وعند إدخال رابط جديد، يمكنك أيضًا تعيينه كإعداد افتراضي للمؤسسة.
2. أدرج النطاقات المسموح بها

   يلزم نطاق واحد على الأقل، ولا يمكن للمتصفحات بدء الجلسات إلا من أسماء المضيفين التي تدرجها. يُسمح برموز البدل للنطاقات الفرعية مثل *.example.com (تطابق النطاقات الفرعية، وليس النطاق الأساسي)؛ بينما تُرفض رموز البدل الأساسية مثل *. تمنع القائمة إعادة الاستخدام العرضي لمفتاحك على مواقع أخرى، لكنها ليست مصادقة: إذ يمكن لبرنامج نصي خارج المتصفح إرسال أي ترويسة Origin. لا يُسمح بـ localhost تلقائيًا في بيئة الإنتاج؛ أضفه إلى القائمة للاختبار محليًا باستخدام واجهة برمجة التطبيقات للإنتاج.

3. اختر تجاوزات المتصفح

   حدّد كل إعداد جلسة ترسله صفحتك: سياق الصفحة، المتغيرات، الصوت، اللغة. لا تقبل الأدوات المصغّرة الجديدة أيًا منها، ويفشل طلب الجلسة الذي يحمل إعدادًا معطّلًا بالرمز 400. مفتاحك عام، لذا اسمح فقط بما تستخدمه. راجع تجاوزات المتصفح.

4. سمِّها، ومكّنها، وأنشئها

   يتحكم مفتاح التبديل تمكين الأداة المصغّرة في ما إذا كان المفتاح يقبل الجلسات — يمكنك إنشاء أداة مصغّرة معطّلة ثم تفعيلها عند الإطلاق.

احصل على رمز التضمين#

بعد الإنشاء مباشرةً (أو عبر زر تضمين في كل صف)، تنشئ نافذة التضمين رمزًا جاهزًا للّصق مع إدراج مفتاحك القابل للنشر فيه:

• React — مقتطف <ThunderPhoneWidget /> لتطبيقات أدوات التجميع.
• وسم Script — زوج من <script> عبر CDN وورقة أنماط لأي موقع.

تعرض النافذة أيضًا معاينة لخيارات المظهر الأساسية — العنوان، واللون الأساسي، وموضع الزاوية، والمظهر الفاتح/الداكن — وتضمّن اختياراتك في المقتطف. للاطلاع على المرجع الكامل للخصائص، وخطافات التنسيق، وخيار بدون واجهة، راجع وثائق SDK للأداة.

إدارة الأدوات من القائمة#

يُعدَّل كل صف في مكانه:

• الوضع / الوكيل — بدّل بين وضع الوكيل ووضع webhook، أو غيّر الوكيل، باستخدام قوائم اختيار مضمنة.
• النطاقات — أضف النطاقات المسموح بها أو أزلها كشرائح.
• تفعيل/تعطيل — مفتاح تبديل لكل أداة؛ تتوقف الأدوات المعطّلة عن قبول الجلسات فورًا.
• النقل إلى مؤسسة — انسخ الأداة أو انقلها إلى مؤسسة أخرى تنتمي إليها (يؤدي نقلها إلى إزالتها من هنا).
• حذف — يلغي المفتاح القابل للنشر؛ وتتوقف الأداة عن العمل فورًا على جميع النطاقات. لا يمكن التراجع عن ذلك.

تظهر جلسات الأدوات في سجل المكالمات مع النص المفرغ والتسجيل والتقييم نفسها الخاصة بالمكالمات الهاتفية.

الخطوات التالية#