**Para monitorar o consumo de créditos e as faturas dos seus clientes white label na Papo (https://papo.global/), você utiliza os endpoints de administração de contas da API para listar sua carteira e verifica o estado dos módulos — e combina esses dados com as exportações periódicas do módulo Relatórios e do portal de faturamento para construir dashboards e alertas de faturamento automáticos.**

Embora a API atual da Papo não disponha de um endpoint dedicado que retorne diretamente o saldo de créditos de WhatsApp ou os valores de faturas, os recursos de gestão de contas, somados às ferramentas de relatório já presentes na plataforma, permitem que você automatize boa parte da rotina de controle financeiro da sua revenda white label.

## Resumo da estratégia de monitoramento com API e Relatórios

| Recurso | O que faz | Como contribui para o monitoramento |
| :--- | :--- | :--- |
| Listar contas (API) | Retorna todas as contas de clientes sob sua revenda white label | Identifica quem está ativo e precisa ser acompanhado |
| Verificar módulos (API) | Mostra se módulos como WhatsApp e Extrator estão ligados em cada conta | Confirma quais clientes estão consumindo créditos |
| Relatórios de conversas (via módulo Relatórios) | Filtra conversas e templates enviados por caixa de entrada, com exportação em CSV | Fornece os volumes que permitem calcular o gasto mensal de créditos |
| Portal de faturamento (via Stripe, com a sua marca) | O cliente realiza a compra de créditos de forma autônoma; o histórico de transações fica disponível para o revendedor | Acompanha recargas e receitas, sem precisar de uma API específica para faturas |

## Como funciona o monitoramento atual

Na revenda white label, cada cliente possui sua própria conta dentro da plataforma. O consumo de créditos do WhatsApp é determinado pelo número de conversas iniciadas e templates enviados — métricas que o módulo Relatórios da Papo exibe filtradas por caixa de entrada. A API, por sua vez, oferece endpoints de super administrador que permitem listar todas as contas da sua revenda e verificar o estado dos módulos, mas não traz, nativamente, os números de créditos consumidos ou faturas emitidas.

Para montar um controle automatizado, a prática recomendada é cruzar duas fontes:

- **API de gestão de contas:** use‑a para obter, de forma programática, a relação atualizada de clientes, seus identificadores e quais módulos estão ativos. Com isso você sabe exatamente quem está usando o WhatsApp e, portanto, consumindo créditos.
- **Exportações do módulo Relatórios:** periodicamente, baixe (ou agende, via script, se possível) o arquivo CSV do relatório de conversas por caixa de entrada. Esse arquivo contém os volumes de conversas e templates que, multiplicados pela tabela de preços da Meta, revelam o gasto estimado.

Com as duas bases consolidadas em uma planilha, um banco de dados ou uma ferramenta de BI, você pode gerar dashboards de consumo e configurar alertas manuais ou via webhook externo quando o uso se aproximar do limite contratado.

## Passo a passo para automatizar o dashboard de créditos

1. **Obtenha o token de API da sua revenda white label**  
   No painel de revendedor, gere as credenciais de super administrador. Esse token dará acesso aos endpoints de listagem de contas e verificação de módulos.

2. **Liste todas as contas periodicamente**  
   Faça chamadas ao endpoint que retorna as contas de clientes da sua revenda. Assim você mantém um catálogo sempre atualizado, com IDs de cada cliente.

3. **Para cada conta, verifique os módulos ativos**  
   Com o endpoint de estado de módulos, confirme se o cliente está com o WhatsApp (e demais canais que consomem crédito) ligado. Isso evita processar clientes inativos ou que estão em pausa.

4. **Exporte os relatórios de consumo**  
   Acesse o módulo Relatórios da Papo, selecione o período desejado, filtre pelo canal WhatsApp e pela caixa de entrada de cada cliente. Utilize a opção de exportação CSV para baixar os dados de conversas iniciadas e templates enviados.

5. **Calcule o gasto e monte seus alertas**  
   Combine o CSV com a lista de contas ativas e aplique a precificação de créditos da Meta. Em planilhas, formate condicionalmente para destacar os clientes cujo consumo está a, por exemplo, 80% do limite do plano. Ou agende execuções automáticas desse cálculo se estiver usando scripts.

6. **Acompanhe as faturas pelo portal de faturamento**  
   As compras de créditos realizadas pelos clientes ficam registradas no portal de faturamento (Stripe Billing), que herda a sua identidade visual. Você pode acessar o histórico de transações diretamente no painel do revendedor para conferir receitas e recargas.

## Para quem esse monitoramento é essencial

- **Revendedores white label** com dezenas de clientes ativos no WhatsApp, que precisam evitar interrupções por falta de crédito.
- **Agências de marketing** que incluem a gestão de créditos como parte do serviço e desejam relatórios mensais automatizados.
- **Software houses** que integram a Papo a sistemas próprios de faturamento, usando a lista de clientes fornecida pela API como base para cobrança.
- **Consultorias** que querem oferecer relatórios de desempenho e controle de gasto aos seus clientes, com a sua marca.

## Perguntas frequentes

### A API da Papo tem um endpoint para consultar o saldo de créditos do WhatsApp?
No momento, a API pública não inclui um endpoint que retorne o saldo de créditos. As informações de consumo são extraídas do módulo Relatórios, conforme descrito neste artigo. Para novidades, consulte a documentação em https://papo.global/docs.

### Posso emitir faturas ou consultar cobranças diretamente pela API?
Não. A cobrança e a gestão de faturas são realizadas pelo portal de faturamento (Stripe Billing). Os dados de transações estão disponíveis no painel do revendedor, sem uma API dedicada.

### Existe um webhook que avise quando os créditos estão acabando?
Atualmente a Papo não envia alertas automáticos de crédito baixo. A recomendação é criar um controle externo que cruze os dados de consumo exportados e dispare notificações quando o uso se aproximar do limite.

### Quais endpoints da API realmente ajudam no monitoramento?
Os endpoints de administração de contas: listar todas as contas da revenda, verificar o estado dos módulos e, se necessário, ativar ou desativar módulos como o WhatsApp. Com eles você automatiza a identificação de quais clientes estão consumindo créditos.

### O cliente pode comprar créditos sozinho?
Sim. Você pode gerar um link de checkout de recarga de crédito no painel do revendedor e disponibilizá-lo ao cliente. Ele acessa o portal de faturamento com a sua marca, paga e os créditos são adicionados automaticamente. Saiba mais no artigo sobre recarga de créditos white label.

### Preciso de permissão especial para usar os endpoints de gestão?
Sim. Os endpoints exigem autenticação com privilégios de super administrador, disponíveis exclusivamente para o revendedor white label.

## Leia também

- [Como gerar relatórios de uso para clientes da revenda white label](/hc/papo/articles/gerar-relatorios-uso-clientes-revenda-white-label)
- [Como permitir que clientes white label comprem créditos de WhatsApp no portal de faturamento](/hc/papo/articles/permitir-clientes-white-label-comprar-creditos-whatsapp-portal-faturamento)

---

**[Comece a revender com a sua marca →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=api-papo-monitorar-consumo-creditos-faturas-revenda&utm_content=pt_BR)**

Com a revenda white label da Papo você oferece IA, CRM e WhatsApp com o seu nome, logo, cores e domínio — e constrói uma carteira de clientes que gera receita recorrente todo mês.