Os créditos de mensagem custeiam o envio via WhatsApp Cloud API. Use este endpoint para verificar o saldo disponível antes de realizar disparos.
Endpoint
GET /v1/message-credits/wallet
Escopo necessário: read:message_credits
Exemplo de requisição
curl "https://api.socialsell.ai/v1/message-credits/wallet" \
-H "Authorization: Bearer sk_live_..."
Exemplo de resposta
{
"data": {
"balance_cents": 50000,
"reserved_cents": 1200,
"available_cents": 48800,
"currency": "BRL",
"auto_topup": {
"enabled": true,
"thresholdCents": 10000,
"amountCents": 50000
},
"status": "active"
}
}
Campos da resposta
| Campo | Tipo | Descrição |
|---|
balance_cents | integer | Saldo total em centavos |
reserved_cents | integer | Valor reservado para envios em andamento |
available_cents | integer | Saldo disponível (balance - reserved) |
currency | string | Moeda (BRL) |
auto_topup | object | Configuração de recarga automática |
status | string | Status da carteira (active, suspended) |
Sempre use available_cents para verificar se há saldo suficiente — balance_cents pode incluir valores já comprometidos com disparos em andamento.