---
title: "The Seller API: API pública de custos do WhatsApp"
description: "API pública e gratuita da The Seller para simular o custo de mensagens na API oficial do WhatsApp no Brasil, com especificação OpenAPI, exemplos e formato de erros."
url: https://www.theseller.com.br/developers
lang: pt-BR
---

DESENVOLVEDORES

# The Seller API

API pública, gratuita e sem autenticação para simular quanto custa enviar mensagens pela API oficial do WhatsApp no Brasil. Usa a mesma tabela da nossa calculadora: tarifa da Meta por categoria, faixas de volume e a tarifa da The Seller por mensagem.

[Especificação OpenAPI 3.1](https://www.theseller.com.br/openapi.json) [llms.txt para agentes de IA](https://www.theseller.com.br/llms.txt)

## 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"
  }
}
```

## API da plataforma

A API para integrar seus sistemas à plataforma The Seller faz parte do plano Prime. Para acesso e documentação, fale com o nosso time.
[Falar com o time](https://www.theseller.com.br/contato)

Operação comercial no WhatsApp. API oficial, agentes de IA e automações trabalhando juntos para sua empresa vender todos os dias.

### Produto

- [Funcionalidades](https://www.theseller.com.br/funcionalidades)
- [Preços](https://www.theseller.com.br/precos)
- [Calculadora](https://www.theseller.com.br/calculadora)
- [Integrações](https://www.theseller.com.br/integracoes)
- [Segmentos](https://www.theseller.com.br/segmentos)
- [API para desenvolvedores](https://www.theseller.com.br/developers)

### Empresa

- [Sobre](https://www.theseller.com.br/sobre)
- [Contato](https://www.theseller.com.br/contato)
- [Cases](https://www.theseller.com.br/cases)
- [Política de Privacidade](https://www.theseller.com.br/politica-de-privacidade)
- [Termos de Uso](https://www.theseller.com.br/termos-de-uso)

### Contato

- [(34) 8440-0300](tel:+553484400300)
- [contato@theseller.com.br](mailto:contato@theseller.com.br)
- Uberlândia, MG, Brasil

© 2026 The Seller. Todos os direitos reservados. · THE SELLER LTDA · CNPJ 61.664.493/0001-59

Meta Business Partner · API oficial do WhatsApp