Perguntas Frequentes
Geral
O que é a Wapizap API?
O que é a Wapizap API?
A Wapizap API é uma API RESTful para integração com WhatsApp. Permite enviar e receber mensagens, gerenciar grupos, configurar webhooks e muito mais - tudo de forma programática.
A Wapizap API é oficial do WhatsApp?
A Wapizap API é oficial do WhatsApp?
Não. A Wapizap utiliza a biblioteca Baileys para conexão com WhatsApp Web. Para a API oficial do WhatsApp Business, consulte a documentação da Meta.
Posso usar para envio em massa (spam)?
Posso usar para envio em massa (spam)?
Não. O uso para spam viola nossos termos de uso e pode resultar em banimento da conta WhatsApp. Use de forma responsável e respeite os usuários.
Quantas instâncias posso criar?
Quantas instâncias posso criar?
Depende do seu plano:
- Free: 1 instância
- Starter: 3 instâncias
- Pro: 10 instâncias
- Enterprise: Ilimitado
Instâncias e Conexão
Como conectar uma instância ao WhatsApp?
Como conectar uma instância ao WhatsApp?
- Crie uma instância via API
- Obtenha o QR code ou código de pareamento
- No WhatsApp do celular, vá em Configurações → Aparelhos conectados
- Escaneie o QR code ou digite o código de pareamento
Por que minha instância desconecta?
Por que minha instância desconecta?
Possíveis causas:
- Deslogou do WhatsApp no celular
- Muitos dispositivos conectados (limite de 4)
- Inatividade prolongada
- Problemas de rede
O QR code expirou, o que fazer?
O QR code expirou, o que fazer?
QR codes expiram em 60 segundos. Faça uma nova requisição ao endpoint
/instances/{id}/qrcode para gerar um novo.Posso usar o mesmo número em múltiplas instâncias?
Posso usar o mesmo número em múltiplas instâncias?
Não. Cada número WhatsApp só pode estar conectado a uma instância por vez.
Preciso manter o celular conectado?
Preciso manter o celular conectado?
Não. Após escanear o QR code, a conexão é independente. O celular pode ficar offline ou desligado.
Mensagens
Qual o formato correto do número?
Qual o formato correto do número?
Use formato internacional sem símbolos:
- Correto:
5511999999999 - Incorreto:
+55 (11) 99999-9999
[código país][DDD][número]Como enviar para grupos?
Como enviar para grupos?
Use o ID do grupo no campo
to. O ID tem formato [email protected].Quais tipos de mídia são suportados?
Quais tipos de mídia são suportados?
| Tipo | Formatos | Tamanho Máximo |
|---|---|---|
| Imagem | JPG, PNG, WEBP, GIF | 16 MB |
| Vídeo | MP4, 3GP | 64 MB |
| Áudio | MP3, OGG, M4A, WAV | 16 MB |
| Documento | PDF, DOC, XLS, etc. | 100 MB |
Por que a mensagem não foi entregue?
Por que a mensagem não foi entregue?
Possíveis causas:
- Número não existe no WhatsApp (use
/contacts/checkpara validar) - Você foi bloqueado pelo destinatário
- Problema de conexão da instância
- Rate limit excedido
Como saber se a mensagem foi lida?
Como saber se a mensagem foi lida?
Configure um webhook para o evento
message.ack. Os status são:1= Enviado (um check)2= Entregue (dois checks)3= Lido (checks azuis)
Webhooks
O que são webhooks?
O que são webhooks?
Webhooks são notificações HTTP enviadas para sua aplicação quando eventos acontecem (nova mensagem, status de entrega, etc.). Em vez de ficar consultando a API, você recebe os dados automaticamente.
Meu webhook não está recebendo dados
Meu webhook não está recebendo dados
Verifique:
- A URL é acessível publicamente (não localhost)
- Usa HTTPS em produção
- Responde com HTTP 200 em menos de 5 segundos
- O webhook está ativo no dashboard
Como testar webhooks localmente?
Como testar webhooks localmente?
Use um serviço de túnel como:
- ngrok:
ngrok http 3000 - Cloudflare Tunnel:
cloudflared tunnel --url http://localhost:3000
Os webhooks têm retry automático?
Os webhooks têm retry automático?
Sim. Se seu servidor não responder com 2xx:
- 1ª tentativa: Imediata
- 2ª tentativa: Após 1 minuto
- 3ª tentativa: Após 5 minutos
- 4ª tentativa: Após 30 minutos
Limites e Planos
Quais são os rate limits?
Quais são os rate limits?
| Operação | Limite |
|---|---|
| Enviar mensagens | 30/minuto por instância |
| Criar instâncias | 10/hora |
| Requisições gerais | 120/minuto |
O que acontece se exceder o rate limit?
O que acontece se exceder o rate limit?
Você receberá erro HTTP 429 com o tempo para aguardar. Implemente exponential backoff para lidar com isso automaticamente.
Como fazer upgrade do plano?
Como fazer upgrade do plano?
Acesse o Dashboard → Configurações → Plano e selecione o plano desejado.
Segurança
Minhas mensagens são armazenadas?
Minhas mensagens são armazenadas?
Mensagens são processadas em tempo real e não são armazenadas permanentemente em nossos servidores. Apenas metadados necessários para o funcionamento são mantidos temporariamente.
A conexão é criptografada?
A conexão é criptografada?
Sim. Todas as comunicações usam HTTPS/TLS. A criptografia ponta-a-ponta do WhatsApp é mantida.
Como proteger minha API Key?
Como proteger minha API Key?
- Use variáveis de ambiente (não hardcode)
- Nunca exponha em código frontend
- Rotacione periodicamente
- Use chaves diferentes para dev/prod
Posso restringir acesso por IP?
Posso restringir acesso por IP?
Sim, no plano Enterprise. Entre em contato com o suporte para configurar whitelist de IPs.
Problemas Técnicos
Erro 'Instance not connected'
Erro 'Instance not connected'
A instância perdeu conexão com o WhatsApp. Reconecte usando:
POST /instances/{id}/connectpara gerar novo QR code- Escaneie o QR code no celular
Erro 'Invalid number'
Erro 'Invalid number'
O número não está registrado no WhatsApp. Use
/contacts/check para validar números antes de enviar mensagens.Erro 'Rate limit exceeded'
Erro 'Rate limit exceeded'
Você excedeu o limite de requisições. Aguarde o tempo indicado na resposta e implemente throttling na sua aplicação.
A API está fora do ar?
A API está fora do ar?
Verifique nosso Status Page para informações sobre incidentes. Se o problema persistir, contate o suporte.