لإدارة تسلسلات المتابعة عبر API في Papo، يمكنك سرد الإيقاعات المتاحة، وتسجيل جهات الاتصال، وإيقاف مشاركة عميل محتمل مؤقتًا باستخدام تحديث السمات المخصصة — كل ذلك عبر طلبات مصادق عليها، دون فتح لوحة التحكم. هذه هي طريقة دمج رعاية العملاء المحتملين مع أنظمة إدارة علاقات العملاء (CRMs) وأنظمة تخطيط موارد المؤسسات (ERPs) وتدفقات الأتمتة الخارجية.
ملخص العمليات عبر API
| العملية | الوصف | كيف تنفذها API |
|---|---|---|
| سرد التسلسلات | الحصول على جميع إيقاعات المتابعة في الحساب، مع الاسم والمعرف والحالة (نشط/غير نشط). | طلب GET مصادق عليه إلى نقطة نهاية flows، مع تصفية حسب النوع "sequence". |
| تسجيل جهة اتصال | إدراج جهة اتصال موجودة في تسلسل نشط، وبدء رحلة الرسائل. | POST مع معرف جهة الاتصال ومعرف التسلسل إلى نقطة نهاية التسجيل. |
| إيقاف الإيقاع مؤقتًا لجهة اتصال | إيقاف الإرسال مؤقتًا لعميل محتمل دون إزالته من التسلسل. | تحديث السمة المخصصة لجهة الاتصال (مثل: status_pausa) عبر API جهات الاتصال، مع دمجها مع شرط في Flow. |
كيف تعمل المصادقة ونقاط النهاية
تستخدم جميع العمليات واجهة برمجة تطبيقات REST من Papo، المصادق عليها باستخدام المفتاح السري للحساب (رمز Bearer). عنوان URL الأساسي هو https://app.papo.global/api/v1. يتم إنشاء المفاتيح في لوحة التحكم، في منطقة المطور.
تتجمع موارد التسلسلات في نقاط نهاية flows. تتيح API سرد جميع flows، بما في ذلك تلك من النوع "sequence"، وكذلك تنشيط/إلغاء تنشيط flow بأكمله. لتسجيل جهة اتصال، هناك نقطة نهاية محددة تستقبل معرف جهة الاتصال ومعرف flow.
التفاصيل الدقيقة لكل نقطة نهاية (المعاملات، والحمولات، والأمثلة) متاحة في الوثائق الرسمية لواجهة برمجة تطبيقات Papo. هنا، نركز على سير العمل لإدارة تسلسلات المتابعة.
خطوة بخطوة: السرد، التسجيل، والإيقاف المؤقت
1. سرد التسلسلات المتاحة
قبل تسجيل العملاء المحتملين، تحتاج إلى معرفة التسلسلات الموجودة ومعرفاتها. يعيد استدعاء السرد قائمة بالاسم والمعرف والحالة (نشط/غير نشط). فقط التسلسلات النشطة تقبل عمليات تسجيل جديدة.
مع القائمة في متناول اليد، يمكن لنظامك الخارجي تعيين التسلسل الذي يجب استخدامه لكل عميل محتمل.
2. تسجيل جهة اتصال في تسلسل
باستخدام معرف جهة الاتصال (الذي تم الحصول عليه عبر البحث أو الإنشاء بواسطة API جهات الاتصال) ومعرف التسلسل النشط، ترسل طلبًا لإدراجه في بداية الرحلة. يجب أن تكون جهة الاتصال موجودة في CRM الخاص بـ Papo؛ وإلا، قم بإنشائها أولاً باستخدام نقطة نهاية جهات الاتصال.
يبدأ التسجيل فورًا في إرسال الرسائل المجدولة، مع احترام الفواصل الزمنية المكونة في Flow. يتم الحفاظ على سجل جهة الاتصال.
3. إيقاف الإيقاع مؤقتًا لجهة اتصال محددة
لا تحتوي API الخاصة بـ Papo على أمر مباشر "لإيقاف" مشاركة جهة اتصال في تسلسل. ومع ذلك، يمكنك تحقيق نفس التأثير من خلال دمج API جهات الاتصال مع شرط في Flow.
المتطلب الأساسي: يجب أن يكون التسلسل قد تم بناؤه باستخدام عقدة شرط تتحقق من سمة مخصصة (مثل: status_pausa). إذا كانت السمة تساوي "pausado"، فإن الشرط يمنع إرسال الرسائل التالية؛ وإلا، يسمح بذلك. (راجع المقال حول الإيقاف المؤقت للحصول على تفاصيل تجميع Flow.)
مع هذا الهيكل في Flow، يتم الإيقاف المؤقت في خطوتين عبر API:
- حدد جهة الاتصال بواسطة المعرف أو ابحث عنها عبر الهاتف/البريد الإلكتروني باستخدام نقطة نهاية سرد جهات الاتصال.
- حدّث السمة المخصصة لجهة الاتصال إلى "pausado" (أو القيمة التي يتوقعها شرطك). استخدم نقطة نهاية تحديث جهة الاتصال، مع إرسال الحقل المخصص.
من هذه اللحظة، عندما يصل التدفق إلى الشرط، سيتعرف على القيمة "pausado" ولن يرسل الرسالة. للاستئناف، ما عليك سوى تحديث السمة إلى أي قيمة أخرى (مثل: "ativo") أو مسحها، وستستمر جهة الاتصال من حيث توقفت.
تحافظ هذه الطريقة على جهة الاتصال مسجلة والتقدم في الإيقاع، دون فقدان السجل.
لمن يكون هذا التكامل مفيدًا
- عمليات SDR ومبيعات B2B التي تطلق التسلسلات من أحداث خارجية (مثل: قام عميل محتمل بتنزيل مادة، تم إنشاء صفقة في CRM).
- الموزعون بعلامة بيضاء (white label) الذين يوفرون رحلات متابعة تلقائيًا للعملاء الجدد، ويسجلون جهات الاتصال الأولية دون إجراء يدوي.
- فرق التسويق والأتمتة التي تستخدم أدوات مثل n8n أو Zapier لربط Papo بعشرات الأنظمة وتحتاج إلى تحكم دقيق في الإيقاعات.
- الشركات التي لديها عمليات إيقاف مؤقت مشروطة، حيث يطلب عميل محتمل مهلة ويريد البائع مقاطعة التسلسل دون فقدان نقطة الإيقاع — كل ذلك يتم تشغيله بواسطة زر في CRM الخارجي.
الأسئلة الشائعة
هل أحتاج إلى المفتاح السري لسرد التسلسلات؟
نعم. تتطلب كل عملية تُرجع بيانات الحساب المصادقة باستخدام المفتاح السري، الذي يُرسل كرمز Bearer في رأس Authorization.
هل يمكنني تسجيل جهة اتصال غير موجودة بعد في Papo؟
لا. يجب أن تكون جهة الاتصال موجودة في CRM الخاص بـ Papo. يمكنك إنشاؤها أولاً عبر API جهات الاتصال (بالاسم أو الهاتف أو البريد الإلكتروني) ثم تسجيلها في التسلسل.
هل تسمح API بإزالة جهة اتصال من التسلسل؟
الإزالة (إلغاء التسجيل) غير متاحة كنقطة نهاية محددة في الإصدار الحالي. البديل لإيقاف الإرسال هو الإيقاف المؤقت عبر السمة المخصصة، كما هو موضح، أو إلغاء تنشيط flow بأكمله، مما يؤثر على جميع جهات الاتصال.
كيف أعرف أن الإيقاف المؤقت بواسطة السمة قد نجح؟
بعد تحديث السمة، سيستمر التسلسل في معالجة عقد الانتظار. عندما يصل إلى الشرط، سيتحقق من القيمة. إذا كانت "pausado"، فلن يتم إرسال الرسالة. يمكنك التأكيد في ملف جهة الاتصال، في وحدة جهات الاتصال، أنها لا تزال مسجلة، ولكن لا يتم إطلاق الرسائل التالية.
هل يمكنني إيقاف التسلسل بأكمله مؤقتًا عبر API؟
نعم. تتيح API تغيير حالة flow إلى غير نشط، مما يوقف التسلسل مؤقتًا لجميع جهات الاتصال. استخدم نقطة نهاية تنشيط/إلغاء تنشيط flow. للاستئناف، ما عليك سوى إعادة تنشيطه.
أين أجد نقاط النهاية الدقيقة وأمثلة التعليمات البرمجية؟
الوثائق الكاملة لواجهة برمجة التطبيقات متاحة على https://papo.global/pt/docs. هناك ستجد نقاط نهاية flows وجهات الاتصال وتنسيقات الطلب.
اقرأ أيضًا
- كيفية استخدام API الخاصة بـ Papo لإدارة تدفقات الأتمتة
- كيفية استخدام API الخاصة بـ Papo لإنشاء وتحديث جهات الاتصال بشكل جماعي
ابدأ مجانًا وأتمت تسلسلاتك → مع API الخاصة بـ Papo، يمكنك دمج رعاية العملاء المحتملين مباشرة في مجموعتك التقنية، دون فتح لوحة التحكم — المستخدم الأول مجاني لتجربته.