مع API REST من Papo، يمكنك عرض جميع الـ Flows المتاحة في حسابك، وتفعيل أو تعطيل الرحلات، وتسجيل جهات الاتصال في الأتمتة برمجيًا — كل ذلك عبر طلبات موثّقة، دون فتح لوحة التحكم. هذه هي الطريقة لدمج محرك Flows مع الأنظمة الخارجية، وسير عمل n8n، وأنظمة CRM، أو النصوص البرمجية الداخلية.
توفّر API Papo موارد Flows التي تتيح إدارة الأتمتة تمامًا كما تدير بالفعل صناديق الوارد أو جهات الاتصال. وبفضلها، تستطيع فرق التطوير والمكاملون والموزّعون بعلامة بيضاء (white label) التحكم بشكل جماعي في الرحلات النشطة، وبدء جهات الاتصال في تسلسلات، ومزامنة حالة الأتمتة مع عمليات الأعمال.
ملخص عمليات Flow عبر API
| العملية | الوصف | مثال على الاستخدام |
|---|---|---|
| عرض Flows | يعيد الـ Flows والتسلسلات المتاحة، مع المعرّف والاسم والنوع والحالة (نشط/غير نشط). | تدقيق الأتمتة، أو المزامنة مع لوحات معلومات خارجية، أو التحقق مما قيد التنفيذ. |
| تفعيل/تعطيل Flow | يغيّر حالة Flow محدّد، فيتيح أو يوقف استقبال جهات الاتصال ومعالجتها. | إيقاف رحلة مؤقتًا أثناء الصيانة، أو تفعيلها بعد التعديلات، أو تعطيل حملة منتهية. |
| تسجيل جهة اتصال | يُدرج جهة اتصال موجودة في بداية Flow نشط، لبدء الرحلة المُعدّة. | تضمين عملاء محتملين من CRM خارجي، أو إطلاق مسار ترحيب بعد الدمج، أو تصحيح إدخالات يدوية. |
كيف تعمل مصادقة API
تتطلب جميع استدعاءات API، بما في ذلك تلك التي تتعلق بـ Flows، المفتاح السري للحساب. يجب إرساله كرمز Bearer في ترويسة Authorization. المفتاح العام للحساب اختياري، لكن إذا أُرسل فيجب أن يطابق نفس حساب المفتاح السري.
عنوان URL الأساسي لـ API هو https://app.papo.global/api/v1. يتم إنشاء المفاتيح في منطقة المطوّر في لوحة Papo. يظهر المفتاح السري مرة واحدة فقط عند الإنشاء؛ احفظه في مكان آمن وأبطله إذا اشتبهت في تسريبه.
نمط المصادقة هو نفسه المستخدم في جميع نقاط النهاية:
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_…" \
-H "X-Papo-Public-Key: pk_live_…"
إدارة Flows عبر API عمليًا
على الرغم من أن التفاصيل الدقيقة لكل نقطة نهاية ومعاملاتها موجودة في الوثائق الرسمية لـ API، فإن سير العمل العام يتبع هذه الخطوات المفاهيمية:
- صادِق نفسك باستخدام المفتاح السري (والمفتاح العام إن أردت) للتحقق من الحساب.
- اعرض Flows للحصول على القائمة الحالية للرحلات، بما في ذلك معرّفاتها وحالتها. يتيح لك ذلك رسم ما هو موجود بالفعل واختيار Flow الصحيح للعمليات التالية.
- غيّر الحالة لـ Flow محدّد، إذا لزم الأمر. أرسل طلبًا يحدد Flow كـ نشط (متاح لاستقبال جهات الاتصال) أو غير نشط (متوقف مؤقتًا). فقط الـ Flows النشطة تعالج جهات الاتصال وتقبل التسجيلات.
- سجّل جهة اتصال في Flow نشط. أدخل معرّف جهة الاتصال ومعرّف Flow المطلوب لإدراجها في بداية الرحلة. يتم الحفاظ على سجل جهة الاتصال في CRM.
- ادمج مع أنظمة خارجية — عبر webhooks أو استدعاءات مباشرة، يمكنك بدء جهات اتصال قادمة من نموذج خارجي، أو حدث في نظام آخر، أو خط أنابيب بيانات.
تدعم المنصة أيضًا إنشاء Flows فارغة وغير نشطة وملء عُقدها عبر API، مما يتيح توفير أتمتة كاملة برمجيًا. للحصول على تنسيقات payload الدقيقة والحقول الإلزامية وأمثلة الشيفرة، راجع قسم Flows في وثائق API Papo.
لمن تكون هذه المكاملة منطقية
- فرق تكنولوجيا المعلومات التي تدير أتمتة متعددة وتحتاج إلى إيقاف أو إعادة تفعيل أو مراقبة Flows بشكل جماعي دون الوصول إلى لوحة التحكم يدويًا.
- الموزّعون بعلامة بيضاء (white label) الذين يرغبون في توفير رحلات موحّدة لكل عميل جديد تلقائيًا، وتسجيل جهات الاتصال الأولية، والحفاظ على التوافق بين المنصات.
- المكاملون والمطوّرون الذين يربطون Papo بأنظمة CRM أو ERP أو أدوات مثل n8n، ويشغّلون Flows من أحداث خارجية (عملية شراء، تسجيل، موعد).
- العمليات التي تعمل بالتسجيل الشرطي، حيث تُدرج جهات الاتصال في Flows فقط بعد اجتيازها قواعد عمل محددة في أنظمة أخرى.
الأسئلة الشائعة
هل أحتاج إلى المفتاح السري لعرض Flows؟
نعم. يتطلب عرض Flows، مثل أي عملية تُرجع بيانات الحساب، مصادقة بالمفتاح السري. النمط هو نفسه في جميع نقاط النهاية الأخرى: أرسل رمز Bearer في ترويسة Authorization.
هل يمكنني تفعيل أو تعطيل Flow عبر API؟
نعم. تتيح API تغيير حالة Flow بين نشط وغير نشط. تحتاج إلى معرّف Flow والمفتاح السري. الـ Flows غير النشطة لا تستقبل جهات اتصال ولا تتقدم في الرحلة، حتى لو جرت محاولة تسجيل.
كيف أسجّل جهة اتصال في Flow عبر API؟
قدّم معرّف جهة الاتصال ومعرّف Flow النشط في استدعاء التسجيل. ستُدرج جهة الاتصال في بداية الرحلة، دون حذف سجل المحادثات أو بيانات الملف الشخصي. توضّح الوثائق الرسمية التنسيق الدقيق للمعاملات.
هل يمكن إنشاء Flow من الصفر عبر API؟
نعم. تتيح API إنشاء Flow فارغ (بعقدة Start فقط) وغير نشط، بالإضافة إلى ملء عُقده بالأسئلة والرسائل والشروط. هذا مفيد لتوفير الأتمتة بشكل قابل للتوسع، خاصة في سيناريوهات إعادة البيع أو تأهيل العملاء الجدد.
هل تعيد API حالة كل Flow عند العرض؟
نعم. يتضمن العرض الحالة (نشط أو غير نشط) لكل Flow وتسلسل، بالإضافة إلى المعرّف والاسم والنوع، مما يتيح للأنظمة الخارجية مراقبة ما يعمل وما هو متوقف مؤقتًا.
أين أجد الوثائق الكاملة لمسارات Flows؟
الوثائق الرسمية متاحة على https://papo.global/pt/docs. هناك تجد جميع نقاط النهاية والمعاملات المقبولة ورموز الأخطاء وأمثلة بلغات متعددة. تتبع مسارات Flows نفس نمط REST والمصادقة الخاصين بالوحدات الأخرى.
اقرأ أيضًا
- كيفية استخدام API Papo لإنشاء وتحديث جهات الاتصال بشكل جماعي
- كيفية استخدام API Papo لإنشاء وإدارة العلامات (tags)
أنشئ حسابك المجاني على Papo، وادخل إلى مفاتيح API، واربط أتمتتك بالعالم الخارجي.