Skip to main content

Cobranças

O envio pelo WhatsApp Oficial é pré-pago: cada mensagem cobrada sai do saldo da sua conta (Account). Nesta seção você acompanha esse saldo, quanto gastou por dia e cada lançamento.

O saldo da conta

O saldo é da conta. Todos os canais da conta usam o mesmo saldo (não existe saldo por canal), e todas as respostas trazem a conta (account) com dois valores: Esses dois nomes são os mesmos em todas as chamadas de Cobranças.

O canal de cada cobrança

O saldo é um só, mas cada cobrança, estorno e ajuste guarda o canal (channelId) da mensagem. Ele aparece em cada item dos lançamentos.

Como cada mensagem é cobrada

  • Cada mensagem enviada é cobrada pelo seu tipo (marketing, utilidade, autenticação, atendimento), no momento do envio.
  • Mensagens recebidas também podem ser cobradas e nunca são bloqueadas por falta de saldo. Nesse caso o saldo pode ficar negativo, e o próximo crédito cobre primeiro esse valor.
  • Quando a Meta não entrega a mensagem, o valor volta como estorno. Quando a Meta cobra outra categoria, a diferença vira um ajuste. Os dois aparecem nos lançamentos, e o consumo diário já mostra o valor final de cada mensagem.

Quando o envio é recusado

O envio é aceito (200 OK) e a cobrança acontece em seguida. Se ela não passar, você recebe um SEND_MESSAGE_RESPONSE com success: false no canal de feedback (veja Recebendo eventos):

Autenticação e escopo

Todas as chamadas de Cobranças usam a sua API Key no header API-KEY. A conta vem da chave: não é preciso enviar accountId.
Chaves acc_ veem só a própria Account. Chaves org_ informam a conta no parâmetro accountId; conta de outra Organization devolve 404.
Valores têm até 4 casas decimais (ex.: 0.3717 = R$ 0,3717). Para exibir em reais, arredonde só na tela.

Próximos passos

Saldo

Disponível e reservado da conta.

Consumo diário

Gasto por dia e por tipo de mensagem.

Lançamentos

Cada crédito, cobrança, estorno e ajuste, com o canal de cada mensagem.