> ## 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.

# مقدمة

> يشغّل ThunderPhone وكلاء صوتيين جاهزين للإنتاج عبر مكالمات هاتفية حقيقية وعناصر واجهة ويب قابلة للتضمين. ابدأ من هنا.

يتيح لك ThunderPhone إنشاء وكلاء صوتيين بالذكاء الاصطناعي يجرون مكالمات هاتفية حقيقية ويجيبون عنها، ويدعمون محادثات يقودها الميكروفون على موقعك الإلكتروني.
تنقسم الوثائق إلى أربع علامات تبويب:

<CardGroup cols={2}>
  <Card title="الأدلة" icon="book" href="/ar/quickstart-dashboard">
    بدايات سريعة ومفاهيم وإرشادات عملية للوحة التحكم وواجهة API.
    **ابدأ من هنا** إذا كنت جديدًا.
  </Card>

  <Card title="مرجع API" icon="code" href="/api-reference/introduction">
    كل نقطة نهاية وحقل طلب وبنية استجابة.
  </Card>

  <Card title="الأداة المصغّرة" icon="window-maximize" href="/ar/widget/overview">
    الأداة المصغّرة القابلة للتضمين على الويب — مكوّن React وخطاف headless ووسم نص برمجي لـ CDN.
  </Card>

  <Card title="خطافات الويب" icon="bolt" href="/ar/webhooks/overview">
    أحداث في الوقت الفعلي، والتوقيع، ودلالات التسليم.
  </Card>
</CardGroup>

## ما الذي يمكنك إنشاؤه

<CardGroup cols={2}>
  <Card title="دعم هاتفي وارد" icon="phone">
    أجب عن المكالمات الواردة إلى رقم تملكه باستخدام وكيل ذكاء اصطناعي يتبع موجّهك،
    ويستخدم أدواتك، ويحوّل المكالمة إلى موظفين بشريين عند الحاجة.
  </Card>

  <Card title="حملات صادرة" icon="arrow-up-right">
    أجرِ مكالمات برمجيًا من شفرتك — لاستطلاعات الرأي أو المتابعة أو
    تدفقات التأكيد.
  </Card>

  <Card title="صوت داخل المتصفح" icon="microphone">
    أضف [الأداة المصغّرة للويب](/ar/guides/embed-web-widget) القابلة للتضمين إلى
    موقعك ليتمكن العملاء من النقر للتحدث. لا يلزم رقم هاتف.
  </Card>

  <Card title="وكلاء قائمون على الاختبار" icon="flask">
    شغّل سيناريوهات معدة مسبقًا عبر وكيلك على شكل [دفعات](/api-reference/test-calls)
    لاكتشاف حالات التراجع قبل أن يسمعها العملاء.
  </Card>
</CardGroup>

## طريقتان للبدء

**من لوحة التحكم** (موصى به لوكيلك الأول) — سجّل وأنشئ حسابًا، ثم
ترشدك لوحة التحكم عبر معالج إعداد من خمس خطوات: أنشئ وكيلاً،
وأعِد الفوترة، وأضف رقم هاتف، وشغّل محاكاة، وراجع
المكالمة. يعكس [البدء السريع للوحة التحكم](/ar/quickstart-dashboard)
هذا المعالج خطوة بخطوة.

**من الطرفية** — ينجز [البدء السريع لواجهة API](/ar/quickstart) المكالمة
الأولى نفسها عبر أربع استدعاءات REST.

<Steps>
  <Step title="تصفّح المفاهيم سريعًا">
    [المفاهيم](/ar/guides/concepts) — خريطة لكل كائن ستتعامل معه،
    ومكان وجود كل منها في لوحة التحكم.
  </Step>

  <Step title="شغّل بداية سريعة">
    [البدء السريع للوحة التحكم](/ar/quickstart-dashboard) أو
    [البدء السريع لواجهة API](/ar/quickstart) — أجرِ مكالمتك الأولى باستخدام وكيل
    ذكاء اصطناعي.
  </Step>

  <Step title="اختر دليلاً">
    اتبع [دليلًا عمليًا](/ar/guides/build-an-agent) يناسب
    سيناريوك، أو انتقل مباشرة إلى
    [مرجع API](/api-reference/introduction).
  </Step>
</Steps>

## استعرض الأدلة

<CardGroup cols={2}>
  <Card title="استخدام لوحة التحكم" icon="table-columns" href="/ar/guides/build-an-agent">
    أنشئ وكيلاً، وموّله، واحصل على رقم، وشغّل محاكاة، وراجع المكالمات.
  </Card>

  <Card title="ربط الأدوات والبيانات" icon="plug" href="/ar/guides/connect-apps">
    تطبيقات OAuth وواجهات API مخصصة وخوادم MCP وموفرو VoIP.
  </Card>

  <Card title="التحليل والتحسين" icon="chart-line" href="/ar/guides/reports">
    التقارير، وقابلية المراقبة، والتجارب، والمشكلات، والتنبيهات.
  </Card>

  <Card title="الفريق والحساب" icon="users" href="/ar/guides/invite-your-team">
    الدعوات والأدوار، ومفاتيح API، والأمان، وتسجيل الدخول الأحادي SSO.
  </Card>
</CardGroup>

## عنوان URL الأساسي

```
https://api.thunderphone.com/v1
```

تستخدم المصادقة مخطط OAuth 2.0 Bearer القياسي مع
مفتاح API للمؤسسة يبدأ بـ `sk_live_`. يحدد مفتاحك
المؤسسة المستهدفة تلقائيًا — لا يوجد معرّف مؤسسة في مسارات URL. راجع
[المصادقة](/api-reference/introduction) للتفاصيل.

<Note>
  تحتاج إلى مساعدة؟ أرسل بريدًا إلكترونيًا إلى [support@thunderphone.com](mailto:support@thunderphone.com).
</Note>