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

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

## ملخص استراتيجية المراقبة باستخدام واجهة برمجة التطبيقات والتقارير

| المورد | ما يفعله | كيف يساهم في المراقبة |
| :--- | :--- | :--- |
| إدراج الحسابات (API) | يُرجع جميع حسابات العملاء تحت بيعك بالعلامة البيضاء | يحدد من هو نشط ويحتاج إلى متابعة |
| التحقق من الوحدات (API) | يُظهر ما إذا كانت وحدات مثل واتساب والمستخرج مفعلة في كل حساب | يؤكد أي العملاء يستهلكون الأرصدة |
| تقارير المحادثات (عبر وحدة التقارير) | يُصفّي المحادثات والقوالب المرسلة حسب صندوق الوارد، مع التصدير إلى CSV | يوفر الأحجام التي تسمح بحساب الإنفاق الشهري للأرصدة |
| بوابة الفواتير (عبر Stripe، بعلامتك التجارية) | يقوم العميل بشراء الأرصدة بشكل مستقل؛ يظل سجل المعاملات متاحًا للموزع | يتابع عمليات إعادة الشحن والإيرادات، دون الحاجة إلى واجهة برمجة تطبيقات مخصصة للفواتير |

## كيف تعمل المراقبة الحالية

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

لإنشاء تحكم آلي، الممارسة الموصى بها هي الجمع بين مصدرين:

- **واجهة برمجة تطبيقات إدارة الحسابات:** استخدمها للحصول، برمجيًا، على القائمة المحدثة للعملاء ومعرفاتهم وأي الوحدات نشطة. بهذا تعرف بالضبط من يستخدم واتساب، وبالتالي يستهلك الأرصدة.
- **صادرات وحدة التقارير:** قم بشكل دوري بتنزيل (أو جدولة، عبر برنامج نصي، إن أمكن) ملف CSV لتقرير المحادثات حسب صندوق الوارد. يحتوي هذا الملف على أحجام المحادثات والقوالب التي، عند ضربها في جدول أسعار Meta، تكشف النفقات المقدرة.

مع دمج القاعدتين في جدول بيانات أو قاعدة بيانات أو أداة ذكاء أعمال، يمكنك إنشاء لوحات معلومات للاستهلاك وإعداد تنبيهات يدوية أو عبر webhook خارجي عندما يقترب الاستخدام من الحد المتعاقد عليه.

## خطوة بخطوة لأتمتة لوحة معلومات الأرصدة

1. **احصل على رمز API لبيعك بالعلامة البيضاء**  
   في لوحة الموزع، قم بإنشاء بيانات اعتماد المشرف العام. سيمنحك هذا الرمز حق الوصول إلى نقاط نهاية إدراج الحسابات والتحقق من الوحدات.

2. **أدرج جميع الحسابات بشكل دوري**  
   قم بإجراء استدعاءات إلى نقطة النهاية التي تُرجع حسابات العملاء لبيعك. بهذه الطريقة تحافظ على كتالوج محدث دائمًا، مع معرفات كل عميل.

3. **لكل حساب، تحقق من الوحدات النشطة**  
   باستخدام نقطة نهاية حالة الوحدات، تأكد من أن العميل لديه واتساب (والقنوات الأخرى التي تستهلك الأرصدة) مفعل. هذا يتجنب معالجة العملاء غير النشطين أو الموقوفين مؤقتًا.

4. **صدّر تقارير الاستهلاك**  
   انتقل إلى وحدة التقارير من Papo، وحدد الفترة المطلوبة، وقم بالتصفية حسب قناة واتساب وصندوق الوارد لكل عميل. استخدم خيار تصدير CSV لتنزيل بيانات المحادثات التي بدأت والقوالب المرسلة.

5. **احسب النفقات وقم بإعداد تنبيهاتك**  
   اجمع ملف CSV مع قائمة الحسابات النشطة وطبق تسعير الأرصدة من Meta. في جداول البيانات، استخدم التنسيق الشرطي لإبراز العملاء الذين يصل استهلاكهم إلى، على سبيل المثال، 80% من حد الخطة. أو جدولة تنفيذ تلقائي لهذا الحساب إذا كنت تستخدم برامج نصية.

6. **تابع الفواتير عبر بوابة الفواتير**  
   يتم تسجيل عمليات شراء الأرصدة التي يقوم بها العملاء في بوابة الفواتير (Stripe Billing)، التي ترث هويتك البصرية. يمكنك الوصول إلى سجل المعاملات مباشرة في لوحة الموزع للتحقق من الإيرادات وعمليات إعادة الشحن.

## لمن تكون هذه المراقبة ضرورية

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

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

### هل تحتوي واجهة برمجة تطبيقات Papo على نقطة نهاية للاستعلام عن رصيد أرصدة واتساب؟
في الوقت الحالي، لا تتضمن واجهة برمجة التطبيقات العامة نقطة نهاية تُرجع رصيد الأرصدة. يتم استخراج معلومات الاستهلاك من وحدة التقارير، كما هو موضح في هذه المقالة. للاطلاع على المستجدات، راجع الوثائق على https://papo.global/docs.

### هل يمكنني إصدار فواتير أو الاستعلام عن المدفوعات مباشرة عبر واجهة برمجة التطبيقات؟
لا. تتم الفوترة وإدارة الفواتير عبر بوابة الفواتير (Stripe Billing). بيانات المعاملات متاحة في لوحة الموزع، دون واجهة برمجة تطبيقات مخصصة.

### هل يوجد webhook يُعلم عند نفاد الأرصدة؟
حاليًا، لا ترسل Papo تنبيهات تلقائية عند انخفاض الأرصدة. التوصية هي إنشاء تحكم خارجي يجمع بيانات الاستهلاك المصدرة ويطلق إشعارات عندما يقترب الاستخدام من الحد.

### ما هي نقاط نهاية API التي تساعد فعلاً في المراقبة؟
نقاط نهاية إدارة الحسابات: إدراج جميع حسابات البيع، والتحقق من حالة الوحدات، وإذا لزم الأمر، تفعيل أو تعطيل وحدات مثل واتساب. بها يمكنك أتمتة تحديد العملاء الذين يستهلكون الأرصدة.

### هل يمكن للعميل شراء الأرصدة بنفسه؟
نعم. يمكنك إنشاء رابط دفع لإعادة شحن الأرصدة في لوحة الموزع وتوفيره للعميل. يصل العميل إلى بوابة الفواتير بعلامتك التجارية، ويدفع، وتُضاف الأرصدة تلقائيًا. اعرف المزيد في المقالة حول إعادة شحن أرصدة العلامة البيضاء.

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

## اقرأ أيضًا

- [كيفية إنشاء تقارير الاستخدام لعملاء البيع بالعلامة البيضاء](/hc/papo/articles/how-to-generate-usage-reports-whitelabel-resellers)
- [كيفية السماح لعملاء العلامة البيضاء بشراء أرصدة واتساب في بوابة الفواتير](/hc/papo/articles/allow-white-label-clients-buy-whatsapp-credits-billing-portal)

---

**[ابدأ البيع بعلامتك التجارية →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=papo-api-monitor-credits-invoices-white-label&utm_content=ar)**

مع البيع بالعلامة البيضاء من Papo، يمكنك تقديم الذكاء الاصطناعي وإدارة علاقات العملاء وواتساب باسمك وشعارك وألوانك ونطاقك — وبناء محفظة عملاء تدر إيرادات متكررة كل شهر.