---
title: "مقدمة"
description: "وثائق لتشغيل وكلاء صوتيين جاهزين للإنتاج عبر مكالمات هاتفية حقيقية وعناصر واجهة ويب قابلة للتضمين: بدايات سريعة وأدلة ومرجع ThunderPhone API الكامل."
---

يتيح لك 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 وخطاف بلا واجهة
    ووسم نص برمجي لـ 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 القياسي للرمز الحامل مع
مفتاح API للمؤسسة بصيغة `sk_live_`. يحدد مفتاحك المؤسسة
المستهدفة تلقائيًا — لا يوجد معرّف مؤسسة في مسارات URL. راجع
[المصادقة](/api-reference/introduction) للتفاصيل.

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