Criar conta

API para WhatsApp Web

O WhatsApp do seu número, ligado ao seu sistema por API.

Conecte pelo QR, como no computador. Cada instância sai por um IP fixo na cidade que você escolher, e cada mensagem volta como evento: enviada, entregue, lida. O Console mostra tudo em tempo real.

7 dias grátis com 1 instância + 1 proxy. Depois, R$ 50 por instância e R$ 50 por proxy, por mês.

Telas ilustrativas com dados de exemplo

  • Conexão pelo QR do WhatsApp Web
  • IP fixo por instância
  • Idempotency-Key em todo envio
  • Webhooks assinados (HMAC)
  • SSE e WebSocket
  • Simulador de webhooks
  • Pronta para Claude e Codex
  • Feita no Brasil

Integrar o WhatsApp costuma acabar em achismo.

A mensagem saiu? Chegou? A pessoa leu? A sessão caiu de madrugada? Sem eventos claros, a integração vira consulta em loop e planilha de suporte. Na Catcher cada passo do envio vira um evento com o mesmo message_id que a API devolveu no 202. O seu sistema decide com dado, e você confere tudo no Console.

Como funciona

Uma chamada na API. Cada passo volta como evento.

Aperte os botões das cenas. Cada um provoca o evento que a API real emite naquele momento.

1 · Conectar

Leia o QR Code e a instância está no ar.

Crie a instância no Console ou pela API e leia o QR com o celular, em Aparelhos conectados, como faria no computador. Quando a sessão fica pronta, o seu webhook recebe connection.update.

2 · Enviar e acompanhar

Do 202 ao “lida”, sem consultar em loop.

Todo envio leva Idempotency-Key e responde 202 com o message_id. A mensagem espera alguns segundos na fila, mostra “digitando…”, sai pelo IP do seu proxy e os recibos voltam como eventos para o webhook, para o SSE e para o painel de eventos do Console.

3 · Seu servidor caiu

O seu servidor caiu. Os eventos esperam por ele.

A Catcher entrega os eventos em ordem, assinados com HMAC, e retenta sozinha. Se o seu servidor ficou fora, ele pergunta o que perdeu com events/history?after= o último event_id processado. O histórico fica disponível por 7 dias.

4 · Comece com IA

Cole um prompt no Claude ou no Codex e a integração sai certa.

A documentação também existe em texto para agentes: docs.catcher.one/llms.txt, a skill da API e o roteiro docs.catcher.one/start.md. O card Comece com IA do Console traz o prompt pronto. O agente escreve a integração por webhook, confere a assinatura, ignora evento repetido e testa no simulador antes da conta real.

Telas ilustrativas com dados de exemplo

Proxy dedicado

Um IP fixo para cada número, na cidade que você escolher.

Você escolhe o proxy entre São Paulo, Rio de Janeiro e Curitiba, e tudo o que a instância manda e recebe passa por ele. O IP é só da sua empresa e aparece mascarado no Console. Um proxy pode atender várias instâncias suas.

Depois de conectada, a instância fica no mesmo IP enquanto a sessão existir. Para mudar de proxy, você desconecta e conecta de novo. Nada troca esse IP sozinho.

Console › Proxies › Adicionar proxy
  • São Paulo200.xxx.xxx.31R$ 50/mês
  • Rio de Janeiro201.xxx.xxx.77R$ 50/mês
  • Curitiba200.xxx.xxx.7R$ 50/mês

Telas ilustrativas com dados de exemplo

Para quem constrói

REST, JSON e um evento para cada coisa que acontece.

Texto, imagem, vídeo, áudio de voz, documento, localização, contato, reação, edição e exclusão seguem o mesmo padrão de envio. São mais de 100 tipos de evento, no formato tipo.ação: text.sent, image.read, connection.update.

Os eventos chegam por webhook, SSE ou WebSocket. O SSE retoma do último cursor quando a conexão volta.

Ver documentação
terminal
curl -X POST https://api.catcher.one/v1/instances/$INSTANCIA/messages/text \
  -H "X-API-Key: $CATCHER_API_KEY" \
  -H "Idempotency-Key: pedido-4821" \
  -d '{"to":"5541999990000","text":"Seu pedido saiu para entrega"}'

# 202 Accepted
{ "status": "queued",
  "message_id": "550e8400-e29b-41d4-a716-446655440000" }

# depois, no seu webhook
{ "type": "text.read",
  "data": { "message_ids": ["550e8400-…"] } }

Uma conversa pela API, do envio ao “lida”.

Gravação das telas ilustrativas desta página

Preço

Você paga por número conectado e por IP. Mais nada.

Instância WhatsApp Web

R$ 50/mês

por instância. Um número conectado, com mensagens e eventos sem cobrança por mensagem.

Proxy dedicado

R$ 50/mês

por proxy. Um IP fixo em São Paulo, Rio de Janeiro ou Curitiba, que atende quantas instâncias suas você quiser.

Para começar

7 dias grátis

com 1 instância + 1 proxy. Depois, o mínimo para operar é 1 de cada: R$ 100 por mês.

Criar conta

Aumentar unidades no meio do mês cobra só o proporcional aos dias que faltam. Reduzir vale na hora, e a próxima fatura vem menor.

Perguntas frequentes

Como a instância se conecta ao WhatsApp?

Pelo WhatsApp Web. Você lê o QR Code com o celular em Aparelhos conectados. A partir daí a instância envia e recebe pela API.

Como sei que a mensagem chegou?

Pelos eventos. O 202 só confirma que o envio entrou na fila. Depois chegam text.sent, text.delivered e, quando a pessoa abre, text.read, todos com o mesmo message_id. Quem desliga a confirmação de leitura nunca gera o read, e aí delivered é o estado final.

O IP da instância pode mudar?

Não enquanto ela estiver conectada. A instância vive no IP em que foi pareada. Para usar outro proxy, desconecte e conecte de novo escolhendo o novo.

E se o meu servidor ficar fora do ar?

Os eventos ficam na fila do webhook e são entregues em ordem quando ele voltar. Para conferir o intervalo, leia events/history?after= com o último event_id processado. O histórico guarda 7 dias.

Dá para integrar usando um agente de IA?

Sim. Entregue ao Claude Code ou ao Codex o roteiro docs.catcher.one/start.md, ou o prompt do card Comece com IA do Console. O índice para modelos fica em docs.catcher.one/llms.txt.

Posso testar o webhook antes de ligar a conta real?

Pode. O simulador de webhooks do Console recebe as entregas reais, mostra o JSON, os headers e se a assinatura HMAC bateu. Também dá para ensaiar cenários que a conta demora a produzir.

Conecte o primeiro número hoje.

7 dias grátis com 1 instância + 1 proxy. A instância fica pronta assim que você lê o QR Code.

Criar conta