Tipos de mensagem suportados
Resumo: O gateway suporta texto, imagem, vídeo, áudio, documento, figurinha, localização, contato, botões interativos, listas, formulários e templates. Nem todos os tipos funcionam em todos os canais.
Quando usar isso
Antes de configurar o que seu sistema vai enviar, vale saber quais formatos são possíveis e em quais canais (Baileys vs WABA vs Instagram).
Lista completa
| Tipo | O que é | Baileys | WABA | |
|---|---|---|---|---|
| Texto | Mensagem de texto comum, com ou sem emoji | ✅ | ✅ | ✅ |
| Imagem | Foto JPG/PNG com legenda opcional | ✅ | ✅ | ✅ |
| Vídeo | MP4 com legenda opcional | ✅ | ✅ | ✅ |
| Áudio | Voice note ou arquivo de áudio | ✅ | ✅ | ✅ |
| Documento | PDF, DOC, XLS e outros formatos de arquivo | ✅ | ✅ | ❌ |
| Figurinha (sticker) | Imagem .webp (estática ou animada) | ✅ | ✅ | ❌ |
| Localização | Coordenada GPS + nome opcional do lugar | ✅ | ✅ | ❌ |
| Contato (vCard) | Cartão de contato com nome, telefone, e-mail | ✅ | ✅ | ❌ |
| Botões | 1 a 3 botões de resposta rápida | ✅ | ✅ | ❌ |
| Lista | Menu de seleção com opções organizadas em seções | ✅ | ✅ | ❌ |
| Template | Mensagem pré-aprovada pela Meta (obrigatória para iniciar conversas em WABA) | ❌ | ✅ | ❌ |
| CTA URL | Mensagem com botão único que abre um link | ❌ | ✅ | ❌ |
| Solicitação de localização | Pede para o cliente compartilhar a localização atual | ❌ | ✅ | ❌ |
| Endereço | Formulário estruturado de endereço (BR/IN) | ❌ | ✅ | ❌ |
| Flow (formulário) | Tela interativa com campos para o cliente preencher | ❌ | ✅ | ❌ |
Detalhes importantes por tipo
Texto
- Limite de 4096 caracteres por mensagem.
- Suporta emojis, quebras de linha e formatação básica do WhatsApp (
*negrito*,_itálico_,~tachado~,`mono`).
Imagem
- Formatos: JPG, PNG.
- Tamanho máximo: ~5 MB recomendado (5 MB no WABA, até 100 MB no Baileys).
- Legenda opcional (até 1024 caracteres).
Vídeo
- Formato: MP4.
- Tamanho máximo: ~16 MB no WABA, até 100 MB no Baileys.
- Legenda opcional.
Áudio
- Pode ser enviado como voice note (mostra a "bolinha" de mensagem de voz) ou arquivo de áudio comum.
- Formato recomendado: OGG (Opus) para voice note, MP3 para arquivo. O gateway aceita os dois.
- Para enviar como voice note, marque a opção
ptt: trueno seu sistema (ptt = "push to talk").
Documento
- Qualquer formato: PDF, DOCX, XLSX, ZIP, etc.
- Tamanho máximo: 100 MB.
- O nome do arquivo que o cliente vê pode ser personalizado.
Botões
- Até 3 botões por mensagem.
- Cada botão tem texto curto (até 20 caracteres).
- Quando o cliente clica, sua aplicação recebe uma mensagem inbound com o
button_reply.
Lista
- Até 10 seções, com até 10 opções por seção.
- O cliente vê um botão "Ver opções" que abre o menu.
- Quando seleciona, sua aplicação recebe um
list_reply.
Template (WABA)
- Veja o artigo completo: O que são templates WABA.
- Obrigatório para iniciar conversas em WABA fora da janela de 24h.
Dúvidas comuns
Por que botões e listas não funcionam no Instagram? A API do Instagram Direct é mais limitada — só permite texto, mídia e áudio. Para experiências interativas, use WhatsApp.
Posso enviar arquivos grandes (>100 MB)? Não pelo WhatsApp. O limite oficial é 100 MB. Para arquivos maiores, envie um link (texto com URL) apontando para o arquivo hospedado.
Posso enviar mídia e texto na mesma mensagem? Sim, mídias (imagem, vídeo, documento) aceitam uma legenda que aparece logo abaixo. Para o cliente, parece "uma mensagem só".
E mensagens com formatação rica (HTML, Markdown completo)? O WhatsApp não suporta HTML. Só a formatação básica nativa: *negrito*, _itálico_, ~tachado~, `texto monospace`.