Endpoints
URL base: https://www.theseller.com.br
Autenticación: ninguna. Respuestas en JSON, con CORS habilitado.
Simular costo de mensajes
GET /api/v1/whatsapp-pricing/simulate
Calcula el costo de Meta (con tramos de volumen), la tarifa de The Seller y el costo total y medio por mensaje, en reales.
Parámetros
quantity: obligatorio. Número de mensajes (1 a 1.000.000.000).category: marketing (predeterminado), utility o authentication.currency: moneda de la cuenta Meta: BRL (predeterminado) o USD.exchangeRate: reales por dólar, usado cuando currency=USD. Predeterminado 5,4.
curl "https://www.theseller.com.br/api/v1/whatsapp-pricing/simulate?quantity=10000&category=marketing"
Tabla de tarifas
GET /api/v1/whatsapp-pricing/rates
Devuelve las tarifas de lista y los tramos de volumen de Meta para Brasil, la tarifa de The Seller y las fuentes oficiales.
curl "https://www.theseller.com.br/api/v1/whatsapp-pricing/rates"
Ejemplo de respuesta
{
"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."
]
}
Errores
Los errores siempre vuelven en JSON, con un código estable, un mensaje, una pista para corregir la solicitud y el enlace a esta documentación. Códigos: invalid_parameter y missing_parameter (400), not_found (404) y 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"
}
}
