Wow! Emoji of happy man Redução de 65% no preço para clientes brasileiros! Registre-se agora
Documentação para desenvolvedores · API HTTP

Documentação da WhatsApp API

Tudo o que você precisa para enviar e receber mensagens do WhatsApp, automatizar grupos e criar integrações usando requisições HTTP simples.
A API oferece suporte a mensagens, mídia, arquivos, status, grupos, comunidades e canais. Você pode receber conversas de entrada, enviar produtos, processar pedidos, validar números e criar automações personalizadas.

Comece a enviar mensagens do WhatsApp em minutos

Comece em 3 passos simples

Icon

Crie uma conta e conecte um número

Crie uma conta na Whapi.Cloud e vincule seu número do WhatsApp via código QR.

Icon

Obtenha seu token de API

Copie seu token de API no painel e autorize suas requisições.

Icon

Envie sua primeira mensagem

Faça sua primeira chamada à API e receba mensagens via webhooks.

Experiência focada no desenvolvedor

Teste a API com suas ferramentas favoritas

Após obter um token de API, você pode explorar e testar todos os endpoints usando Swagger ou Postman. Utilize o token da API como cabeçalho de autorização Bearer.

Testar no Swagger

/

Teste a API com suas <span>ferramentas favoritas</span>
Teste a API com suas <span>ferramentas favoritas</span>
Decorartive bubble
Comece <span>mais rápido</span> com projetos prontos <span>no GitHub</span>
Exemplos open source

Comece mais rápido com projetos prontos no GitHub

Explore exemplos reais e projetos iniciais construídos sobre a API da Whapi.Cloud. Nossos repositórios no GitHub incluem bots funcionais, utilitários e scripts de automação em várias linguagens — projetados para ajudar você a entender a API mais rapidamente e iniciar com confiança.

  • Bot de WhatsApp em Node.js: Exemplo pronto para produção para criar bots e automações usando JavaScript.
  • Bots em PHP (2 níveis): Exemplo para iniciantes (configuração mínima, estrutura clara) e bot avançado — lógica mais rica, tratamento de mensagens, grupos e webhooks.
  • Bots em Python (2 níveis): Bot inicial simples para testes rápidos e implementação avançada com recursos estendidos e tratamento de eventos.
  • Bot em Java: Implementação simples e direta de chatbot para acelerar o início do desenvolvimento.
  • WhatsApp Number Checker: Exemplo prático de verificação da disponibilidade de números do WhatsApp com controle seguro de ritmo e processamento em lote.
Ver repositórios no GitHub
Decorartive bubble
Perguntas operacionais comuns

Perguntas frequentes

A Whapi.Cloud se conecta ao WhatsApp usando uma sessão de dispositivo vinculado. Sua conta do WhatsApp é pareada a um canal por meio de um código QR ou código de pareamento, de forma semelhante ao WhatsApp Web, porém a conexão é mantida por sockets no backend. A API então atua como um gateway seguro que envia e recebe eventos (mensagens, status, atualizações de grupos) em tempo real e os expõe por meio de endpoints HTTP e webhooks.
Não. Após o número ser vinculado, o telefone não precisa permanecer constantemente online. No entanto, o WhatsApp pode exigir atividade ocasional no dispositivo principal para manter a sessão vinculada válida. Na prática, abrir o WhatsApp no telefone uma vez a cada duas semanas costuma ser suficiente.
Sim. Você pode continuar usando o WhatsApp normalmente no telefone e no WhatsApp Web enquanto a API estiver conectada. A API funciona em paralelo como um dispositivo vinculado adicional e não bloqueia nem substitui o uso regular.
Em alguns casos, o WhatsApp pode invalidar automaticamente sessões de dispositivos vinculados. Quando isso ocorre, o canal exigirá uma nova autorização por meio da leitura de um novo código QR ou do uso de um código de pareamento. Nenhum dado é perdido e, após a nova vinculação, a API retoma o funcionamento normal imediatamente.
Sim. Embora a API em si não imponha limites rígidos de envio nos planos pagos, o WhatsApp monitora ativamente o comportamento das contas. O uso seguro depende mais da forma como as mensagens são enviadas do que da API isoladamente. Aquecimento gradual, ritmo adequado, conteúdo relevante e engajamento dos destinatários desempenham um papel fundamental. Padrões de envio agressivos ou não naturais podem gerar restrições independentemente da ferramenta utilizada, portanto fluxos de produção devem sempre incluir atrasos, envio em lotes e controle básico de taxa.
Webhooks são callbacks HTTP em tempo real enviados pela Whapi.Cloud ao seu servidor sempre que eventos relevantes ocorrem. Eles são acionados quando mensagens são recebidas, quando o status de entrega ou leitura muda, quando ocorrem eventos em grupos ou canais, ou quando outras atualizações relacionadas ao WhatsApp são detectadas. Isso permite que seu sistema reaja instantaneamente sem a necessidade de consultar a API continuamente, tornando os webhooks o principal mecanismo para criar automações e bots orientados a eventos.
Sim. A API foi projetada para suportar operação contínua e fluxos de longa duração, como chatbots, serviços de notificação, integrações com CRM e sistemas de monitoramento. Após um número ser vinculado e devidamente autorizado, a API pode operar indefinidamente, desde que o WhatsApp não redefina a sessão do dispositivo vinculado. Para uso estável e ininterrupto em ambientes de produção, recomenda-se um plano pago.
O uso da API por si só não aumenta automaticamente o risco de bloqueio. As restrições são causadas principalmente pela forma como a conta do WhatsApp é utilizada. Comportamentos de envio que pareçam spam, reputação ruim do número, baixo engajamento dos destinatários ou feedback negativo podem levar a limitações, com ou sem API. Seguir boas práticas, como aquecimento gradual, controle de velocidade de envio e conteúdo relevante, reduz significativamente os riscos.
A Whapi.Cloud não armazena permanentemente o conteúdo das suas mensagens. As mensagens são processadas em tempo real para entrega, acionamento de webhooks e geração de eventos de status. Enquanto um canal está ativo, os dados das mensagens podem ser mantidos temporariamente em caches técnicos de curta duração, exclusivamente para fins de processamento, roteamento e tratamento de eventos. Quando um canal é desconectado ou se torna inativo, nenhum conteúdo de mensagem é retido pela Whapi.Cloud. A API não foi projetada para funcionar como um sistema de armazenamento ou arquivamento de mensagens. Qualquer armazenamento de longo prazo, análises ou histórico de mensagens deve ser implementado na sua própria infraestrutura utilizando webhooks e respostas da API.