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

# الحملات الصادرة

> حمّل قائمة جهات اتصال ودع وكيلًا يعمل عليها — مع نوافذ اتصال، وإعادات محاولة، وتقدّم مباشر.

تتصل الحملات بقائمة جهات اتصال نيابةً عنك: اختر وكيلاً صوتياً، وحمّل
ملف CSV، وحدد متى يُسمح بالاتصال، وسيتابع ThunderPhone العمل عبر القائمة
— مع إعادة محاولة حالات عدم الرد والبريد الصوتي وفق الجدول الذي تختاره. اعثر
عليها ضمن **التفاعل ← الحملات** (`/dashboard/campaigns`).

لإجراء مكالمات برمجية لمرة واحدة، استخدم
[واجهة برمجة التطبيقات للمكالمات الصادرة](/ar/guides/place-outbound-calls) بدلاً من ذلك.

## المتطلبات الأساسية

* وكيل صوتي منشور.
* **رقم هاتف VoIP** متصل بمؤسستك لإجراء المكالمات ابتداءً منه —
  أرقام العرض التوضيحي مخصصة للمكالمات الواردة فقط ولا يمكنها إجراء مكالمات الحملات. راجع
  [توصيل مزود VoIP](/ar/guides/voip-providers).
* جهات الاتصال في ملف CSV (أو JSON ملصق) يحتوي على عمود `phone` أو
  `phone_number`. **حتى 5,000 صف لكل تحميل**، بترميز UTF-8.
  تُحتفظ بأي أعمدة إضافية كمتغيرات لكل جهة اتصال في سجلات
  جهات اتصال الحملة.

## إنشاء حملة

<Steps>
  <Step title="انقر على حملة جديدة">
    سمِّها، واختر **الوكيل الصوتي**، واختر **رقم «ابتداءً من»**
    (أحد أرقام VoIP الخاصة بك).
  </Step>

  <Step title="حمّل ملف CSV لجهات الاتصال">
    تُرفض الصفوف التي تحتوي على رقم هاتف غير صالح بشكل منفصل، ويُبلّغ
    عن أرقام صفوفها — بينما تُستورد بقية الصفوف بشكل سليم.
  </Step>

  <Step title="حدّد نافذة الاتصال">
    اختر **منطقة زمنية** ونافذة **بدء/انتهاء يومية**؛ ولا تُجري الحملة
    اتصالات إلا ضمنها. يمكن أن تمتد النوافذ عبر منتصف الليل (مثلاً 22:00 → 02:00).
    يمكنك اختيارياً تعيين **وقت البدء** لجدولة الإطلاق و
    **وقت الانتهاء** الذي تكتمل الحملة تلقائياً بعده.
  </Step>

  <Step title="اضبط الوتيرة وإعادات المحاولة">
    * **المكالمات المتزامنة** — عدد المكالمات التي تُجريها هذه الحملة في الوقت نفسه
      (1–10، الافتراضي 3). كما أن مؤسستك محددة بحد أقصى **10
      مكالمات صادرة متزامنة** عبر كل شيء، لذا تشترك
      الحملات المتوازية في هذه السعة.
    * **الحد الأقصى للمحاولات** — عدد المرات التي يمكن فيها الاتصال بكل جهة اتصال
      (الافتراضي 2).
    * **تأخير إعادة المحاولة (بالدقائق)** — مدة الانتظار قبل إعادة المحاولة (الافتراضي 60).
    * **إعادة المحاولة عند** — النتائج التي تؤدي إلى إعادة المحاولة: **لا رد**،
      **بريد صوتي**، **فشل** (كلها مفعلة افتراضياً).
  </Step>

  <Step title="أنشئ مسودة، ثم ابدأ">
    تُنشأ الحملات كمسودات — ولا يمكن إضافة جهات الاتصال إلا عندما تكون
    الحملة مسودة. يتطلب بدء الحملة موافقة صريحة على رسوم
    المكالمات. مع تعيين **وقت بدء** مستقبلي تصبح الحملة
    *مجدولة*؛ وإلا تبدأ *قيد التشغيل* فوراً.
  </Step>
</Steps>

## كيفية عمل النتائج وإعادات المحاولة

بعد كل مكالمة، تحصل جهة الاتصال على نتيجة — وتُعلَّم المكالمات الناجحة
كمكتملة؛ وتُعاد محاولة مكالمة صُنفت على أنها بلا رد، أو اكتُشف أنها بريد صوتي، أو
فشلت إذا كانت تلك النتيجة ضمن قائمة **إعادة المحاولة عند** الخاصة بك وكانت لدى
جهة الاتصال محاولات متبقية. تُعلَّم جهات الاتصال التي تستنفد محاولاتها
بأنها *مستنفدة*؛ وتُعلَّم حالات الفشل غير القابلة لإعادة المحاولة بأنها *فاشلة*.

<Note>
  يتوقف الاتصال مؤقتاً تلقائياً عندما لا يكون رصيد حسابك بحالة جيدة،
  ويُستأنف بمجرد أن يصبح كذلك. أبقِ
  [الشحن التلقائي](/ar/guides/billing-and-topups) مفعلاً للحملات الطويلة.
</Note>

## المراقبة والتحكم

تعرض كل بطاقة حملة حالتها وتقدمها (مثلاً "173 من 248
مكتملة"). افتح حملة لعرض تفصيل الحالات، والنتائج لكل جهة اتصال،
والمكالمات الأخيرة — ويرتبط كل منها بالنص المفرغ الكامل
والتسجيل في سجل المكالمات.

* **إيقاف مؤقت / استئناف** — يوقف الإيقاف المؤقت الاتصالات الجديدة؛ وتُكمل المكالمات
  الجارية بالفعل بشكل طبيعي. يمكن تعديل الحملات الموقوفة مؤقتاً واستئنافها.
* **إلغاء** — يوقف الحملة نهائياً.
* تكتمل الحملة تلقائياً عندما تصل كل جهة اتصال إلى حالة
  نهائية أو يمر وقت **الانتهاء**.

حالات الحملة: `draft`، `scheduled`، `running`، `paused`،
`completed`، `cancelled`. حالات جهات الاتصال: `pending`، `scheduled`،
`calling`، `completed`، `failed`، `exhausted`.

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

<CardGroup cols={2}>
  <Card title="راقب المكالمات مباشرةً" icon="tower-broadcast" href="/ar/guides/monitor-live-calls">
    استمع إلى مكالمات الحملة أثناء حدوثها.
  </Card>

  <Card title="واجهة برمجة تطبيقات المكالمات الصادرة" icon="phone-arrow-up-right" href="/ar/guides/place-outbound-calls">
    أجرِ مكالمات فردية برمجيًا.
  </Card>
</CardGroup>
