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

​
إنشاء أداة

1

انقر على أداة جديدة واختر وضعًا

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

أدرج النطاقات المسموح بها

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

سمِّها، فعِّلها، وأنشئها

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

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

بعد الإنشاء مباشرةً (أو عبر زر تضمين في كل صف)، تنشئ نافذة التضمين رمزًا جاهزًا للّصق مع إدراج مفتاحك القابل للنشر فيه:
  • React — مقتطف <ThunderPhoneWidget /> لتطبيقات أدوات التجميع.
  • وسم Script — زوج من <script> عبر CDN وورقة أنماط لأي موقع.
تعرض النافذة أيضًا معاينة لخيارات المظهر الأساسية — العنوان، واللون الأساسي، وموضع الزاوية، والمظهر الفاتح/الداكن — وتضمّن اختياراتك في المقتطف. للاطلاع على المرجع الكامل للخصائص، وخطافات التنسيق، وخيار بدون واجهة، راجع وثائق SDK للأداة.
المفاتيح القابلة للنشر (pk_live_…) عامة بطبيعتها — ويمكن تضمينها بأمان في رمز الواجهة الأمامية. انسخ أيًا منها في أي وقت باستخدام زر النسخ في صفه.

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

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

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

مرجع SDK للأداة

تفاصيل مكوّن React، والخطاف بدون واجهة، ونص CDN البرمجي.

التوجيه في وضع Webhook

أعد إعداد وكيل لكل زائر من خادمك.