**باستخدام API الخاصة بـ Papo (https://papo.global/) يمكنك أتمتة إنشاء حملات التسويق عبر البريد الإلكتروني وإرسالها وتحليلها مباشرة من نظامك، دون الدخول إلى اللوحة يدوياً. تتيح نقاط نهاية Email Marketing إدارة الحملات والقوالب والجماهير ومقاييس الأداء عبر طلبات REST، باستخدام المصادقة نفسها بالمفتاح السري المستخدمة في بقية API.**

## ملخص العمليات عبر API

| العملية | ما يمكنك فعله برمجياً |
| :--- | :--- |
| **عرض الحملات** | الحصول على قائمة الحملات مع المقاييس (المرسلة، الفتحات، النقرات) لتغذية لوحات المعلومات أو التقارير. |
| **إنشاء حملة كمسودة** | إنشاء حملة بريد إلكتروني جديدة بحالة مسودة، مع تحديد الجمهور والقالب والمرسل والجدولة. |
| **إطلاق الحملة** | إطلاق (إرسال) حملة موجودة بالفعل كمسودة أو متوقفة مؤقتاً، لبدء الإرسال الفعلي. |
| **إرسال بريد فردي** | إرسال بريد واحد فوراً، وهو مثالي للاتصالات المعاملاتية أو الاختبارات. |
| **عرض القوالب** | استرجاع قوالب البريد المحفوظة في الحساب لإعادة استخدامها في الحملات. |
| **عرض الجماهير** | الحصول على قوائم جهات الاتصال (الجماهير) المتاحة، بما في ذلك الديناميكية، للاستهداف التلقائي. |

تتبع جميع العمليات نمط REST، مع استجابات JSON ومصادقة عبر `Authorization: Bearer <secret_key>`. وكأي نقطة نهاية أخرى في Papo، تحتاج إلى مفتاح سري (`sk_live_…`) يتم إنشاؤه في اللوحة ضمن **Developers**.

## كيف يعمل: أتمتة الدورة الكاملة لحملة

### 1. وثّق هويتك واستكشف نقاط النهاية

قبل أي طلب، احصل على مفتاحك السري في لوحة Papo (قسم **Developers**). عنوان URL الأساسي هو نفسه الخاص بـ API العامة، ويجب أن تتضمن جميع الطلبات ترويسة التفويض. ومع المفتاح في يدك، يمكنك عرض الجماهير والقوالب الموجودة لتخطيط الحملة.

### 2. أنشئ حملة في وضع المسودة

استخدم نقطة نهاية إنشاء حملة البريد الإلكتروني (وضع المسودة) لتجهيز الإرسال دون إرساله فوراً. في الطلب، تحدّد:
- بيانات اعتماد الإرسال (صندوق البريد المُعدّ).
- معرّف القالب (أو حمولة المحتوى إذا أنشأته ضمنياً).
- الجمهور (معرّف القائمة أو مصفوفة جهات اتصال).
- إعدادات اختيارية مثل تاريخ/وقت الجدولة ونوافذ الإرسال.

تعيد الاستجابة المعرّف الفريد للحملة، ما يسمح لك باسترجاعها لاحقاً.

### 3. أطلق الحملة أو جدول الإرسال

مع امتلاك معرّف الحملة، يمكنك إطلاقها (بدء تشغيلها) بطلب آخر. إذا كنت تفضّل الجدولة التلقائية، فما عليك سوى تضمين حقلي التاريخ والوقت عند الإنشاء – ستبقى الحملة كمسودة مجدولة وستُرسل في الوقت المحدد.

### 4. راقب الأداء

استخدم نقطة نهاية عرض الحملات للاستعلام عن المقاييس في أي وقت. ستتلقى بيانات مثل إجمالي المرسلة، ومعدل الفتح، وعدد النقرات. يمكن سحب هذه الأرقام إلى لوحات معلومات في نظامك (مثلاً Google Data Studio أو Power BI أو جداول بيانات) باستخدام طلبات دورية أو Webhooks.

## حالات استخدام نموذجية

- **تنمية العملاء المحتملين المدفوعة بالأحداث:** يخبر Webhook من نظام ERP لديك أن عميلاً محتملاً بلغ درجة معينة؛ فيرسل نظامك تلقائياً حملة بريد إلكتروني عبر API، ناقلاً العميل إلى المرحلة التالية.
- **تقارير مؤسسية موحّدة:** تستعلم أداة BI لديك دورياً عن مقاييس الحملات وتدمجها مع بيانات المبيعات، كل ذلك بشكل مجدول.
- **الأتمتة في n8n أو Zapier:** أنشئ تدفقات تُنشئ، عند وصول جهة اتصال جديدة إلى CRM، مسودة حملة ترحيب وتطلقها دون تدخل يدوي.
- **إعادة البيع بالعلامة البيضاء:** ادمج إنشاء الحملات وإدارتها في بوابة عملائك الخاصة، مع الحفاظ على الهوية البصرية لعلامتك واستخدام البنية التحتية من Papo.

## لمن هذه الحل؟

- المطورون وفرق تقنية المعلومات الذين يرغبون في دمج التسويق بالبريد الإلكتروني في الأنظمة الداخلية.
- الوكالات التي تحتاج إلى إنشاء حملات بالجملة لعشرات العملاء دون الدخول إلى لوحة كل واحد منهم.
- موزعو إعادة البيع بالعلامة البيضاء الذين يريدون تقديم إرسال البريد كجزء من محفظتهم، بإدارة عبر API.
- الشركات التي تستخدم الأتمتة في n8n أو Zapier أو نصوص مخصصة.

## الأسئلة الشائعة

### هل أحتاج إلى مفتاح API مختلف لاستخدام نقاط نهاية Email Marketing؟
لا. المفاتيح نفسها (العامة والسرية) التي تستخدمها بالفعل لبقية موارد Papo تعمل في نقاط نهاية البريد الإلكتروني. المصادقة هي نفسها، عبر ترويسة `Authorization: Bearer`.

### هل يمكنني إرسال بريد واحد، مثل إشعار معاملاتي؟
نعم. تتيح API إرسالات فردية وفورية، دون الحاجة إلى إنشاء حملة. ما عليك سوى تحديد المستلم والموضوع والمحتوى وبيانات اعتماد الإرسال.

### كيف أعرف أن الحملة أُطلقت فعلاً؟
عند استدعاء نقطة نهاية الإطلاق، تعيد API حالة الحملة. بعد ذلك، يمكنك الاستعلام عن قائمة الحملات للتحقق مما إذا كانت الحالة قد انتقلت من "مسودة" إلى "قيد الإرسال" أو "مكتملة"، والحصول على مقاييس التقدم.

### ما المقاييس التي تعيدها API؟
تتضمن الاستجابات على الأقل إجمالي رسائل البريد المرسلة، والفتحات، والنقرات. الحقول المتاحة بالضبط موثقة في نقطة نهاية العرض، ويمكن استكشافها بأدوات مثل Postman أو واجهة اكتشاف API نفسها.

### هل يمكنني إنشاء قوالب بريد إلكتروني عبر API؟
تتيح وظيفة عرض القوالب الحالية استرجاع القوالب الموجودة بالفعل في الحساب. يمكن إنشاء قوالب جديدة من اللوحة؛ راجع الوثائق المحدثة للتأكد من توفر مسار الإنشاء عبر API.

### هل يمكن جدولة حملة لتاريخ محدد؟
نعم. عند إنشاء المسودة، يمكنك تحديد التاريخ والوقت المطلوبين. ستبقى الحملة في هذه الحالة وستُرسل تلقائياً في الوقت المجدول، ما لم يتم إيقافها مؤقتاً يدوياً.

## اقرأ أيضاً

- [كيفية استخدام API الخاصة بـ Papo لإدارة تسلسلات المتابعة](/hc/papo/articles/how-to-use-papo-api-manage-follow-up-sequences-ar)
- [كيفية استخدام API الخاصة بـ Papo لإنشاء وتحديث جهات الاتصال بشكل جماعي](/hc/papo/articles/how-to-use-papo-api-create-update-contacts-bulk)

---

**[ابدأ مجاناً →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=papo-email-marketing-api-campaign-management&utm_content=ar)**

وحّد القنوات، وأتمت الردود بالذكاء الاصطناعي، وأدر حملات البريد الإلكتروني — كل ذلك في لوحة واحدة، دون تكلفة أولية.