لتصدير مقاييس تقارير Papo (https://papo.global/) إلى جداول بيانات مثل Excel أو Google Sheets، يمكنك استخدام API العامة للمنصة أو تكوين webhooks التي ترسل البيانات في الوقت الفعلي إلى أدوات الأتمتة. يتيح هذا التكامل إنشاء لوحات معلومات مخصصة وتحليلات تتجاوز اللوحات الأصلية، من خلال الجمع بين معلومات المحادثات وأداء الوكلاء ونتائج قمع المبيعات.
تقدم Papo بالفعل مركزًا كاملاً للتقارير مع رؤى حول حجم الخدمة، وSLA، والتحويلات، وترتيب الوكلاء. ومع ذلك، هناك سيناريوهات تحتاج فيها إلى دمج هذه البيانات مع جداول بيانات داخلية، أو حساب مقاييس خاصة، أو توحيد المعلومات من مصادر متعددة. بدلاً من التصدير يدويًا، تقوم API و webhooks بأتمتة هذا التدفق.
ملخص طرق التصدير
| الطريقة | مناسبة لـ | كيف تعمل في Papo |
|---|---|---|
| API التقارير | استعلامات مجدولة ولوحات معلومات مخصصة | نقاط نهاية REST تُرجع مقاييس الوكلاء و CSAT بتنسيق JSON؛ يمكن استهلاكها بواسطة نصوص برمجية أو أدوات ETL. |
| Webhooks | استقبال الأحداث في الوقت الفعلي (مثل: صفقة جديدة مغلقة) | ترسل Papo إشعارات HTTP إلى عنوان URL مُهيأ كلما حدث حدث معين، مثل نقل عملية بيع إلى "Ganho" في Kanban. |
| التصدير اليدوي (عبر الواجهة) | تحليلات سريعة وعرضية | داخل وحدة Reports، يمكنك عرض ونسخ البيانات، ولكن لا يوجد زر تنزيل مباشر إلى CSV. API هي المسار الموصى به لتصدير كميات أكبر. |
كيفية تصدير المقاييس باستخدام API Papo
تتيح API Papo الوصول برمجيًا إلى نفس البيانات التي تراها في التقارير. حاليًا، تتوفر نقاط نهاية للاستعلام عن ملخص الأداء لكل وكيل ومقاييس الرضا (CSAT). لاستهلاك هذه البيانات في جداول البيانات:
-
أنشئ بيانات اعتماد API الخاصة بك
انتقل إلى إعدادات API في حسابك على Papo وأنشئ زوجًا من المفاتيح العامة/الخاصة. هذه العملية مفصلة في المقالة كيفية إنشاء مفتاح عام ومفتاح سري لواجهة برمجة تطبيقات Papo. -
اختر أداة الاستهلاك
يمكنك استخدام Google Sheets مع نصوص Apps Script، أو منصة أتمتة مثل N8N أو Zapier، أو حتى جدول بيانات Excel مع استعلامات عبر Power Query. المهم أن تكون الأداة قادرة على إجراء طلبات HTTP مصادق عليها. -
قم ببناء الطلب
مثال مفاهيمي: للحصول على الأداء لكل وكيل، قم بإجراء استدعاء GET إلى نقطة النهاية المقابلة (التوثيق الدقيق متاح في بوابة API الخاصة بـ Papo). مرر مفاتيح المصادقة، وإذا أردت، معلمات الفترة (sinceوuntilبتنسيق Unix timestamp). -
حوّل البيانات إلى جدول
ستأتي الاستجابة بتنسيق JSON مع حقول مثلresolved_countوsla_percentageوavg_first_response_time. في جدول البيانات الخاص بك، قم بهيكلة هذه البيانات في أعمدة، وإذا لزم الأمر، أتمت التحديث باستخدام مشغلات زمنية.
التعليمات الكاملة مع نقاط النهاية والمعلمات وأمثلة التعليمات البرمجية موجودة في التوثيق الرسمي لـ API Papo، ويمكن الوصول إليها بعد تسجيل الدخول.
كيفية استخدام webhooks لتغذية جداول البيانات في الوقت الفعلي
إذا كانت حاجتك هي التقاط أحداث المبيعات أو تحديثات المحادثة فورًا، فإن webhooks هي الخيار الأفضل. في Papo، يمكنك تكوين عناوين URL وجهة حيث سترسل المنصة إشعارات عند حدوث إجراء ذي صلة، مثل نقل صفقة إلى عمود "Ganho" في Kanban.
لدمج ذلك مع جداول البيانات:
-
استخدم أداة أتمتة كوسيط
نظرًا لأن webhook يرسل البيانات إلى عنوان URL، فأنت بحاجة إلى مستقبل يفسرها ويدرجها في جدول البيانات. يشرح الدليل لإرسال بيانات جهات الاتصال الجديدة إلى Google Sheets عبر webhook المبدأ الأساسي، والذي يمكن تكييفه مع أحداث المبيعات. -
قم بتكوين webhook في Papo
في إعدادات الحساب، أدخل عنوان URL الذي تم إنشاؤه بواسطة الأداة الوسيطة (N8N، Zapier، إلخ). هناك يمكنك تعيين الحدث الذي يجب أن يطلق الإرسال (على سبيل المثال، "صفقة مغلقة"). -
قم بهيكلة جدول البيانات تلقائيًا
سيضيف كل حدث جديد صفًا في جدول البيانات الخاص بك مع بيانات مثل قيمة الصفقة، وجهة الاتصال، والوكيل المسؤول، والتاريخ. وبذلك، تبني سجلاً تراكميًا لتحليلات القمع والعمولات.
لمن يكون هذا التصدير مفيدًا
- محللو البيانات وذكاء الأعمال: الذين يحتاجون إلى دمج مقاييس الخدمة مع بيانات من مصادر أخرى (ERP، CRM خارجي) باستخدام أدوات مثل Power BI أو Google Data Studio.
- المديرون الماليون: الذين يرغبون في حساب العمولات بناءً على مكاسب Kanban بطريقة آلية.
- العمليات التي لديها بالفعل لوحات معلومات خارجية: وترغب في تغذية هذه اللوحات ببيانات المحادثات دون مغادرة التدفق الحالي.
- الفرق التي تحتاج إلى تقارير مخصصة: تتجاوز النماذج القياسية لوحدة Reports في Papo.
هل توفر Papo زر تنزيل للتقارير بتنسيق CSV أو Excel؟
حاليًا، لا تحتوي وحدة Reports في Papo على وظيفة أصلية للتصدير المباشر إلى CSV أو Excel. الطريقة الموصى بها لنقل البيانات إلى جداول بيانات خارجية هي عبر API، التي توفر نفس البيانات بشكل منظم وقابل للتحديث.
ما المقاييس المتاحة في API؟
توفر API العامة لـ Papo نقاط نهاية للاستعلام عن ملخص الأداء لكل وكيل (المحادثات التي تم حلها، SLA، إلخ) وردود استبيان CSAT (تقييمات من 1 إلى 5). يسرد التوثيق الرسمي جميع الحقول المتاحة.
هل يمكنني تصدير بيانات قمع المبيعات (Kanban)؟
نعم. على الرغم من أن نقطة النهاية المحددة لـ Kanban غير مفصلة في المواد المرجعية المقدمة، يمكنك استخدام webhooks لالتقاط الأحداث عندما يتم نقل صفقة إلى "Ganho" وبالتالي تغذية جداول البيانات بالقيم وجهات الاتصال. راجع توثيق API للحصول على نقاط نهاية إضافية.
هل أحتاج إلى معرفة البرمجة لاستخدام API؟
يعتمد ذلك على مستوى الأتمتة المطلوب. تسمح أدوات مثل Zapier و N8N بإنشاء تكاملات بقليل من البرمجة أو بدونها. بالنسبة للنصوص البرمجية الأكثر تعقيدًا، فإن المعرفة الأساسية بطلبات HTTP ومعالجة JSON كافية.
أين أجد التوثيق الكامل لـ API؟
التوثيق الكامل، مع نقاط النهاية والمعلمات والأمثلة، متاح في بوابة API الخاصة بـ Papo (https://papo.global/docs) بمجرد تسجيل الدخول إلى المنصة.
هل يمكنني استخدام webhooks لتغذية Google Sheets؟
نعم. قم بتكوين webhook في Papo يشير إلى عنوان URL وسيط (عبر N8N أو Zapier أو Apps Script)، والذي بدوره يدرج البيانات في Google Sheets. راجع الدليل الأساسي في كيفية إرسال بيانات جهات الاتصال الجديدة إلى Google Sheets عبر webhook.
اقرأ أيضًا
- كيفية إنشاء مفتاح عام ومفتاح سري لواجهة برمجة تطبيقات Papo
- كيفية إرسال بيانات جهات الاتصال الجديدة إلى Google Sheets عبر webhook
- كيفية إنشاء تقرير شهري للإنتاجية لكل وكيل
- نظرة عامة على التقارير: أين تجد كل مقياس في Papo
مركز مقاييسك في جداول البيانات لإجراء تحليلات متقدمة واتخاذ قرارات مبنية على البيانات دون الاعتماد على الصادرات اليدوية.