Endpoints
URL base: https://www.theseller.com.br
Autenticação: nenhuma. Respostas em JSON, com CORS liberado.
Simular custo de mensagens
GET /api/v1/whatsapp-pricing/simulate
Calcula o custo da Meta (com faixas de volume), a tarifa da The Seller e o custo total e médio por mensagem, em reais.
Parâmetros
quantity: obrigatório. Número de mensagens (1 a 1.000.000.000).category: marketing (padrão), utility ou authentication.currency: moeda da conta Meta: BRL (padrão) ou USD.exchangeRate: reais por dólar, usado quando currency=USD. Padrão 5,4.
curl "https://www.theseller.com.br/api/v1/whatsapp-pricing/simulate?quantity=10000&category=marketing"
Tabela de tarifas
GET /api/v1/whatsapp-pricing/rates
Retorna as tarifas de lista e as faixas de volume da Meta para o Brasil, a tarifa da The Seller e as fontes oficiais.
curl "https://www.theseller.com.br/api/v1/whatsapp-pricing/rates"
Exemplo de resposta
{
"input": {
"quantity": 10000,
"category": "marketing",
"currency": "BRL",
"exchangeRate": 5.4,
"market": "brazil"
},
"meta": {
"currency": "BRL",
"cost": 3217,
"costBRL": 3217,
"effectiveRate": 0.3217,
"tiers": [
{
"quantity": 10000,
"rate": 0.3217,
"cost": 3217,
"from": 1,
"to": 10000
}
]
},
"theSeller": {
"ratePerMessageBRL": 0.1,
"costBRL": 1000
},
"totalCostBRL": 4217,
"averageCostPerMessageBRL": 0.4217,
"rateCardUpdatedAt": "setembro de 2026",
"notes": [
"Estimate only. Meta bills its fee directly in the account currency; the final amount depends on Meta's rate card on the billing date.",
"Service (user-initiated) conversations are not included."
]
}
Erros
Erros sempre voltam em JSON, com um código estável, uma mensagem, uma dica de como corrigir e o link desta documentação. Códigos: invalid_parameter e missing_parameter (400), not_found (404) e method_not_allowed (405).
{
"error": {
"code": "invalid_parameter",
"message": "category must be one of: marketing, utility, authentication.",
"hint": "Use the Meta template category of the message.",
"docs": "https://www.theseller.com.br/developers",
"parameter": "category"
}
}
