---
title: "حملات الاتصال الصادرة"
description: "ارفع قائمة جهات اتصال ودَع وكيلاً صوتياً يعمل عليها — مع نوافذ اتصال، وإعادات محاولة، وتقدم مباشر."
---

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

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

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

- وكيل صوتي منشور.
- رقم هاتف مفعّل للمكالمات الصادرة. تستمر أرقام VoIP الخاصة بالعملاء في دعم
  الحملات. تبدأ أرقام ThunderPhone للمكالمات الواردة فقط؛ ويمكن لمسؤول مؤسسة
  طلب تفعيل المكالمات الصادرة من صفحة أرقام الهاتف. يراجع ThunderPhone
  كل طلب يدويًا، ويمكن للأرقام المعتمدة تشغيل الحملات. راجع
  [ربط مزود VoIP](/ar/guides/voip-providers).
- جهات اتصال في ملف CSV (أو JSON ملصق) يحتوي على عمود `phone` أو
  `phone_number`. **حتى 5,000 صف لكل عملية تحميل**، بترميز UTF-8.
  يجب أن تكون عمليات تحميل JSON الجديدة غير متداخلة: يمكن أن تكون القيم الإضافية
  سلاسل نصية أو أرقامًا أو قيمًا منطقية أو `null`. تُرفض الصفوف التي تحتوي على
  مصفوفات أو كائنات متداخلة بشكل منفصل مع رسالة تحقق؛ بينما تستمر عملية استيراد
  الصفوف الصالحة. خلايا CSV هي سلاسل نصية. تُحتفَظ بالأعمدة الإضافية المقبولة
  كمتغيرات لكل جهة اتصال في سجلات جهات اتصال الحملة، وتُزوَّد تلقائيًا لكل
  عملية اتصال. يصنّف ThunderPhone أيضًا موجّه الوكيل المحفوظ قبل كل مكالمة صادرة
  لتحديد ما إذا كان ينبغي للوكيل التنقل عبر قائمة هاتفية آلية. تتطابق رؤوس الأعمدة
  مثل `name` و`account_id` مع `{{name}}` و`{{account_id}}` في موجّه الوكيل المحفوظ.
  يمكن لتعيين الاسم أيضًا دمج أعمدة في `name`. راجع
  [متغيرات لكل مكالمة](/ar/guides/call-variables) للإعدادات الافتراضية وقواعد التسمية
  وحد الكائن البالغ 32 KB والقيم المُعادة في خطافات الويب عند الإكمال.

قد تحتوي سجلات جهات الاتصال الأقدم على بيانات وصفية متداخلة من عمليات رفع JSON
سابقة. تبقى تلك البيانات الوصفية في جهة الاتصال المخزنة. يستبعد كل اتصال القيم
غير العددية من حمولة متغيراته ويسجل أسماء المفاتيح التي تم تجاهلها لتلك المحاولة،
من دون تسجيل القيم. تستخدم عمليات إعادة المحاولة التصفية نفسها.

## إنشاء حملة

<Steps>
  <Step title="انقر على حملة جديدة">
    سمِّها، واختر **الوكيل الصوتي**، وحدد **رقم المصدر**
    (أحد أرقامك المفعّلة للمكالمات الصادرة).
  </Step>
  <Step title="حمّل ملف CSV لجهات الاتصال">
    تُرفض الصفوف التي تحتوي على رقم هاتف غير صالح أو متغيرات غير صالحة بشكل منفصل،
    ويُبلّغ عنها مع أرقام صفوفها — أما البقية فتُستورد بنجاح.
  </Step>
  <Step title="حدد نافذة الاتصال">
    اختر **منطقة زمنية** ونافذة **بدء/انتهاء يومية**؛ ولا تُجري الحملة
    الاتصالات إلا ضمنها. تُحدَّد المنطقة الزمنية مبدئيًا وفق منطقة رقم المصدر لديك
    (رمز المنطقة في الولايات المتحدة وكندا، والبلد في أماكن أخرى) أو، بالنسبة إلى
    الأرقام التي تمتد عبر عدة مناطق مثل الأرقام المجانية، وفق منطقة
    متصفحك. يوضّح التلميح أسفل الحقل أيهما يُستخدم. تكون النافذة افتراضيًا
    من 9 صباحًا إلى 5 مساءً. تظهر نافذة تبدأ قبل 8 صباحًا أو تنتهي بعد 9 مساءً
    تحذيرًا: قد تخالف المكالمات خارج هذه الساعات قواعد أوقات الاتصال مثل
    قواعد TCPA. يعني وقت انتهاء يسبق وقت البدء عبور منتصف الليل: 22:00 →
    02:00 تُجري الاتصالات من 10 مساءً حتى 2 صباحًا في اليوم التالي، مع تحذير. تعمل
    النافذة وفق المنطقة الزمنية للحملة، وليس المنطقة الزمنية لكل جهة اتصال، لذا قسّم
    جهات الاتصال حسب المنطقة الزمنية عندما تكون موزعة.
    يمكنك اختياريًا تعيين **وقت البدء** لجدولة الإطلاق و**وقت الانتهاء**
    الذي تكتمل الحملة بعده تلقائيًا.
  </Step>
  <Step title="اضبط الوتيرة وإعادة المحاولة">
    - **المكالمات المتزامنة** — عدد المكالمات التي تُجريها هذه الحملة في الوقت نفسه
      (1–10، والافتراضي 3). لا تبدأ الحملات أي مكالمة جديدة ما دامت لدى
      مؤسستك 10 مكالمات صادرة جارية، لذا تتشارك الحملات المتوازية
      هذه السعة. تُحتسب كل مكالمة أيضًا ضمن [حد المكالمات المتزامنة](/api-reference/introduction#call-limits)
      لمؤسستك (20 افتراضيًا، عبر المكالمات الواردة والصادرة والويب والاختبار).
      عند بلوغ هذا الحد، أو إذا تم الاتصال بالرقم نفسه خلال
      آخر 10 ثوانٍ، تنتظر جهة الاتصال ببساطة جولة لاحقة؛ ولا تُستهلك
      محاولاتها.
    - **الحد الأقصى للمحاولات** — عدد مرات الاتصال المسموح بها لكل جهة اتصال
      (1–10، والافتراضي 2).
    - **فاصل إعادة المحاولة (بالدقائق)** — مدة الانتظار قبل إعادة المحاولة (30 على الأقل،
      والافتراضي 60).
    - **إعادة المحاولة عند** — النتائج التي تؤدي إلى إعادة المحاولة: **لا رد**،
      **بريد صوتي**، **فشل** (كلها مفعّلة افتراضيًا).

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

<Note>
  تستمر الحملات المحفوظة قبل هذه الحدود في العمل تمامًا وفق إعداداتها.
  تظل محاولاتها وفواصلها كما حُفظت عند إجراء تعديلات أخرى.
</Note>

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

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

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