Seu sistema no WhatsApp, com uma chamada HTTP.

Você cria uma instância, lê o QR code com o número da sua empresa e passa a enviar e receber mensagens por REST e webhooks. Sem aprovação da Meta, sem templates, sem chip novo.

Criar conta grátis Ver a documentação

2 dias grátis por instância. Sem cartão.

130: endpoints REST, todos em snake_case
6: webhooks, assinados com HMAC
1 fila: por instância, com reenvio quando o número reconecta
2 dias: grátis por instância, sem cartão

Feito para quem coloca o WhatsApp dentro de outro software.

Desenvolvedores e integradores

Uma API REST previsível, com documentação que você lê em cinco minutos e testa direto do navegador.

Software houses e agências

Uma instância por cliente, cada uma com o próprio token e os próprios webhooks. A cobrança é por instância, sem surpresa no fim do mês.

SaaS, ERP e CRM

Notificações, atendimento e vendas saindo da tela do seu produto, no número que o cliente já usa.

Times de atendimento e vendas

Conecte o número atual ao chatbot, ao CRM ou ao n8n. Sem trocar de chip, sem esperar aprovação.

Três passos até a primeira mensagem.

1

Crie uma instância

No painel ou pela API. Cada instância é um número de WhatsApp com token próprio.
2

Leia o QR code

No celular da empresa, abra Dispositivos conectados e aponte a câmera. Se preferir, use o código de pareamento pelo número.
3

Chame a API

Envie texto, mídia, botões e enquetes. Tudo que chega no número cai no seu webhook.

cURL Node.js Python PHP

curl -X POST https://api.wabox.me/instances/{instance_id}/token/{token}/send-text \
  -H "Content-Type: application/json" \
  -H "Client-Token: {client_token}" \
  -d '{"phone": "5511999990000", "message": "Oi, Marina! Seu pedido #4821 saiu para entrega."}'

const res = await fetch("https://api.wabox.me/instances/{instance_id}/token/{token}/send-text", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Client-Token": process.env.WABOX_CLIENT_TOKEN },
  body: JSON.stringify({ phone: "5511999990000", message: "Oi, Marina! Seu pedido #4821 saiu para entrega." }),
});
const { message_id } = await res.json();

import requests

res = requests.post(
    "https://api.wabox.me/instances/{instance_id}/token/{token}/send-text",
    headers={"Client-Token": CLIENT_TOKEN},
    json={"phone": "5511999990000", "message": "Oi, Marina! Seu pedido #4821 saiu para entrega."},
)
message_id = res.json()["message_id"]

$res = Http::withHeaders(['Client-Token' => env('WABOX_CLIENT_TOKEN')])
    ->post('https://api.wabox.me/instances/{instance_id}/token/{token}/send-text', [
        'phone' => '5511999990000',
        'message' => 'Oi, Marina! Seu pedido #4821 saiu para entrega.',
    ]);
$messageId = $res->json('message_id');

Resposta 200

{
  "id": "3EB0A9C6D2F1E4B5A7C8",
  "message_id": "3EB0A9C6D2F1E4B5A7C8",
  "wabox_id": "wbx_01J5Q8ZK3M4N5P6Q7R8S9T0M01",
  "status": "queued"
}

O que o WhatsApp faz no celular, a API faz no seu código.

A lista abaixo é o que já está no ar. O que é best effort está marcado como best effort.

Mensagens

Texto, com menções e resposta citada
Imagem, vídeo, áudio, voz (PTT), documento, sticker e GIF
Localização, contato e link com pré-visualização
Editar, apagar, fixar, encaminhar e reagir

Interativos

Botões de resposta, link, ligação e copiar
Lista de opções e carrossel
Botão PIX e botão OTP
Enquetes e votos

Renderizam no celular. O WhatsApp Web não exibe mensagens interativas de nenhuma API não oficial.

Conversas

Lista de chats com busca e paginação
Arquivar, fixar, silenciar, marcar como lido
Etiquetas e notas (Business)
Presença: digitando, gravando, online

Contatos e perfil

Existe no WhatsApp? Um número ou um lote
Foto, nome e recado do perfil
Bloquear e desbloquear
Privacidade: visto por último, foto, grupos, recibos

Grupos, comunidades e canais

Criar, editar, foto, descrição e configurações
Participantes: adicionar, remover, promover, aprovar
Comunidades com grupos vinculados
Canais: criar, seguir, publicar e reagir

Business best effort

Perfil comercial, horários e categorias
Catálogo: produtos, coleções e imagens
Pedidos: receber, consultar e atualizar status
Enviar produto e link do catálogo

Eventos e status

Eventos em grupo com RSVP
Status de texto, imagem e vídeo
Leitura automática de status

Operação

Fila por instância que espera o número reconectar
Limite de requisições por instância
Webhooks com assinatura HMAC e reenvio
Aba Testes: 34 verificações no seu próprio número

Tudo que acontece no número chega no seu servidor.

Seis eventos, um formato. Cada entrega vem assinada com HMAC e é reenviada até cinco vezes em 24 horas se o seu servidor não responder.

received Mensagem recebida, de qualquer tipo, já normalizada
delivery Resultado do envio: saiu ou falhou, e por quê
message_status Entregue, lida, tocada
connected O número conectou
disconnected O número desconectou, e o motivo
chat_presence Alguém está digitando ou gravando

POST https://seu-servidor.com/webhook X-Wabox-Signature: t=1786968300,v1=…

{
  "type": "received",
  "event_id": "01J5Q8ZK3M4N5P6Q7R8S9T0V1X",
  "instance_id": "8f2a3c1e-6b7d-4e5f-9a0b-1c2d3e4f5a6b",
  "momment": 1786968300000,
  "message_id": "3EB0A9C6D2F1E4B5A7C8",
  "phone": "5511988887777",
  "from_me": false,
  "is_group": false,
  "chat_name": "Maria",
  "sender_name": "Maria",
  "text": { "message": "Olá! Tudo bem?" }
}

