Skip to main content

​
Mensagens

A API suporta diversos tipos de mensagens do WhatsApp, desde texto simples até mensagens interativas com botões e listas.

​
Tipos de Mensagem

Texto

Mensagens de texto simples com suporte a menções e formatação.

Imagem

Fotos e imagens com legenda opcional.

Vídeo

Vídeos com legenda e opção de GIF.

Áudio

Áudios e mensagens de voz (PTT).

Documento

PDFs, planilhas e outros arquivos.

Sticker

Figurinhas/adesivos.

Localização

Compartilhar localização no mapa.

Contato (vCard)

Envie um contato no formato vCard.

Reação

Reagir a mensagens com emoji.

​
Formato do Destinatário

O campo to aceita os seguintes formatos:
TipoFormatoExemplo
NúmeroDDI + DDD + Número5511999999999
JIDnúmero@s.whatsapp.net5511999999999@s.whatsapp.net
Grupoid@g.us120363123456789012@g.us
Sempre use o número completo com código do país. Para o Brasil, use 55 seguido do DDD e número.

​
Campos Comuns

Todos os endpoints de mensagem aceitam estes campos opcionais:
​
sessionId
string
required
ID da sessão que enviará a mensagem.
​
to
string
required
Destinatário (número ou JID).
​
quoted
object
Responder a uma mensagem específica.
{
  "messageId": "3EB0ABC123...",
  "participant": "5511888888888@s.whatsapp.net"
}
​
mentions
string[]
Array de JIDs para mencionar (@) na mensagem.
​
viewOnce
boolean
default:"false"
Mensagem que desaparece após ser vista.

​
Resposta Padrão

Todos os endpoints de envio retornam: 
{
  "messageId": "3EB0ABC123DEF456789...",
  "status": "sent",
  "to": "5511999999999@s.whatsapp.net",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

​
Limites de Mídia

TipoTamanho Máximo
Imagem16 MB
Vídeo64 MB
Áudio16 MB
Documento100 MB
Sticker500 KB
Arquivos maiores que os limites serão rejeitados com erro MEDIA_TOO_LARGE.