Messages

Enviar mensagens para usuários do WhatsApp. Suporta texto, mídia, templates, mensagens interativas e mais.

Enviar mensagem

post

Envia mensagens para usuários do WhatsApp por meio da Business API. Este endpoint centraliza a comunicação de saída com clientes.

Tipos de Mensagem

Tipo	Descrição	Janela de 24h exigida
text	Mensagens de texto simples até 4096 caracteres	Sim
image	Imagens JPEG, PNG até 5MB	Sim
video	Vídeos MP4, 3GPP até 16MB	Sim
audio	Áudios AAC, MP3, OGG até 16MB	Sim
document	PDF, arquivos Office até 100MB	Sim
sticker	Figurinhas WEBP, WEBM	Sim
contacts	Compartilhamento de cartões de contato	Sim
location	Compartilhamento de coordenadas geográficas	Sim
template	Templates aprovados previamente	Não
interactive	Listas, botões, catálogos de produtos	Sim

Janela de Mensagens

O WhatsApp aplica uma janela de atendimento de 24 horas:

• O envio de qualquer tipo de mensagem é permitido dentro de 24 horas da última mensagem do cliente

• Fora dessa janela, o envio exige templates aprovados

• Mensagens de template podem ser enviadas a qualquer momento para usuários opt-in

• Cada resposta do cliente reabre a janela de 24 horas

Precificação por Conversa

As conversas são categorizadas e precificadas de forma distinta:

• Marketing: Conteúdo promocional, ofertas, anúncios

• Utility: Atualizações de pedido, notificações de conta, lembretes de pagamento

• Authentication: Códigos OTP, verificação de login

• Service: Conversas iniciadas pelo cliente (gratuitas dentro da janela)

Boas Práticas

• Mensagens de marketing devem incluir instruções de cancelamento (opt-out)

• Templates devem ser usados em notificações sensíveis ao tempo

• O tratamento de erros deve considerar falhas de entrega

• O status das mensagens deve ser monitorado via webhooks para confirmação de entrega

Autorizações

ApiKeyAuth

apikeystringObrigatório

Chave de API para autenticação

Corpo

application/json

ou

ou

ou

ou

ou

ou

ou

ou

ou

ou

ou

ou

ou

Respostas

200

Mensagem enviada com sucesso

application/json

Resposta retornada após o envio bem-sucedido de uma mensagem. Contém informações sobre o destinatário e o identificador único da mensagem.

400

Payload de requisição inválido

application/json

401

Não autorizado.

application/json

post

/messages

HTTPcURLJavaScriptPython

POST /v1/messages HTTP/1.1
Host: waba.fortics.com.br
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 70

{
  "to": "5511999999999",
  "type": "text",
  "text": {
    "body": "Olá! Tudo bem?"
  }
}

Mensagem de textoCartão de contatoImagem por ID de mídiaImagem por URLVídeo por ID de mídiaVídeo por URLÁudio por ID de mídiaÁudio por URLDocumento por ID de mídiaDocumento por URLFigurinha por ID de mídiaFigurinha por URLTemplate de mensagemLista interativaBotões interativosSolicitação de permissão de chamada

{
  "contacts": [
    {
      "input": "5511999999999",
      "wa_id": "5511999999999"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgNNTUxMTk5OTk5OTk5FQIAEhgWM0VCMDA4RkI4"
    }
  ]
}