Cara Menggunakan API Papo untuk Membuat Laporan Konsumsi dan Penagihan untuk Klien White Label

Untuk membuat laporan konsumsi dan penagihan bagi klien reseller white label Anda menggunakan API Papo (https://papo.global/), Anda menggabungkan endpoint daftar akun, pemeriksaan modul dan kotak masuk dengan ekspor berkala dari modul Laporan serta riwayat transaksi portal penagihan — membangun dasbor dan spreadsheet penagihan tanpa bergantung pada pemeriksaan manual di setiap akun.

Meskipun API saat ini tidak memiliki endpoint khusus yang langsung mengembalikan jumlah pesan yang dikonsumsi atau nilai tagihan, penggabungan data struktural secara programatik (siapa klien, modul mana yang aktif, apa saja kotak masuknya) dengan file CSV percakapan dan template memungkinkan penyusunan laporan penagihan yang terperinci dan otomatis.

Ringkasan fitur yang digunakan untuk membuat laporan penagihan

Fitur	Yang disediakan	Kontribusi untuk penagihan
API – daftar akun	ID dan status semua klien white label	Mengidentifikasi setiap klien yang harus menerima laporan
API – periksa modul	Status modul (WhatsApp, dll.) per akun	Memfilter klien yang benar-benar mengonsumsi kredit
API – daftar kotak masuk	Pengenal dan nama setiap kotak masuk per akun	Menghubungkan setiap kotak masuk ke klien dan mengisolasi data konsumsi
Modul Laporan – ekspor CSV	Volume percakapan yang dimulai dan template yang dikirim per kotak masuk pada periode	Menyediakan metrik dasar untuk menghitung pengeluaran kredit
Portal penagihan (Stripe)	Riwayat pembelian kredit dan isi ulang klien	Melengkapi penagihan dengan pendapatan yang dihasilkan dan saldo yang dikontrakkan

Cara kerja pembuatan laporan dengan API dan ekspor

Dalam reseller white label, setiap klien adalah akun terpisah dan biasanya memiliki kotak masuk sendiri (mis.: “WhatsApp – Klinik X”). API Papo, dengan endpoint super administrator, memungkinkan Anda mendaftar semua akun, memeriksa modul mana yang aktif, dan mendapatkan kotak masuk setiap akun. Data ini menyusun “siapa” dan “di mana” konsumsi. Sementara angka konsumsi (pesan, template) berasal dari modul Laporan, yang dapat diekspor ke CSV untuk setiap kotak masuk. Riwayat penagihan tersedia di portal penagihan, yang white label dan mempertahankan merek Anda.

Dengan menggabungkan ketiga pilar ini melalui skrip, spreadsheet, atau alat BI, Anda dapat menyusun secara programatik laporan penagihan untuk setiap klien, dengan:

identifikasi akun dan kotak masuk;
total percakapan dan template periode;
kredit yang dikonsumsi (dihitung dari tabel Meta);
ringkasan langganan dan isi ulang yang dilakukan.

Langkah demi langkah untuk mengotomatiskan laporan penagihan

Dapatkan token API super administrator
Di panel reseller white label Anda, buat kredensial yang akan memberi akses ke endpoint pengelolaan akun.
Daftar semua akun klien
Lakukan panggilan ke endpoint yang mengembalikan akun di bawah reseller Anda. Dengan begitu Anda menjaga katalog tetap mutakhir dengan ID setiap klien.
Untuk setiap akun, periksa modul yang aktif
Dengan endpoint status modul, pastikan WhatsApp (atau kanal lain yang menghasilkan konsumsi) aktif. Ini menghindari memproses klien yang tidak aktif.
Daftar kotak masuk setiap akun
Gunakan endpoint yang mengembalikan kotak masuk (id, nama, dan kanal) untuk memetakan asal pesan setiap klien. Simpan hubungan antara ID akun dan ID kotak masuk.
Ekspor laporan percakapan
Di modul Laporan, untuk setiap kotak masuk yang teridentifikasi, pilih periode yang diinginkan dan ekspor CSV percakapan (yang mencakup volume percakapan yang dimulai dan template yang dikirim). Langkah ini dapat dijadwalkan dengan skrip jika file dapat diunduh secara otomatis.
Hitung konsumsi kredit
Gabungkan CSV dengan daftar klien aktif dan terapkan penetapan harga kredit WhatsApp. Kelompokkan per klien dan periode, menghasilkan tabel konsumsi per akun.
Ambil riwayat tagihan
Akses portal penagihan (Stripe, dengan merek Anda) untuk mendapatkan riwayat transaksi setiap klien: pembelian kredit, nilai, dan tanggal. Informasi ini melengkapi laporan penagihan dengan pendapatan sebenarnya.
Konsolidasikan dan distribusikan
Susun laporan akhir – menunjukkan konsumsi, kredit yang dikontrakkan, isi ulang, dan nilai yang akan ditagihkan – dalam spreadsheet, PDF, atau dasbor. Rekap ini dapat dikirimkan secara berkala kepada klien.

Untuk siapa otomatisasi ini cocok

Reseller white label dengan puluhan atau ratusan klien, yang perlu membuat penagihan konsumsi bulanan tanpa memanipulasi antarmuka setiap akun.
Agensi dan software house yang mengintegrasikan Papo ke sistem penagihan sendiri dan ingin mengisinya dengan data penggunaan yang akurat.
Operasi yang sudah menggunakan alat BI dan ingin menggabungkan data konsumsi dengan indikator reseller lainnya, seperti nilai transaksi rata-rata dan retensi.

Pertanyaan umum

Apakah API Papo langsung mengembalikan jumlah pesan WhatsApp yang dikonsumsi?

Saat ini API tidak memiliki endpoint khusus yang mengembalikan saldo atau jumlah pesan yang dikonsumsi. Volume percakapan dan template diperoleh melalui modul Laporan, yang memungkinkan ekspor dalam CSV.

Apakah saya perlu memeriksa setiap klien secara manual untuk membuat laporan?

Tidak. Dengan endpoint daftar akun, modul, dan kotak masuk, Anda mendapatkan seluruh struktur yang diperlukan secara programatik. Proses ekspor CSV dapat dijadwalkan atau dijalankan dengan skrip, sehingga meminimalkan campur tangan manual.

Bisakah saya mengotomatiskan pembuatan laporan penagihan secara berkala?

Ya. Dengan menggunakan skrip yang memanggil API dan mengakses file yang diekspor, Anda dapat membuat rutinitas yang menghasilkan penagihan setiap bulan atau pada interval yang diinginkan. Batasannya terletak pada cara Anda mendapatkan CSV; modul Laporan memungkinkan ekspor data secara berulang.

Bagaimana cara menghubungkan kotak masuk ke klien tertentu?

Gunakan endpoint daftar kotak masuk, yang mengembalikan ID, nama, dan kanal setiap kotak masuk. Karena setiap kotak masuk dimiliki oleh satu akun, cukup cocokkan ID akun yang dikembalikan dalam daftar akun dengan kotak masuk yang diterima. Anda dapat membuat pemetaan tetap di skrip Anda.

Bagaimana dengan data penagihan, bagaimana saya mengaksesnya tanpa antarmuka?

Portal penagihan (Stripe) menampilkan riwayat transaksi setiap klien dengan merek Anda. Untuk akses programatik, Anda dapat mengekstrak data ini dari panel atau, jika tersedia, menggunakan laporan dari Stripe sendiri. API pengelolaan akun Papo tidak mengembalikan tagihan.

Apakah diperlukan token khusus untuk endpoint ini?

Ya. Endpoint administrasi akun dan daftar kotak masuk memerlukan autentikasi dengan hak istimewa super administrator, yang dibuat oleh reseller white label di panel pengaturan.