API do WhatsApp — Envie Mensagens de Forma Programática

Uma API completa do WhatsApp para enviar texto, mídia e gerenciar conversas por meio de uma interface REST simples. Sem Puppeteer, sem navegador headless — WebSocket puro.

curl -X POST https://api2whats.com/send-text \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"to": "971501234567", "message": "Hello from the API!"}'

O Que É uma API do WhatsApp?

Uma API do WhatsApp permite que você envie e receba mensagens do WhatsApp a partir do seu próprio software. Em vez de abrir o aplicativo do WhatsApp no telefone e digitar mensagens manualmente, seu código faz requisições HTTP para um endpoint da API. A API cuida da conexão com os servidores do WhatsApp, da entrega de mensagens, do acompanhamento de status e do encaminhamento de mensagens recebidas.

Isso é útil para qualquer negócio que precise se comunicar com clientes em escala. Confirmações de pedidos, atualizações de envio, lembretes de consultas, respostas de suporte ao cliente, campanhas de marketing — tudo isso pode ser automatizado por meio de uma API do WhatsApp. As mensagens aparecem no mesmo chat do WhatsApp que os clientes já usam, o que significa que eles realmente as leem. As taxas de abertura de mensagens do WhatsApp normalmente superam 90%, em comparação com 20% para e-mail.

O conceito é direto: sua aplicação envia uma requisição HTTP ao servidor da API, o servidor da API entrega a mensagem ao destinatário via WhatsApp e você recebe uma resposta confirmando a entrega. Para mensagens recebidas, a API as encaminha para sua URL de webhook em tempo real, para que seu sistema possa processá-las imediatamente.

Como Nossa API do WhatsApp Funciona

Nossa API é construída sobre o protocolo WhatsApp Web usando conexões WebSocket diretas. Isso é fundamentalmente diferente de soluções que usam Puppeteer ou navegadores headless para automatizar uma interface web. WebSocket direto significa menor latência, menor uso de recursos e confiabilidade significativamente melhor.

Cada instância que você cria mantém uma conexão WebSocket autenticada com os servidores do WhatsApp. Quando você envia uma mensagem pela API, ela vai diretamente por essa conexão WebSocket. Não há sobrecarga de renderização de navegador, nem análise de capturas de tela, nem manipulação frágil de DOM. A conexão é persistente e lida com reconexão automaticamente.

Também operamos um pool distribuído de proxies SOCKS5 em várias regiões. Isso serve a dois propósitos: garante conectividade confiável independentemente de onde seus servidores estão localizados e distribui as conexões por vários endereços IP para evitar limites de taxa. Cada instância se conecta por um proxy diferente, então, mesmo que você esteja rodando dez instâncias simultaneamente, cada uma tem seu próprio caminho de conexão limpo.

O Que Você Pode Fazer com a API

Enviar Mensagens de Texto

O caso de uso mais básico: enviar uma mensagem de texto para qualquer número do WhatsApp. As mensagens suportam Unicode, então você pode enviar texto em qualquer idioma, incluindo árabe, hindi, chinês e emoji. Cada mensagem é entregue individualmente com acompanhamento completo do status de entrega.

Enviar Mídia

Vá além do texto. Envie imagens, vídeos, documentos, arquivos de áudio e figurinhas. A mídia pode ser fornecida como URL (a API busca e entrega) ou como dados codificados em Base64 para envio inline. Os documentos podem ser PDFs, arquivos do Word, planilhas — qualquer tipo de arquivo suportado pelo WhatsApp.

Receber Mensagens via Webhooks

Quando alguém envia uma mensagem para o seu número conectado, a API a encaminha para sua URL de webhook como uma requisição POST. Você recebe o número do remetente, o conteúdo da mensagem, quaisquer anexos de mídia e as informações de timestamp. Seu manipulador de webhook processa a mensagem e pode disparar qualquer resposta ou fluxo de trabalho automatizado.

Gerenciar Vários Números

