كيفية استخدام API من Papo لإنشاء تقارير الاستهلاك والفوترة لعملاء البيع بالعلامة البيضاء

لإنشاء تقارير الاستهلاك والفوترة لعملاء البيع بالعلامة البيضاء باستخدام API من Papo (https://papo.global/)، يمكنك الجمع بين نقاط نهاية سرد الحسابات، والتحقق من الوحدات وصناديق الوارد، مع التصديرات الدورية من وحدة التقارير وسجل المعاملات في بوابة الفوترة — لبناء لوحات معلومات وجداول فوترة دون الاعتماد على المراجعة اليدوية في كل حساب.

على الرغم من أن API الحالية لا تحتوي على نقطة نهاية مخصصة تُرجع مباشرة عدد الرسائل المستهلكة أو قيم الفواتير، فإن الربط البرمجي للبيانات الهيكلية (من هو العميل، وما الوحدات المفعّلة، وما هي صناديق الوارد الخاصة به) مع ملفات CSV للمحادثات والقوالب يسمح ببناء تقارير فوترة مفصّلة ومؤتمتة.

ملخص الموارد المستخدمة لإنشاء تقرير الفوترة

المورد	ما الذي يوفره	كيف يساهم في الفوترة
API – سرد الحسابات	معرّفات وحالة جميع عملاء البيع بالعلامة البيضاء	يحدد كل عميل يجب أن يتلقى تقريرًا
API – التحقق من الوحدات	حالة الوحدات (WhatsApp، إلخ) لكل حساب	يرشح العملاء الذين يستهلكون الأرصدة فعلاً
API – سرد صناديق الوارد	معرّف واسم كل صندوق وارد لكل حساب	يربط كل صندوق وارد بعميل ويعزل بيانات الاستهلاك
وحدة التقارير – تصدير CSV	حجم المحادثات التي بدأت والقوالب المرسلة لكل صندوق وارد خلال الفترة	يوفر المقاييس الأساسية لحساب استهلاك الأرصدة
بوابة الفوترة (Stripe)	سجل شراء الأرصدة وإعادة التعبئة للعملاء	يكمل الفوترة بالإيراد الناتج والرصيد المتعاقد عليه

كيف يعمل إنشاء التقارير باستخدام API والتصديرات

في البيع بالعلامة البيضاء، كل عميل هو حساب منفصل، وغالبًا ما يكون له صندوق وارد خاص به (مثال: “WhatsApp – عيادة X”). تتيح API من Papo، عبر نقاط نهاية المسؤول الفائق، سرد جميع الحسابات، والتحقق من الوحدات النشطة، والحصول على صناديق الوارد لكل حساب. تنظّم هذه البيانات “مَن” و“أين” الاستهلاك. أما أرقام الاستهلاك (الرسائل والقوالب) فتأتي من وحدة التقارير، التي يمكن تصديرها بصيغة CSV لكل صندوق وارد. ويبقى سجل الفوترة متاحًا في بوابة الفوترة، وهي بعلامتك البيضاء وتحافظ على هويتك.

عند الجمع بين هذه الركائز الثلاث عبر نصوص برمجية أو جداول أو أدوات BI، تبني بشكل برمجي كشف فوترة لكل عميل، يتضمن:

تعريف الحساب وصندوق الوارد؛
إجمالي المحادثات والقوالب خلال الفترة؛
الأرصدة المستهلكة (المحسوبة من جدول Meta)؛
ملخص الاشتراك وعمليات إعادة التعبئة.

خطوات أتمتة تقرير الفوترة

احصل على رمز API للمسؤول الفائق
في لوحة البيع بالعلامة البيضاء، أنشئ بيانات الاعتماد التي ستمنح الوصول إلى نقاط نهاية إدارة الحسابات.
اسرد جميع حسابات العملاء
استدعِ نقطة النهاية التي تُرجع الحسابات الخاضعة لبيعك بالعلامة البيضاء. بهذا تحافظ على كتالوج محدّث بمعرّفات كل عميل.
لكل حساب، تحقق من الوحدات النشطة
عبر نقطة نهاية حالة الوحدات، تأكد من أن WhatsApp (أو أي قناة أخرى تولّد استهلاكًا) مفعّل. هذا يمنع معالجة العملاء غير النشطين.
اسرد صناديق الوارد لكل حساب
استخدم نقطة النهاية التي تُرجع صناديق الوارد (id، الاسم، القناة) لربط مصادر رسائل كل عميل. خزّن العلاقة بين معرّف الحساب ومعرّفات صناديق الوارد.
صدّر تقارير المحادثات
في وحدة التقارير، لكل صندوق وارد تم تحديده، اختر الفترة المطلوبة وصدّر CSV المحادثات (الذي يتضمن حجم المحادثات التي بدأت والقوالب المرسلة). يمكن جدولة هذه الخطوة عبر نص برمجي إذا كان تنزيل الملف تلقائيًا ممكنًا.
احسب استهلاك الأرصدة
ادمج CSV مع قائمة العملاء النشطين وطبّق تسعير أرصدة WhatsApp. جمّع حسب العميل والفترة، وأنشئ جدول استهلاك لكل حساب.
استرجع سجل الفواتير
ادخل إلى بوابة الفوترة (Stripe، بعلامتك) للحصول على سجل معاملات كل عميل: شراء الأرصدة، والقيم، والتواريخ. تكمل هذه المعلومات تقرير الفوترة بالإيراد الفعلي.
وحّد ووزّع
أنشئ التقرير النهائي — موضحًا الاستهلاك، والرصيد المتعاقد عليه، وعمليات إعادة التعبئة، والمبلغ الواجب فوترته — في جدول أو PDF أو لوحة معلومات. يمكن تسليم هذا الملخص للعميل بشكل دوري.

لمن تُناسب هذه الأتمتة

موزعو البيع بالعلامة البيضاء الذين لديهم عشرات أو مئات العملاء، ويحتاجون إلى إنشاء فوترة استهلاك شهرية دون التعامل مع واجهة كل حساب.
الوكالات وشركات البرمجيات التي تدمج Papo مع نظام فوترة خاص بها وتريد تغذيته ببيانات استخدام دقيقة.
العمليات التي تستخدم أدوات BI بالفعل وترغب في ربط بيانات الاستهلاك بمؤشرات أخرى للبيع بالعلامة البيضاء، مثل متوسط قيمة الطلب والتكرار.

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

هل تُرجع API من Papo مباشرة عدد رسائل WhatsApp المستهلكة؟

حاليًا لا تحتوي API على نقطة نهاية مخصصة تُرجع الرصيد أو عدد الرسائل المستهلكة. يتم الحصول على حجم المحادثات والقوالب من وحدة التقارير، التي تتيح التصدير بصيغة CSV.

هل أحتاج إلى مراجعة كل عميل يدويًا لإنشاء التقرير؟

لا. عبر نقاط نهاية سرد الحسابات والوحدات وصناديق الوارد، تحصل على كل البنية اللازمة برمجيًا. يمكن جدولة عملية تصدير ملفات CSV أو تنفيذها عبر نص برمجي، ما يقلل التدخل اليدوي إلى الحد الأدنى.

هل يمكنني أتمتة إنشاء تقرير الفوترة بشكل دوري؟

نعم. باستخدام نصوص برمجية تستدعي API وتصل إلى الملفات المصدّرة، يمكن بناء روتين ينشئ الفوترة كل شهر أو في الفترة المطلوبة. الحد يكمن في طريقة حصولك على ملفات CSV؛ إذ تتيح وحدة التقارير تصدير البيانات بشكل متكرر.

كيف أربط صندوق وارد بعميل محدد؟

استخدم نقطة نهاية سرد صناديق الوارد، التي تُرجع المعرّف والاسم والقناة لكل صندوق. وبما أن كل صندوق يتبع حسابًا، يكفي ربط معرّف الحساب المُعاد في سرد الحسابات مع صناديق الوارد المستلمة. يمكنك إنشاء ربط ثابت في نصك البرمجي.

وماذا عن بيانات الفوترة، كيف أصل إليها دون واجهة؟

تعرض بوابة الفوترة (Stripe) سجل معاملات كل عميل بعلامتك. للوصول البرمجي، يمكن استخراج هذه البيانات من اللوحة أو، إن كان متاحًا، استخدام تقارير Stripe نفسها. لا تُرجع API إدارة الحسابات من Papo الفواتير.

هل يلزم رمز خاص لهذه النقاط النهائية؟

نعم. تتطلب نقاط نهاية إدارة الحسابات وسرد صناديق الوارد مصادقة بصلاحيات مسؤول فائق، ينشئها موزع البيع بالعلامة البيضاء في لوحة الإعدادات.