Seu próprio número +55
Conecte o número de WhatsApp que seus clientes já têm salvo, como dispositivo conectado. Ele continua funcionando no celular.
API do WhatsApp para empresas no Brasil
API do WhatsApp para empresas no Brasil: envie do seu próprio número +55 sem taxa por mensagem, receba respostas por webhook, agende no horário de Brasília e teste grátis.
Sandbox grátis, sem cartão. Conecte um número brasileiro e envie a primeira mensagem em cerca de 10 minutos. A documentação e o painel estão em inglês.
Preço fixo, sem taxa por mensagem
A Meta cobra US$ 0,0625 por mensagem de marketing no Brasil. O ChatRail Core custa US$ 15 por mês, com envios ilimitados.
No horário de Brasília
Agendamentos recorrentes usam o fuso que você escolher. Um lembrete das 9h sai às 9h em São Paulo, Manaus ou Rio Branco.
API oficial do WhatsApp ou API não oficial: qual a diferença?
Quando alguém procura "API do WhatsApp", pode estar falando de dois produtos bem diferentes.
- API oficial é a WhatsApp Business Platform da Meta, contratada diretamente ou por um parceiro oficial (BSP). Toda conversa iniciada pela empresa precisa de um modelo de mensagem aprovado pela Meta, e cada mensagem entregue é cobrada.
- API não oficial conecta um número comum de WhatsApp como dispositivo conectado, do mesmo jeito que o WhatsApp Web, e deixa o seu sistema enviar por ele. Não há modelos para aprovar nem taxa por mensagem.
O ChatRail é do segundo tipo, feito para desenvolvedores: API REST, webhooks assinados, status de entrega, agendamentos e respostas com IA opcionais. Não é afiliado à Meta nem ao WhatsApp.
A API oficial é a escolha certa se você precisa do selo verde, de códigos de verificação em grande volume, de marketing para listas grandes com opt-in, ou de uma integração oficial para passar numa auditoria. A comparação completa está em Official API vs Linked Devices (em inglês).
Quanto custa a API oficial do WhatsApp no Brasil
A Meta cobra por mensagem entregue, conforme a categoria. Os valores para o Brasil na tabela em vigor desde 1º de outubro de 2026, em dólar americano:
| Categoria | Preço de lista da Meta | 10.000 por mês |
|---|---|---|
| Marketing (ofertas, promoções) | US$ 0,0625 | US$ 625 |
| Utilidade (status de pedido, lembretes) | US$ 0,0068 | US$ 68 |
| Autenticação (códigos de verificação) | US$ 0,0068 | US$ 68 |
| Serviço (respostas acima de 1.000 por mês) | US$ 0,0068 | US$ 68 |
No Brasil, uma mensagem de marketing custa mais de nove vezes uma de utilidade, então a categoria em que a Meta classifica cada modelo pesa muito na conta. O seu parceiro oficial pode cobrar uma taxa própria por cima.
O ChatRail Core custa US$ 15 por mês por número, com envios ilimitados. Isso empata com a taxa da Meta em cerca de 2.200 mensagens de utilidade por mês, ou 240 de marketing. Acima disso, o preço fixo sai mais barato, e as respostas estão incluídas. A lógica completa está no nosso guia de preços da API do WhatsApp (em inglês).
Envie uma mensagem pela API do WhatsApp
Uma requisição HTTP com a sua chave de API. O texto é livre, então português, emojis e quebras de linha funcionam normalmente.
curl -X POST https://www.chatrail.dev/v1/messages/text \
-H "Authorization: Bearer $CHATRAIL_API_KEY" \
-H "Idempotency-Key: pedido-4821-saiu-para-entrega" \
-H "Content-Type: application/json" \
-d '{"connection":"loja-sp","to":"+5511XXXXXXXXX",
"body":"Seu pedido 4821 saiu para entrega e chega hoje até as 18h.",
"context":{"order_id":"4821","status":"out_for_delivery"}}'A resposta é 202 Accepted: a mensagem foi gravada e entrou na fila, e a entrega chega depois pelo webhook. Envie um Idempotency-Key em toda requisição, assim uma nova tentativa nunca manda a mesma atualização duas vezes. Também dá para anexar imagem, boleto em PDF ou localização, e conferir antes se um número tem WhatsApp com GET /v1/numbers/check.
Agende mensagens no horário de Brasília
O Brasil tem quatro fusos horários. POST /v1/schedules recebe um fuso, então use o dos seus clientes:
| Horário | Fuso para enviar |
|---|---|
| Brasília, UTC−3: a maior parte do país | America/Sao_Paulo |
| Amazonas, UTC−4: Manaus | America/Manaus |
| Acre, UTC−5: Rio Branco | America/Rio_Branco |
| Fernando de Noronha, UTC−2 | America/Noronha |
O Brasil não adota horário de verão desde 2019. Mesmo assim, cada envio recorrente é calculado no horário local do fuso escolhido, inclusive em dias de mudança de horário, então um lembrete das 9h continua saindo às 9h.
A recorrência pode ser diária, semanal em dias escolhidos, ou mensal num dia do mês, com -1 para o último dia, o que serve bem para lembretes de boleto e de parcela. Dá para pausar, retomar e cancelar pela API. Uma mensagem avulsa usa send_at. O corpo completo está na referência da API (em inglês).
Respostas e status de entrega por webhook
Cadastre um endpoint HTTPS com POST /v1/webhook-endpoints e o ChatRail envia eventos assinados para ele, cada um com o cabeçalho chatrail-signature, que você verifica antes de confiar no evento.
message.receivedpara toda mensagem recebida, inclusive fotos, áudios e documentos.message.sent,message.delivered,message.reademessage.failedconforme cada mensagem avança.message.reply_correlatedquando uma resposta é ligada ao alerta que ela responde, com o contexto desse alerta junto.connection.disconnectedeconnection.requires_repairquando o dispositivo conectado precisa de atenção.
As respostas com IA são opcionais e vêm desligadas. Quando ligadas, respondem usando só o contexto anexado ao alerta, e podem sair na hora ou ficar como rascunho para você aprovar. Respostas com contexto (em inglês).
LGPD, consentimento e opt-out
Pela LGPD, a sua empresa continua responsável pelo consentimento e pela base legal de cada envio. O ChatRail ajuda em duas frentes:
- Uma lista de opt-out, com
POST /v1/opt-outs, que bloqueia envios para quem pediu para não receber mais mensagens. - Contexto marcado como restrito nunca é enviado a um modelo de IA e não aparece nos webhooks.
Isso não substitui a sua política de privacidade nem o seu registro de consentimento. Guarde os dois no seu sistema.
Existe API do WhatsApp grátis?
Para testar, sim. O Sandbox do ChatRail é grátis e não pede cartão: um número conectado, 500 mensagens por mês, a API básica e os webhooks. Conecte um número lendo um QR code ou digitando um código de pareamento no celular, mande uma mensagem para você mesmo e veja os eventos chegando.
Em produção, os planos pagos começam em US$ 15 por mês por número, com envios ilimitados. O Evolution API, a API de WhatsApp de código aberto mais popular, é grátis como software, mas você hospeda e mantém o servidor. A comparação lado a lado está em inglês.
Antes de construir em cima disso
Uma API não oficial não é a plataforma oficial da Meta, e isso traz consequências para planejar:
- A sessão pode cair e precisar ser pareada de novo. O ChatRail avisa por webhook e segura as mensagens na fila, mas alguém precisa refazer o pareamento.
- As regras do WhatsApp contra mensagens indesejadas valem no Brasil como em qualquer lugar. Números são restringidos por disparo em massa para quem não pediu. O ChatRail recusa mais de 10 mensagens para a mesma pessoa em 5 minutos e mantém a lista de opt-out, mas nada torna seguro disparar para lista comprada.
- Não há selo verde. O número é uma conta comum de WhatsApp.
Envie o que o cliente espera receber, num ritmo estável, e tenha um plano para refazer o pareamento. Banimento ou sessão expirada? (em inglês).
Perguntas frequentes
Funciona com número brasileiro (+55)?
Sim. Qualquer número com WhatsApp pode ser conectado como dispositivo, de qualquer operadora, como Vivo, Claro ou TIM. O número continua funcionando no celular.
O ChatRail é a API oficial do WhatsApp?
Não. O ChatRail usa uma sessão de dispositivo conectado, então não há cadastro na Meta, aprovação de modelos nem taxa por mensagem. Também não há selo verde.
Preciso de CNPJ para começar?
O ChatRail não pede CNPJ. O cadastro é feito com e-mail. As regras do WhatsApp sobre mensagens comerciais continuam valendo para o número.
Posso enviar para grupos?
Sim. Dá para listar os grupos do número, criar e gerenciar grupos, e enviar para um grupo pelo nome.
Quanto custa?
O Sandbox é grátis, com 500 mensagens por mês. O Core custa US$ 15 por mês por número, com mensagens ilimitadas. O Core + AI custa US$ 29 e inclui 10 mil respostas com IA por mês. Os preços são em dólar americano.
A documentação está em português?
Ainda não. A documentação, a referência da API e o painel estão em inglês. Esta página resume o que importa para quem está no Brasil.
FAÇA UM TESTE CONTROLADO
Comece com um número e um fluxo real.
Valide a conexão, o status de entrega e o caminho das respostas antes de aumentar o volume.
Começar grátis