لأرشفة المحادثات وجهات الاتصال بشكل جماعي برمجيًا، استخدم واجهة برمجة التطبيقات REST الخاصة بـ Papo. من خلال نقاط النهاية لتحديث جهات الاتصال وتطبيق العلامات على المحادثات، يمكنك وضع علامة "مؤرشف" على السجلات، والحفاظ على قاعدة البيانات نظيفة دائمًا دون تدخل يدوي — مثالي للعمليات ذات الحجم الكبير من البيانات أو لعمليات إعادة البيع بعلامة بيضاء (white label) التي تدير عدة عملاء.
لا تتطلب Papo نقطة نهاية حصرية لـ "الأرشفة". بدلاً من ذلك، يمكنك استخدام العمليات المتاحة بالفعل في واجهة برمجة التطبيقات لتغيير حالة السجلات: تحديث جهة اتصال (بإضافة علامة أرشفة أو سمة مخصصة) وتطبيق علامة على محادثة. بهذه الطريقة، تتمكن النصوص البرمجية أو الأتمتة من معالجة آلاف العناصر دفعة واحدة وتنظيم قاعدة البيانات وفقًا لقواعد عملك.
ملخص عملية الأرشفة الجماعية عبر API
| الخطوة | الإجراء | تفاصيل مهمة |
|---|---|---|
| 1. الحصول على المفاتيح | إنشاء المفتاح السري (sk_live_…) ونسخ المفتاح العام (pk_live_…) في لوحة تحكم Papo. | يظهر المفتاح السري مرة واحدة فقط؛ احفظه في مكان آمن. |
| 2. تحديد ما يجب أرشفته | إدراج جهات الاتصال أو المحادثات التي يجب أرشفتها (حسب التاريخ، الحالة، عدم التفاعل، إلخ). | استخدم نقاط نهاية الإدراج مع عوامل التصفية أو تصدير ملف CSV لتغذية النص البرمجي. |
| 3. أرشفة جهات الاتصال | لكل جهة اتصال، إرسال طلب تحديث يتضمن علامة "مؤرشف" أو سمة مخصصة. | تقبل نقطة نهاية تحديث جهة الاتصال الحقول التي تريد تعديلها. |
| 4. أرشفة المحادثات | لكل محادثة، تطبيق علامة مثل "مؤرشف" باستخدام نقطة نهاية العلامات. | يتم إنشاء العلامة تلقائيًا في الحساب إذا لم تكن موجودة. |
| 5. التحقق من النتيجة | التأكد من ظهور السجلات مع علامة الأرشفة وما إذا كانت عوامل التصفية في النظام الأساسي تعكس التنظيم الجديد. | اضبط عوامل التصفية في وحدة جهات الاتصال أو المحادثات لإخفاء العناصر المؤرشفة. |
كيف يعمل – خطوة بخطوة
1. المصادقة والمفاتيح
كل استدعاء يعدل البيانات يتطلب المفتاح السري للحساب. يجب إرساله كرمز Bearer في رأس Authorization (أو في رأس X-Papo-Secret-Key). يمكن أن يرافق المفتاح العام (ثابت لكل حساب) الطلب في رأس X-Papo-Public-Key — استخدامه اختياري، ولكن إذا تم إرساله يجب أن يتوافق مع نفس حساب المفتاح السري.
أنشئ المفاتيح في لوحة تحكم Papo، في منطقة المطورين. عنوان URL الأساسي لواجهة برمجة التطبيقات هو https://app.papo.global/api/v1. راجع الوثائق الرسمية لمعرفة نقاط النهاية الدقيقة والمعلمات وأمثلة الحمولة.
2. تحديد السجلات التي سيتم أرشفتها
قبل بدء التحديثات، تحتاج إلى معرفة جهات الاتصال أو المحادثات التي يجب أرشفتها. توفر واجهة برمجة التطبيقات نقاط نهاية للإدراج تعيد البيانات اللازمة. على سبيل المثال، يمكنك:
- إدراج جهات الاتصال (البحث بالاسم أو البريد الإلكتروني أو الهاتف أو عوامل تصفية حسب التاريخ) لتحديد تلك التي لم تتفاعل منذ X أيام.
- إدراج المحادثات وتصفيتها بمعايير مثل الحالة أو تاريخ آخر رسالة.
مع القائمة في متناول اليد، يمكن لنص برمجي بلغة Python أو Node.js أو أتمتة في n8n أن يتنقل عبر كل سجل وينفذ إجراء الأرشفة.
3. أرشفة جهات الاتصال بشكل جماعي
تتيح واجهة برمجة تطبيقات Papo تحديث جهة اتصال موجودة. لأرشفتها، يمكنك:
- إضافة علامة (مثل "مؤرشف") إلى جهة الاتصال. تقبل نقطة نهاية التحديث إدراج العلامات.
- أو تحديث سمة مخصصة (إذا كنت قد أنشأت حقلًا مثل "الحالة" أو "مؤرشف") بالقيمة المطلوبة.
المهم أنه بعد التحديث، تحمل جهة الاتصال علامة تميزها عن النشطة. نظرًا لأن واجهة برمجة التطبيقات تعالج جهة اتصال واحدة لكل طلب، تتم العملية الجماعية عن طريق تنفيذ استدعاءات متعددة بالتسلسل. تتوفر أمثلة التعليمات البرمجية بلغة JavaScript و Python في وثائق واجهة برمجة التطبيقات ويمكن تكييفها مع نقطة نهاية التحديث.
4. أرشفة المحادثات بشكل جماعي
بالنسبة للمحادثات، توفر واجهة برمجة التطبيقات نقطة نهاية تنشئ علامة في الحساب (إذا لم تكن موجودة) وتطبقها على جهة الاتصال والمحادثة المفتوحة. وبالتالي، يمكنك إنشاء علامة "مؤرشف" وتطبيقها على جميع المحادثات التي تريد إزالتها من العرض الرئيسي.
التدفق مشابه لجهات الاتصال: أدرج المحادثات، وصفِّ التي يجب أرشفتها، ولكل منها، أرسل طلب تطبيق العلامة. سيتم إنشاء العلامة تلقائيًا في الاستدعاء الأول، إذا لم تكن موجودة بعد.
5. التحقق من الأرشفة
بعد انتهاء النص البرمجي، انتقل إلى وحدتي جهات الاتصال و المحادثات في لوحة تحكم Papo. استخدم عوامل التصفية حسب العلامة لعرض العناصر المميزة بـ "مؤرشف" فقط — أو، على العكس، لإخفائها والحفاظ على التركيز على السجلات النشطة. إذا لم يكن للعملية التأثير المتوقع، راجع الحمولات ورؤوس المصادقة.
لمن هذه الأتمتة مناسبة
- العمليات ذات الحجم الكبير من جهات الاتصال التي تحتاج إلى تنظيف قاعدة البيانات بشكل دوري، وإزالة العملاء الباردين أو المحادثات المغلقة من العرض الرئيسي.
- إعادة البيع بعلامة بيضاء (white label) التي تدير عشرات حسابات العملاء وترغب في تقديم خدمة تنظيم آلية عبر واجهة برمجة التطبيقات.
- فرق تكنولوجيا المعلومات والمطورين الذين يبنون تكاملات مخصصة للحفاظ على نظام إدارة علاقات العملاء (CRM) مرتبًا دائمًا، دون الاعتماد على الإجراءات اليدوية.
- الشركات التي نقلت بياناتها من أنظمة أخرى وترغب الآن في أرشفة السجلات القديمة التي لن تستخدم بعد الآن في العمل اليومي.
الأسئلة الشائعة
هل لدى واجهة برمجة تطبيقات Papo نقطة نهاية محددة للأرشفة؟
ليست هناك حاجة إلى نقطة نهاية حصرية. أنت تستخدم نقاط نهاية تحديث جهة الاتصال وتطبيق العلامات على المحادثات لوضع علامة "مؤرشف" على السجلات. توضح الوثائق الرسمية المعلمات المقبولة.
هل يمكنني حذف جهات الاتصال أو المحادثات بدلاً من أرشفتها؟
لا توفر واجهة برمجة التطبيقات الحالية نقاط نهاية للحذف. التوصية هي استخدام الأرشفة عبر العلامات أو السمات المخصصة، والتي تحافظ على البيانات محفوظة ولكن خارج العرض الرئيسي.
كيف أقوم بمصادقة الطلبات؟
قم بتضمين الرأس Authorization: Bearer {sua_chave_secreta} في جميع استدعاءات الكتابة. يتم إنشاء المفتاح السري في لوحة تحكم Papo، في قسم المطورين.
هل من الممكن أرشفة آلاف السجلات دفعة واحدة؟
نعم. ما عليك سوى إنشاء نص برمجي يقوم بالتنقل عبر قائمة جهات الاتصال أو المحادثات وإرسال طلب لكل منها. يمكن لأدوات مثل n8n أيضًا تنسيق هذه العملية.
هل تختفي المحادثات المؤرشفة من صندوق الوارد؟
تظل موجودة، ولكن عند تطبيق علامة مثل "مؤرشف"، يمكنك تصفيتها لإخراجها من العرض الافتراضي. تعتمد طريقة العرض على عوامل التصفية المكونة في وحدة المحادثات.
أين أجد مفاتيح API؟
في لوحة تحكم Papo، انتقل إلى منطقة المطورين أو إعدادات API. يظهر المفتاح السري فقط في وقت الإنشاء؛ إذا فُقد، فسيكون من الضروري إنشاء مفتاح جديد.
اقرأ أيضًا
- كيفية استخدام واجهة برمجة تطبيقات Papo لإدراج المحادثات وإرسال رسائل برمجية
- كيفية استخدام واجهة برمجة تطبيقات Papo لإدارة السمات المخصصة لجهات الاتصال
ابدأ مجانًا ونظّم قاعدة بياناتك باستخدام API →
مع الخطة المجانية من Papo، يمكنك بالفعل اختبار التكامل وأرشفة جهات الاتصال والمحادثات بشكل جماعي دون تكلفة أولية.