Cada plano suporta várias instâncias, o que significa que você pode conectar vários números do WhatsApp e gerenciá-los todos em um único painel. Alterne entre números via API especificando o ID da instância na sua requisição. Isso é útil para empresas que operam em várias regiões ou marcas.

Acompanhar o Status da Mensagem

Cada mensagem que você envia recebe um ID único. Você pode consultar o status de qualquer mensagem — se está pendente, enviada, entregue ou lida. Os webhooks também enviam atualizações de status em tempo real, para que seu sistema saiba o momento em que uma mensagem é entregue ou lida, sem polling.

Endpoints da API

A API segue um design REST limpo. Todos os endpoints aceitam e retornam JSON. Estes são os principais endpoints:

• POST /send-text — Enviar uma mensagem de texto
• POST /send-image — Enviar uma imagem
• POST /send-video — Enviar um vídeo
• POST /send-document — Enviar um documento ou arquivo
• POST /send-audio — Enviar um arquivo de áudio
• POST /send-location — Enviar um pin de localização
• GET /message-status/{id} — Verificar o status de entrega
• POST /set-webhook — Configurar sua URL de webhook
• GET /instance/status — Verificar o status da conexão

Cada endpoint exige uma chave de API enviada no cabeçalho Authorization. Os limites de taxa são aplicados por plano, e a API retorna mensagens de erro claras com códigos de status HTTP quando algo dá errado.

Métodos de Conexão

Conectar um número de telefone à API é simples. Suportamos dois métodos:

Conexão por QR Code

Escaneie um QR code do seu painel usando o aplicativo do WhatsApp no seu telefone. Este é o método mais rápido — leva cerca de 10 segundos. O QR code é atualizado automaticamente se você não o escanear a tempo. Uma vez escaneado, a conexão é estabelecida e a instância permanece online até você desconectá-la.

Conexão por Código de Pareamento

Digite um código de pareamento numérico no seu telefone em vez de escanear um QR code. Isso é útil quando você não consegue escanear um QR code — por exemplo, ao conectar um número em um servidor remoto. O código de pareamento é gerado pela API e expira após alguns minutos.

Linguagens de Programação Suportadas

A API é independente de linguagem. Qualquer linguagem capaz de fazer requisições HTTP pode usá-la. Oferecemos exemplos de código prontos para:

• PHP — Usar cURL ou Guzzle
• Python — Usar a biblioteca requests
• JavaScript — Usar fetch ou axios (Node.js e navegador)
• cURL — Uso direto pela linha de comando
• Go — Usar net/http
• Java — Usar HttpURLConnection ou OkHttp

Se sua linguagem consegue enviar uma requisição HTTP POST com corpo JSON, você pode usar esta API. Nenhuma instalação de SDK é necessária.

Fluxo de Entrega de Mensagens

Entender como as mensagens fluem pelo sistema ajuda você a construir integrações melhores. Quando você envia uma mensagem, aqui está o que acontece passo a passo:

1. Sua aplicação envia uma requisição HTTP à API com sua chave de API e os dados da mensagem
2. A API valida sua requisição: verifica a chave de API, verifica o formato do número de telefone e confirma que a instância está conectada
3. A mensagem é enfileirada para entrega pela conexão WebSocket da instância apropriada
4. A mensagem é transmitida aos servidores do WhatsApp pela conexão WebSocket persistente
5. O WhatsApp entrega a mensagem no telefone do destinatário
6. A API recebe uma confirmação de entrega do WhatsApp e atualiza o status da mensagem
7. Se um webhook estiver configurado, a atualização de status é encaminhada para o seu servidor

Todo o fluxo, da sua requisição à confirmação de entrega, normalmente leva de 1 a 3 segundos. As atualizações de status (entregue, lida) podem levar mais tempo, dependendo da conexão do destinatário e de quando ele abre a mensagem.

Gerenciamento de Instâncias

Cada número do WhatsApp que você conecta é chamado de "instância". Você pode gerenciar várias instâncias a partir de um único painel e alternar entre elas via API especificando o ID da instância. Cada instância tem:

