Skip to main content

​
Tipos de Mensagem

O EnviaAI suporta todos os tipos de mensagem do WhatsApp:

​
Texto

Mensagens de texto simples, com suporte a formatação. 
{
  "to": "5511999999999",
  "message": "Olá! *Texto em negrito* e _itálico_"
}
Formatação suportada:
  • *negrito* → negrito
  • _itálico_ → itálico
  • ~tachado~ → tachado
  • \“código```→código`

​
Mídia

Imagens, vídeos, áudios e documentos.
TipoFormatosTamanho Máx
imageJPEG, PNG, WebP5 MB
videoMP4, 3GP16 MB
audioMP3, OGG, AAC, M4A16 MB
documentPDF, DOC, XLS, etc100 MB

​
Localização

Compartilhe coordenadas geográficas. 
{
  "to": "5511999999999",
  "type": "location",
  "latitude": -23.5505,
  "longitude": -46.6333,
  "name": "São Paulo",
  "address": "Centro, São Paulo - SP"
}

​
Contato

Compartilhe cartões de contato (vCard). 
{
  "to": "5511999999999",
  "type": "contact",
  "contact": {
    "name": "João Silva",
    "phone": "5511988888888"
  }
}

​
Stickers

Envie figurinhas (WebP animado ou estático). 
{
  "to": "5511999999999",
  "type": "sticker",
  "mediaUrl": "https://example.com/sticker.webp"
}

​
Fluxo de Status

Toda mensagem passa pelos seguintes status:
StatusDescriçãoWebhook
queuedNa fila para envio-
sentEnviada ao WhatsAppmessage.sent
deliveredEntregue ao destinatáriomessage.delivered
readLida pelo destinatáriomessage.read
failedFalha no enviomessage.failed

​
Mensagens Recebidas

Quando alguém envia uma mensagem para sua instância, você recebe via webhook: 
{
  "event": "message.received",
  "data": {
    "messageId": "msg_abc123",
    "instanceId": "inst_xyz789",
    "from": "5511999999999",
    "type": "text",
    "content": "Olá, preciso de ajuda!",
    "timestamp": "2026-02-03T12:00:00Z",
    "contactName": "Cliente"
  }
}

​
Respondendo Mensagens

Para responder a uma mensagem específica (quote): 
{
  "to": "5511999999999",
  "message": "Claro! Como posso ajudar?",
  "quotedMessageId": "msg_original123"
}

​
Templates (API Oficial)

Com a API Oficial da Meta, você pode usar templates aprovados: 
{
  "to": "5511999999999",
  "template": {
    "name": "order_confirmation",
    "language": "pt_BR",
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "João" },
          { "type": "text", "text": "#12345" }
        ]
      }
    ]
  }
}
Templates são obrigatórios na API Oficial para iniciar conversas após 24h sem interação do cliente.

​
Rate Limits

PlanoMensagens/minuto
Free100
Starter500
Pro2.000
EnterpriseCustom

​
Boas Práticas

Evite enviar mensagens fora do horário comercial (antes das 8h ou após as 20h).
Use o nome do cliente e informações relevantes para aumentar engajamento.
Envie apenas mensagens relevantes e solicitadas. Spam pode resultar em banimento.
Monitore falhas e implemente retry com backoff exponencial.