Cara Menggunakan API Papo untuk Memantau Konsumsi Kredit dan Faktur Reseller White Label

Untuk memantau konsumsi kredit dan faktur klien white label Anda di Papo (https://papo.global/), Anda menggunakan endpoint administrasi akun API untuk mendaftar portofolio Anda dan memeriksa status modul — dan menggabungkan data ini dengan ekspor berkala dari modul Laporan dan portal penagihan untuk membangun dasbor dan peringatan penagihan otomatis.

Meskipun API Papo saat ini tidak memiliki endpoint khusus yang secara langsung mengembalikan saldo kredit WhatsApp atau nilai faktur, fitur manajemen akun, ditambah dengan alat pelaporan yang sudah ada di platform, memungkinkan Anda mengotomatiskan sebagian besar rutinitas kontrol keuangan reseller white label Anda.

Ringkasan Strategi Pemantauan dengan API dan Laporan

Sumber Daya	Apa yang Dilakukan	Bagaimana Berkontribusi pada Pemantauan
Daftar akun (API)	Mengembalikan semua akun klien di bawah reseller white label Anda	Mengidentifikasi siapa yang aktif dan perlu dipantau
Verifikasi modul (API)	Menunjukkan apakah modul seperti WhatsApp dan Extrator aktif di setiap akun	Mengonfirmasi klien mana yang mengonsumsi kredit
Laporan percakapan (via modul Laporan)	Memfilter percakapan dan template yang dikirim berdasarkan kotak masuk, dengan ekspor CSV	Menyediakan volume yang memungkinkan perhitungan pengeluaran kredit bulanan
Portal penagihan (via Stripe, dengan merek Anda)	Klien melakukan pembelian kredit secara mandiri; riwayat transaksi tersedia untuk reseller	Memantau isi ulang dan pendapatan, tanpa memerlukan API khusus untuk faktur

Bagaimana Pemantauan Saat Ini Bekerja

Dalam reseller white label, setiap klien memiliki akun sendiri di dalam platform. Konsumsi kredit WhatsApp ditentukan oleh jumlah percakapan yang dimulai dan template yang dikirim — metrik yang ditampilkan oleh modul Laporan Papo yang difilter berdasarkan kotak masuk. API, pada gilirannya, menawarkan endpoint super administrator yang memungkinkan Anda mendaftar semua akun reseller Anda dan memeriksa status modul, tetapi tidak secara native menyertakan jumlah kredit yang dikonsumsi atau faktur yang diterbitkan.

Untuk membangun kontrol otomatis, praktik yang direkomendasikan adalah menggabungkan dua sumber:

API manajemen akun: gunakan untuk mendapatkan, secara programatik, daftar klien yang diperbarui, pengidentifikasi mereka, dan modul mana yang aktif. Dengan ini Anda tahu persis siapa yang menggunakan WhatsApp dan, oleh karena itu, mengonsumsi kredit.
Ekspor dari modul Laporan: secara berkala, unduh (atau jadwalkan, melalui skrip, jika memungkinkan) file CSV dari laporan percakapan per kotak masuk. File ini berisi volume percakapan dan template yang, dikalikan dengan tabel harga Meta, mengungkapkan perkiraan pengeluaran.

Dengan kedua basis data yang dikonsolidasikan dalam spreadsheet, database, atau alat BI, Anda dapat menghasilkan dasbor konsumsi dan mengonfigurasi peringatan manual atau melalui webhook eksternal ketika penggunaan mendekati batas yang disepakati.

Langkah demi Langkah untuk Mengotomatiskan Dasbor Kredit

Dapatkan token API reseller white label Anda
Di panel reseller, buat kredensial super administrator. Token ini akan memberikan akses ke endpoint daftar akun dan verifikasi modul.
Daftar semua akun secara berkala
Lakukan panggilan ke endpoint yang mengembalikan akun klien reseller Anda. Dengan begitu Anda menjaga katalog yang selalu diperbarui, dengan ID setiap klien.
Untuk setiap akun, verifikasi modul yang aktif
Dengan endpoint status modul, konfirmasi apakah klien memiliki WhatsApp (dan saluran lain yang mengonsumsi kredit) aktif. Ini menghindari memproses klien yang tidak aktif atau dalam jeda.
Ekspor laporan konsumsi
Akses modul Laporan Papo, pilih periode yang diinginkan, filter berdasarkan saluran WhatsApp dan kotak masuk setiap klien. Gunakan opsi ekspor CSV untuk mengunduh data percakapan yang dimulai dan template yang dikirim.
Hitung pengeluaran dan buat peringatan Anda
Gabungkan CSV dengan daftar akun aktif dan terapkan harga kredit Meta. Di spreadsheet, format secara kondisional untuk menyoroti klien yang konsumsinya berada di, misalnya, 80% dari batas paket. Atau jadwalkan eksekusi otomatis perhitungan ini jika Anda menggunakan skrip.
Pantau faktur melalui portal penagihan
Pembelian kredit yang dilakukan oleh klien tercatat di portal penagihan (Stripe Billing), yang mewarisi identitas visual Anda. Anda dapat mengakses riwayat transaksi langsung di panel reseller untuk memeriksa pendapatan dan isi ulang.

Untuk Siapa Pemantauan Ini Penting

Reseller white label dengan puluhan klien aktif di WhatsApp, yang perlu menghindari gangguan karena kekurangan kredit.
Agensi pemasaran yang menyertakan manajemen kredit sebagai bagian dari layanan dan menginginkan laporan bulanan otomatis.
Software house yang mengintegrasikan Papo ke sistem penagihan mereka sendiri, menggunakan daftar klien yang disediakan oleh API sebagai basis untuk penagihan.
Konsultan yang ingin menawarkan laporan kinerja dan kontrol pengeluaran kepada klien mereka, dengan merek Anda.

Pertanyaan yang Sering Diajukan

Apakah API Papo memiliki endpoint untuk memeriksa saldo kredit WhatsApp?

Saat ini, API publik tidak menyertakan endpoint yang mengembalikan saldo kredit. Informasi konsumsi diambil dari modul Laporan, seperti yang dijelaskan dalam artikel ini. Untuk pembaruan, lihat dokumentasi di https://papo.global/docs.

Bisakah saya menerbitkan faktur atau memeriksa tagihan langsung melalui API?

Tidak. Penagihan dan manajemen faktur dilakukan oleh portal penagihan (Stripe Billing). Data transaksi tersedia di panel reseller, tanpa API khusus.

Apakah ada webhook yang memberi tahu ketika kredit habis?

Saat ini Papo tidak mengirim peringatan otomatis tentang kredit rendah. Rekomendasinya adalah membuat kontrol eksternal yang menggabungkan data konsumsi yang diekspor dan memicu notifikasi ketika penggunaan mendekati batas.

Endpoint API mana yang benar-benar membantu dalam pemantauan?

Endpoint administrasi akun: daftar semua akun reseller, verifikasi status modul dan, jika perlu, aktifkan atau nonaktifkan modul seperti WhatsApp. Dengan ini Anda mengotomatiskan identifikasi klien mana yang mengonsumsi kredit.

Bisakah klien membeli kredit sendiri?

Ya. Anda dapat membuat tautan checkout isi ulang kredit di panel reseller dan menyediakannya untuk klien. Mereka mengakses portal penagihan dengan merek Anda, membayar, dan kredit ditambahkan secara otomatis. Pelajari lebih lanjut di artikel tentang isi ulang kredit white label.

Apakah saya memerlukan izin khusus untuk menggunakan endpoint manajemen?

Ya. Endpoint memerlukan autentikasi dengan hak istimewa super administrator, yang tersedia secara eksklusif untuk reseller white label.