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

Formato do Número

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?"
  }'

const response = await fetch('https://api.wapizap.com/api/v2/messages', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: JSON.stringify({
    instanceId: 'sua-instancia',
    to: '5511999999999',
    type: 'text',
    text: 'Olá! Como posso ajudar?'
  })
});

import requests

response = requests.post(
    'https://api.wapizap.com/api/v2/messages',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN'
    },
    json={
        'instanceId': 'sua-instancia',
        'to': '5511999999999',
        'type': 'text',
        'text': 'Olá! Como posso ajudar?'
    }
)

Mensagem com Imagem

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!"
  }'

const response = await fetch('https://api.wapizap.com/api/v2/messages/media', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: JSON.stringify({
    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.

Mensagem com Documento

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"
  }'

const response = await fetch('https://api.wapizap.com/api/v2/messages/media', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: JSON.stringify({
    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
  }'

const response = await fetch('https://api.wapizap.com/api/v2/messages/audio', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: JSON.stringify({
    instanceId: 'sua-instancia',
    to: '5511999999999',
    audioUrl: 'https://exemplo.com/audio.mp3',
    ptt: true // Push-to-talk (mensagem de voz)
  })
});

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"
  }'

const response = await fetch('https://api.wapizap.com/api/v2/messages/location', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: JSON.stringify({
    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"
    }
  }'

const response = await fetch('https://api.wapizap.com/api/v2/messages/contact', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: JSON.stringify({
    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
  }'

const response = await fetch('https://api.wapizap.com/api/v2/messages/poll', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: JSON.stringify({
    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": "5511999999999@s.whatsapp.net",
    "reaction": "👍"
  }'

const response = await fetch('https://api.wapizap.com/api/v2/messages/reaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: JSON.stringify({
    instanceId: 'sua-instancia',
    messageId: '3EB0XXXXX',
    remoteJid: '5511999999999@s.whatsapp.net',
    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

Gerenciar Grupos

Aprenda a criar e gerenciar grupos

Configurar Webhooks

Receba notificações de mensagens

Comecar

Guias

Suporte

Enviando Mensagens

Enviando Mensagens

Pré-requisitos

Formato do Número

Mensagem de Texto

Mensagem com Imagem

Mensagem com Documento

Mensagem de Áudio

Mensagem de Localização

Mensagem de Contato

Enquete (Poll)

Reações

Melhores Práticas

Rate Limits

Formato do Número

Tamanho de Mídia

Validação

Próximos Passos

Gerenciar Grupos

Configurar Webhooks

​Enviando Mensagens

​Pré-requisitos

​Formato do Número

​Mensagem de Texto

​Mensagem com Imagem

​Mensagem com Documento

​Mensagem de Áudio

​Mensagem de Localização

​Mensagem de Contato

​Enquete (Poll)

​Reações

​Melhores Práticas

Rate Limits

Formato do Número

Tamanho de Mídia

Validação

​Próximos Passos

Gerenciar Grupos

Configurar Webhooks

Enviando Mensagens

Pré-requisitos

Formato do Número

Mensagem de Texto

Mensagem com Imagem

Mensagem com Documento

Mensagem de Áudio

Mensagem de Localização

Mensagem de Contato

Enquete (Poll)

Reações

Melhores Práticas

Próximos Passos