Tudo que você precisa saber para integrar WhatsApp em suas aplicações de forma profissional, segura e escalável.
O ZippyZap é uma plataforma completa de API WhatsApp Business que permite integrar funcionalidades de mensageria WhatsApp em suas aplicações, sistemas e processos de negócio de forma simples, rápida e confiável.
Acesse a plataforma e crie sua conta em menos de 2 minutos. Você receberá acesso imediato ao dashboard e poderá começar a testar a API.
No dashboard, acesse a seção "API Keys" e gere uma nova chave. Guarde-a em local seguro, pois ela será necessária para todas as chamadas à API.
zapi_live_abc123def456ghi789
Acesse a seção "WhatsApp" no dashboard e escaneie o QR Code com seu WhatsApp. Sua sessão ficará ativa e pronta para enviar mensagens.
curl -X POST https://api.zippyzap.com/whatsapp \-H "X-API-Key: YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"to": "11999999999","type": "text","message": "Olá! Sua mensagem foi enviada."}'
Webhooks são chamadas HTTP POST que o ZippyZap faz para sua aplicação quando eventos importantes acontecem, como recebimento de mensagens, confirmações de entrega, leitura, etc.
message.receivedmessage.sentmessage.deliveredmessage.readmessage.failedsession.connectedsession.disconnectedX-Webhook-Signature{"event": "message.received","timestamp": "2024-11-22T10:30:00Z","data": {"messageId": "msg_abc123","from": "+5511999999999","to": "+5511888888888","type": "text","message": "Olá!","timestamp": "2024-11-22T10:30:00Z"}}
// Node.js/Express exemploapp.post('/webhook', (req, res) => {const { event, data } = req.body;switch(event) {case 'message.received':console.log('Nova mensagem:', data.message);// Processar mensagem recebidabreak;case 'message.sent':console.log('Mensagem enviada:', data.messageId);break;case 'message.delivered':console.log('Mensagem entregue:', data.messageId);break;case 'message.read':console.log('Mensagem lida:', data.messageId);break;}res.status(200).send('OK');});
Todas as requisições devem incluir uma API Key válida no headerX-API-Key
Limites de requisições por minuto baseados no seu plano para evitar sobrecarga
Todas as comunicações são criptografadas usando TLS 1.3
Todas as ações são registradas para análise e detecção de anomalias
Sistema automático identifica e bloqueia padrões de spam
Verificação automática de conteúdo suspeito ou malicioso
Sempre obtenha permissão antes de enviar mensagens para um número
Evite enviar mensagens em horários inadequados (noite/madrugada)
Permita que usuários cancelem o recebimento de mensagens facilmente
Nunca exponha suas chaves em código público ou frontend
Acompanhe métricas e logs para detectar anomalias rapidamente
Implemente webhooks para rastrear status e evitar reenvios desnecessários
Verifique formato e validade dos números antes de enviar
Use backoff exponencial para retentar mensagens falhadas
| Status | Significado |
|---|---|
| initializing | Sessão sendo criada |
| qrcode | QR válido para escanear |
| scanning | Cliente escaneando |
| connected | Sessão autenticada |
| timeout | QR expirou |
| error | Sessão falhou |
/whatsappX-API-KeystringrequiredSua chave de APIContent-Typestringrequiredapplication/jsontostringrequiredNúmero de destino no formato DDD + número (ex: 11999999999)typestringrequiredTipo da mensagem: text, image, document, audio, videomessagestringrequiredConteúdo da mensagem{"message": "Mensagem enviada para a fila"}
/whatsapp/qrcodeX-API-KeystringrequiredSua chave de API{"status": "qr_received","qr": "data:image/png;base64,...."}
/whatsapp/sessionX-API-KeystringrequiredSua chave de API{"message": "Sessão criada com sucesso"}
/whatsapp/statusX-API-KeystringrequiredSua chave de API{"status": "connected"}
Após criar sua conta, acesse o dashboard e vá para a seção "API Keys". Clique em "Criar Nova Chave", dê um nome descritivo e a chave será gerada instantaneamente.
Não! O ZippyZap funciona com WhatsApp regular (não Business). Você pode usar seu número WhatsApp pessoal ou criar um novo número.
Os limites variam por plano: Free (10 req/min), Pro (100 req/min), Enterprise (customizado).
Crie sua conta gratuitamente e comece a enviar mensagens WhatsApp em minutos