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

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

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

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

## إنشاء أداة

<Steps>
  <Step title="انقر على أداة جديدة واختر وضعًا">
    * **وضع الوكيل** — تشغّل الأداة دائمًا وكيلًا واحدًا تختاره من
      القائمة المنسدلة. وهو أبسط إعداد.
    * **وضع Webhook** — في كل جلسة للأداة، يستدعي ThunderPhone
      عنوان URL الخاص بـ webhook لديك، ويعيد خادمك إعداد الوكيل
      لذلك الزائر (توجيه حسب الصفحة، مستخدمون سجّلوا الدخول، عمليات طرح تدريجية).
      اترك عنوان URL فارغًا لاستخدام webhook الافتراضي لمؤسستك؛
      وعند إدخال عنوان URL جديد، يمكنك أيضًا تعيينه كإعداد افتراضي للمؤسسة.
  </Step>

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

  <Step title="سمِّها، فعِّلها، وأنشئها">
    يتحكم مفتاح التبديل **تفعيل الأداة** في قبول المفتاح
    للجلسات — يمكنك إنشاء أداة معطّلة وتفعيلها عند الإطلاق.
  </Step>
</Steps>

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

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

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

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

<Note>
  المفاتيح القابلة للنشر (`pk_live_…`) عامة بطبيعتها — ويمكن تضمينها
  بأمان في رمز الواجهة الأمامية. انسخ أيًا منها في أي وقت باستخدام زر النسخ في صفه.
</Note>

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

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

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

تظهر جلسات الأدوات في [سجل المكالمات](/ar/guides/review-calls) مع
النص المفرغ والتسجيل والتقييم نفسها الخاصة بالمكالمات الهاتفية.

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

<CardGroup cols={2}>
  <Card title="مرجع SDK للأداة" icon="window-maximize" href="/ar/widget/overview">
    تفاصيل مكوّن React، والخطاف بدون واجهة، ونص CDN البرمجي.
  </Card>

  <Card title="التوجيه في وضع Webhook" icon="bolt" href="/ar/guides/dynamic-call-config">
    أعد إعداد وكيل لكل زائر من خادمك.
  </Card>
</CardGroup>