O que dá para construir

Vendas

Recuperar carrinho abandonado
Enviar catálogo e receber o pedido
Confirmar orçamento com um botão
Avisar reposição de estoque

Atendimento

Chatbot com transbordo para humano
Fila de atendimento por etiqueta
Pesquisa de satisfação pós-atendimento
Respostas automáticas fora do horário

Operações

Confirmação e rastreio de pedido
Lembrete de consulta e agendamento
Cobrança com botão PIX
Alertas de sistema para o time

Produto

Notificações do seu SaaS no WhatsApp
Login com código por WhatsApp (OTP)
Grupos de clientes criados pela API
Canal de novidades

Funciona com o que faz HTTP.

Não existe SDK para instalar. Qualquer ferramenta que chame uma URL e receba um webhook já está integrada.

Como conectar cada uma

n8n
Make
Zapier
Typebot
Chatwoot
HubSpot
RD Station
Pipedrive
Dify
Langflow
Bubble
Google Sheets
Supabase
Retool
Postman
Node.js
Python
PHP
Go
Java
.NET
Ruby
Laravel
Django

Wabox, API oficial ou biblioteca própria?

Cada opção tem um lugar. Esta é a comparação honesta.

	Wabox	API oficial (Cloud API)	Biblioteca própria
Aprovação da Meta	Não precisa	Sim, com verificação da empresa	Não precisa
Iniciar conversa	Qualquer mensagem	Só com template aprovado	Qualquer mensagem
Custo	Por instância, ilimitado	Por conversa	Sua infraestrutura e seu tempo
Número	O que a empresa já usa	Novo ou migrado, sem o app	O que a empresa já usa
Primeira mensagem	Minutos	Dias	Dias
Quando o WhatsApp muda	Nós atualizamos	A Meta atualiza	Você atualiza
Risco de bloqueio	Existe; boas práticas reduzem	Baixo	Existe

Gerencia WhatsApp para vários clientes?

O programa Partner é para software houses, agências e plataformas com dez ou mais instâncias.

Falar sobre o programa Partner

Preço por volume

A partir de R$ 49,90 por instância, caindo conforme o número de instâncias.

Um painel, todos os clientes

Instâncias no mesmo workspace, com papéis por membro da equipe.

Suporte prioritário

Canal direto com quem opera a plataforma.

Instâncias pela API

Crie e cancele instâncias do seu próprio backend. Em breve.

Um preço por instância. Mensagens ilimitadas.

Cada instância é um número de WhatsApp. Teste 2 dias sem cartão; assine quando quiser continuar.

BRL USD

Pro

Para quem conecta um ou alguns números.

R$ 79,90 US$ 14,90 por instância / mês

Começar com 2 dias grátis

Mensagens e mídia ilimitadas
Todos os 130 endpoints
Webhooks assinados com reenvio
Fila que espera o número reconectar
Aba Testes com 34 verificações
Suporte em português

Partner

Para quem opera dez ou mais instâncias.

a partir de R$ 49,90 US$ 10 por instância / mês

Falar com a gente

Tudo do Pro
Preço cai com o volume
Todas as instâncias em um workspace
Suporte prioritário
Instâncias pela API (em breve)

Perguntas que sempre chegam

Qual a diferença para a API oficial do WhatsApp?

A API oficial (Cloud API) é o produto da Meta: exige verificação da empresa, cobra por conversa e só deixa você iniciar conversas com templates aprovados. O Wabox conecta o número como um WhatsApp Web (um dispositivo vinculado) e expõe tudo que o app faz via REST. Você usa o número que já tem, paga por instância e manda qualquer mensagem.

Preciso de um chip ou número novo?

Não. Você lê o QR code com o WhatsApp que a empresa já usa, igual a conectar o WhatsApp Web. O celular continua funcionando normalmente.

Meu número pode ser bloqueado?

Pode, como em qualquer uso fora do app oficial. O risco vem de comportamento: disparo em massa para quem não pediu, muitas denúncias, número recém-criado mandando muito. A documentação tem um guia de boas práticas e a API espaça os envios por padrão.

Quanto tempo leva para integrar?

Criar a instância e ler o QR leva um minuto. A primeira mensagem via curl sai logo depois. Uma integração completa com webhook costuma ficar pronta no mesmo dia.

Funciona com n8n, Make, Zapier e chatbots?

Sim. Qualquer ferramenta que faça requisições HTTP e receba webhooks funciona sem plugin. Temos guias para as mais usadas.

O que acontece se a instância desconectar?

As mensagens que você enviar ficam na fila e saem quando o número reconecta. Você recebe o webhook disconnected com o motivo e o painel mostra um QR novo se precisar reconectar.

Vocês guardam as minhas mensagens?

Não. O conteúdo passa pela fila de saída e some depois do envio. Guardamos só contadores e o histórico de entregas de webhook, sem conteúdo. A mídia recebida fica em um link temporário que expira.

Como funciona o teste grátis?

Cada instância nova tem 2 dias grátis, sem cartão. Quando acaba, a API responde 402 até você assinar. Nada é cobrado sem você assinar.

Botões e listas aparecem para todo mundo?

No celular, sim, em Android e iOS. O WhatsApp Web e o Desktop não exibem mensagens interativas enviadas por nenhuma API não oficial; nesses casos mostram um aviso de mensagem não suportada. Se isso importa para o seu caso, prefira texto com opções numeradas.

Crie a sua primeira instância agora.

Dois dias grátis, sem cartão. O QR code aparece em segundos.

Criar conta grátis Ler a documentação