White label bayiliğinizin müşterileri için Papo API'sini (https://papo.global/) kullanarak tüketim ve faturalama raporları oluşturmak için hesap listeleme, modül kontrolü ve gelen kutusu uç noktalarını Raporlar modülünün periyodik dışa aktarımları ve faturalama portalının işlem geçmişiyle birleştirirsiniz — her hesapta manuel kontrol yapmaya gerek kalmadan panolar ve faturalama tabloları oluşturursunuz.
Güncel API, tüketilen mesaj sayısını veya fatura tutarlarını doğrudan döndüren özel bir uç noktaya sahip olmasa da, yapısal verilerin (hangi müşteri, hangi modüller açık, gelen kutuları neler) konuşma ve şablon CSV dosyalarıyla programatik olarak çaprazlanması, ayrıntılı ve otomatik faturalama raporları oluşturmanızı sağlar.
Faturalama raporunu oluşturmak için kullanılan kaynakların özeti
| Kaynak | Sağladığı bilgi | Faturalamaya katkısı |
|---|---|---|
| API – hesapları listeleme | Tüm white label müşterilerinin kimlikleri ve durumları | Rapor alması gereken her müşteriyi tanımlar |
| API – modülleri kontrol etme | Hesap başına modüllerin durumu (WhatsApp vb.) | Gerçekten kredi tüketen müşterileri filtreler |
| API – gelen kutularını listeleme | Hesap başına her gelen kutusunun tanımlayıcısı ve adı | Her gelen kutusunu bir müşteriyle ilişkilendirir ve tüketim verilerini ayırır |
| Raporlar modülü – CSV dışa aktarımı | Dönem içinde gelen kutusu başına başlatılan konuşma ve gönderilen şablon hacmi | Kredi harcamasını hesaplamak için temel metrikleri sağlar |
| Faturalama portalı (Stripe) | Müşterilerin kredi satın alma ve yeniden yükleme geçmişi | Faturalamayı gerçekleşen gelir ve sözleşilen bakiye ile tamamlar |
API ve dışa aktarımlarla rapor oluşturma nasıl çalışır?
White label bayilikte her müşteri ayrı bir hesaptır ve genellikle kendi gelen kutusuna sahiptir (örn. “WhatsApp – Klinik X”). Papo API'si, süper yönetici uç noktalarıyla tüm hesapları listelemenize, hangi modüllerin etkin olduğunu kontrol etmenize ve her hesabın gelen kutularını almanıza olanak tanır. Bu veriler tüketimin “kim” ve “nerede” kısmını yapılandırır. Tüketim sayıları (mesajlar, şablonlar) ise her gelen kutusu için CSV olarak dışa aktarılabilen Raporlar modülünden gelir. Faturalama geçmişi, white label olan ve markanızı koruyan faturalama portalında bulunur.
Bu üç sütunu script'ler, tablolar veya BI araçları aracılığıyla birleştirerek her müşteri için programatik olarak bir faturalama ekstresi oluşturursunuz:
- hesabın ve gelen kutusunun tanımlanması;
- dönemdeki toplam konuşma ve şablon sayısı;
- tüketilen krediler (Meta tablosuna göre hesaplanır);
- abonelik ve gerçekleştirilen yüklemelerin özeti.
Faturalama raporunu otomatikleştirmek için adım adım kılavuz
-
Süper yönetici API token'ını edinin
White label bayilik panelinizde hesap yönetimi uç noktalarına erişim sağlayacak kimlik bilgilerini oluşturun. -
Tüm müşteri hesaplarını listeleyin
Bayiliğiniz altındaki hesapları döndüren uç noktaya bir çağrı yapın. Böylece her müşterinin kimliğini içeren güncel bir katalog tutarsınız. -
Her hesap için etkin modülleri kontrol edin
Modül durumu uç noktasıyla WhatsApp'ın (veya tüketim oluşturan başka bir kanalın) açık olup olmadığını doğrulayın. Bu, etkin olmayan müşterileri işlemenizi önler. -
Her hesabın gelen kutularını listeleyin
Her müşterinin mesaj kaynaklarını eşlemek için gelen kutularını (id, ad ve kanal) döndüren uç noktayı kullanın. Hesap kimliği ile gelen kutusu kimlikleri arasındaki ilişkiyi saklayın. -
Konuşma raporlarını dışa aktarın
Raporlar modülünde, tanımlanan her gelen kutusu için istediğiniz dönemi seçin ve konuşma CSV'sini dışa aktarın (başlatılan konuşma ve gönderilen şablon hacmini içerir). Dosyayı otomatik olarak indirmek mümkünse bu adım script ile planlanabilir. -
Kredi tüketimini hesaplayın
CSV'yi etkin müşteri listesiyle birleştirin ve WhatsApp kredi fiyatlandırmasını uygulayın. Müşteri ve döneme göre gruplayarak hesap başına tüketim tablosu oluşturun. -
Fatura geçmişini alın
Her müşterinin işlem geçmişini almak için faturalama portalına (markanızı taşıyan Stripe) erişin: kredi satın alımları, tutarlar ve tarihler. Bu bilgiler faturalama raporunu gerçek gelirle tamamlar. -
Konsolide edin ve dağıtın
Nihai raporu – tüketim, satın alınan kredi, yüklemeler ve faturalanacak tutarı göstererek – tablo, PDF veya pano olarak oluşturun. Bu konsolide rapor müşteriye düzenli olarak teslim edilebilir.
Bu otomasyon kimler için uygundur?
- White label bayiler onlarca veya yüzlerce müşteriye sahip olup her hesabın arayüzünü kullanmadan aylık tüketim faturalamaları oluşturması gerekenler.
- Papo'yu kendi faturalama sistemine entegre eden ve bunu doğru kullanım verileriyle beslemek isteyen ajanslar ve yazılım evleri.
- Halihazırda BI araçları kullanan ve tüketim verilerini ortalama sepet tutarı ve yinelenme gibi diğer bayilik göstergeleriyle çaprazlamak isteyen operasyonlar.
Sık sorulan sorular
Papo API'si tüketilen WhatsApp mesaj sayısını doğrudan döndürür mü?
Şu anda API, bakiyeyi veya tüketilen mesaj sayısını döndüren özel bir uç noktaya sahip değildir. Konuşma ve şablon hacmi, CSV dışa aktarımına izin veren Raporlar modülünden alınır.
Raporu oluşturmak için her müşteriyi manuel olarak kontrol etmem gerekiyor mu?
Hayır. Hesap, modül ve gelen kutusu listeleme uç noktalarıyla gerekli tüm yapıyı programatik olarak elde edersiniz. CSV'lerin dışa aktarım süreci planlanabilir veya script ile yürütülebilir; bu da manuel müdahaleyi en aza indirir.
Faturalama raporunun periyodik oluşturulmasını otomatikleştirebilir miyim?
Evet. API'yi çağıran ve dışa aktarılan dosyalara erişen script'ler kullanarak her ay veya istediğiniz aralıkta faturalamayı oluşturan bir rutin kurabilirsiniz. Sınır, CSV'leri edinme şeklinizdedir; Raporlar modülü verileri düzenli olarak dışa aktarmanıza izin verir.
Bir gelen kutusunu belirli bir müşteriyle nasıl ilişkilendiririm?
Her birinin kimliğini, adını ve kanalını döndüren gelen kutusu listeleme uç noktasını kullanın. Her gelen kutusu bir hesaba ait olduğundan, hesap listelemede dönen hesap kimliğini alınan gelen kutularıyla çaprazlamanız yeterlidir. Script'inizde sabit bir eşleme oluşturabilirsiniz.
Faturalama verilerine arayüz olmadan nasıl erişirim?
Faturalama portalı (Stripe), her müşterinin markanızla olan işlem geçmişini gösterir. Programatik erişim için bu verileri panelden çıkarabilir veya mevcutsa Stripe'ın kendi raporlarını kullanabilirsiniz. Papo'nun hesap yönetimi API'si fatura döndürmez.
Bu uç noktalar için özel token gerekli mi?
Evet. Hesap yönetimi ve gelen kutusu listeleme uç noktaları, white label bayinin ayarlar panelinde oluşturduğu süper yönetici ayrıcalıklarına sahip kimlik doğrulama gerektirir.
Ayrıca okuyun
- White label bayiliğin kredi tüketimini ve faturalarını izlemek için Papo API'si nasıl kullanılır
- Webhook entegrasyonuyla Power BI'da bayilik gelir panosu nasıl oluşturulur
Faturalama raporlarınızı şimdi otomatikleştirmeye başlayın →
Ücretsiz hesabınızı oluşturun, kredi kartı gerekmez ve white label bayilik süreçlerinizi entegre etmek için Papo API'sine erişin.