Enviando Mensagens
Este guia mostra como enviar diferentes tipos de mensagens usando a Wapizap API.
Pré-requisitos
Antes de enviar mensagens, você precisa:
- Uma instância criada e conectada
- Sua API Key configurada
- O número do destinatário no formato internacional
O número deve estar no formato internacional sem símbolos:
| Incorreto | Correto |
|---|
| +55 11 99999-9999 | 5511999999999 |
| (11) 99999-9999 | 5511999999999 |
Mensagem de Texto
O tipo mais simples de mensagem.
curl -X POST https://api.wapizap.com/api/v2/messages \
-H "Content-Type: application/json" \
-H "Authorization: Bearer SEU_TOKEN" \
-d '{
"instanceId": "sua-instancia",
"to": "5511999999999",
"type": "text",
"text": "Olá! Como posso ajudar?"
}'
Envie imagens com legenda opcional.
curl -X POST https://api.wapizap.com/api/v2/messages/media \
-H "Content-Type: application/json" \
-H "Authorization: Bearer SEU_TOKEN" \
-d '{
"instanceId": "sua-instancia",
"to": "5511999999999",
"type": "image",
"mediaUrl": "https://exemplo.com/imagem.jpg",
"caption": "Confira nossa promoção!"
}'
Formatos suportados: JPG, PNG, GIF, WEBP. Tamanho máximo: 16MB.
Envie PDFs, planilhas e outros documentos.
curl -X POST https://api.wapizap.com/api/v2/messages/media \
-H "Content-Type: application/json" \
-H "Authorization: Bearer SEU_TOKEN" \
-d '{
"instanceId": "sua-instancia",
"to": "5511999999999",
"type": "document",
"mediaUrl": "https://exemplo.com/contrato.pdf",
"filename": "Contrato_2026.pdf"
}'
Mensagem de Áudio
Envie arquivos de áudio ou grave mensagens de voz.
curl -X POST https://api.wapizap.com/api/v2/messages/audio \
-H "Content-Type: application/json" \
-H "Authorization: Bearer SEU_TOKEN" \
-d '{
"instanceId": "sua-instancia",
"to": "5511999999999",
"audioUrl": "https://exemplo.com/audio.mp3",
"ptt": true
}'
Use ptt: true para enviar como mensagem de voz (bolinha verde). Use ptt: false para enviar como arquivo de áudio.
Mensagem de Localização
Compartilhe coordenadas geográficas.
curl -X POST https://api.wapizap.com/api/v2/messages/location \
-H "Content-Type: application/json" \
-H "Authorization: Bearer SEU_TOKEN" \
-d '{
"instanceId": "sua-instancia",
"to": "5511999999999",
"latitude": -23.550520,
"longitude": -46.633308,
"name": "Escritório Wapizap",
"address": "Av. Paulista, 1000 - São Paulo"
}'
Mensagem de Contato
Compartilhe cartões de contato (vCard).
curl -X POST https://api.wapizap.com/api/v2/messages/contact \
-H "Content-Type: application/json" \
-H "Authorization: Bearer SEU_TOKEN" \
-d '{
"instanceId": "sua-instancia",
"to": "5511999999999",
"contact": {
"fullName": "João Silva",
"phoneNumber": "5511988888888",
"organization": "Empresa XYZ"
}
}'
Enquete (Poll)
Crie enquetes interativas.
curl -X POST https://api.wapizap.com/api/v2/messages/poll \
-H "Content-Type: application/json" \
-H "Authorization: Bearer SEU_TOKEN" \
-d '{
"instanceId": "sua-instancia",
"to": "5511999999999",
"name": "Qual o melhor horário para reunião?",
"options": ["09:00", "14:00", "16:00"],
"selectableCount": 1
}'
Reações
Adicione reações (emojis) a mensagens existentes.
curl -X POST https://api.wapizap.com/api/v2/messages/reaction \
-H "Content-Type: application/json" \
-H "Authorization: Bearer SEU_TOKEN" \
-d '{
"instanceId": "sua-instancia",
"messageId": "3EB0XXXXX",
"remoteJid": "[email protected]",
"reaction": "👍"
}'
Para remover uma reação, envie reaction: "" (string vazia).
Melhores Práticas
Rate Limits
Respeite o limite de 30 mensagens/minuto por instância para evitar bloqueios.
Formato do Número
Sempre use formato internacional sem símbolos (ex: 5511999999999).
Tamanho de Mídia
Imagens até 16MB, vídeos até 64MB, documentos até 100MB.
Validação
Use o endpoint /contacts/check para validar números antes de enviar.
Próximos Passos