• API key — Token de autenticação único
• Connection status — Conectada, desconectada ou reconectando
• Phone number — O número do WhatsApp associado à instância
• Webhook URL — Para onde as mensagens recebidas são encaminhadas
• Message history — Registro das mensagens enviadas e recebidas

As instâncias podem ser criadas, desconectadas e excluídas pelo painel ou via API. Ao desconectar uma instância, a sessão do WhatsApp é encerrada, mas você pode reconectar a qualquer momento sem perder seus dados.

Confiabilidade e Uptime

Mantemos um SLA de uptime de 99,9% em todos os planos. Nossa infraestrutura é construída para confiabilidade:

• Automatic reconnection — Se uma conexão WebSocket cair, a API se reconecta automaticamente em segundos
• Proxy failover — Se um servidor proxy tiver problemas, o tráfego é roteado por outro do pool
• Message queuing — Se a conexão do WhatsApp estiver temporariamente indisponível, as mensagens são enfileiradas e entregues quando a conexão for restabelecida
• Health monitoring — Monitoramos todas as instâncias 24/7 e tratamos os problemas proativamente antes que afetem a entrega

A API retorna um erro 503 Service Unavailable somente quando todos os caminhos de conexão estão esgotados, o que é extremamente raro. Na prática, suas mensagens serão entregues mesmo que componentes individuais sofram interrupções breves.

Segurança e Privacidade

Toda a comunicação com a API é criptografada por HTTPS. As chaves de API são armazenadas com segurança usando hash bcrypt — nunca as armazenamos em texto simples. Suas URLs de webhook são validadas e todos os payloads de webhook são assinados, para que você possa verificar se realmente vieram dos nossos servidores.

Não temos acesso ao conteúdo das suas mensagens, a menos que você as encaminhe explicitamente via webhooks. As mensagens entre você e seus clientes permanecem privadas. A conexão do WhatsApp usa criptografia de ponta a ponta para a camada de transporte das mensagens.

Preços

Os planos começam em US$ 9,99 por mês e incluem um número definido de requisições à API por dia, instâncias e recursos. Não há taxas ocultas, nem cobranças por mensagem, nem surpresas de excedente. Você pode fazer upgrade ou downgrade a qualquer momento pelo painel.

Aceitamos criptomoedas e cartões de crédito. O processamento de pagamentos é feito por gateways seguros, e suas informações de pagamento nunca são armazenadas em nossos servidores.

Casos de Uso

Nossa API do WhatsApp é usada em uma ampla variedade de setores e aplicações. Estes são alguns dos casos de uso mais comuns que nossos clientes constroem:

• E-commerce — Confirmações de pedidos, atualizações de envio, notificações de entrega, atualizações de status de devolução e lembretes de carrinho abandonado
• Healthcare — Lembretes de consultas, notificações de renovação de receitas, entrega de resultados de exames e acompanhamento de pacientes
• Education — Confirmações de matrícula em cursos, prazos de tarefas, resultados de provas e comunicação entre pais e professores
• Real Estate — Alertas de anúncios de imóveis, confirmações de visitas, notificações de propostas e comunicação com inquilinos
• Financial Services — Alertas de transações, entrega de faturas, lembretes de pagamento e notificações de conta
• Restaurants — Confirmações de pedidos, lembretes de reserva de mesa, coleta de feedback e ofertas promocionais
• Logistics — Atualizações de rastreamento de remessas, confirmações de entrega, atribuições de motoristas e notificações de armazém

Qualquer negócio que se comunica com clientes via WhatsApp pode se beneficiar da automação dessas conversas pela API. A chave é identificar quais mensagens são repetitivas e previsíveis — essas são as que devem ser automatizadas.

Começando

1. Crie uma conta gratuita — leva 30 segundos
2. Escolha um plano que atenda às suas necessidades
3. Crie uma instância no seu painel
4. Conecte seu número de telefone via QR code ou código de pareamento
5. Use sua chave de API para enviar sua primeira mensagem

Se precisar de ajuda para começar, consulte nossa documentação da API ou entre em contato com nossa equipe de suporte.