Logo

Base URL

https://lip-backend-1064145932505.southamerica-east1.run.app

Endpoint

POST /api/external/whatsapp/messages

Escopo necessario: whatsapp:send

Body (campos)

  • to (string, obrigatorio): numero no formato internacional
  • messageType (string, opcional): text, media, interactive, image, audio, video, document
  • content (string): obrigatorio para text e interactive
  • mediaUrl (string): obrigatorio para midia
  • mediaType (string): image, audio, video, document (obrigatorio quando messageType=media)
  • filename (string, opcional)
  • buttons (array, opcional): para interactive
  • listItems (array, opcional): para interactive

Regras e validacoes

  • messageType igual a image|audio|video|document vira media automaticamente.
  • messageType=media exige mediaType.
  • messageType=interactive exige content e buttons ou listItems.
  • Templates nao sao enviados por esta rota (use /templates/send).
  • O numero deve ser valido e celular (Brasil, DDI 55).
  • mediaUrl precisa ser acessivel publicamente pelo WhatsApp.

Formatos suportados (interativo)

Botoes (reply)

Envie buttons como array de objetos com id e title.

Exemplo:

Lista

Envie listItems com id, title e description opcional.

Exemplo:

Exemplos por tipo

Texto

Midia (imagem)

Midia (documento)

Exemplo em curl

Resposta

Erros comuns

  • 400 payload invalido
  • 401 API key invalida
  • 403 escopo insuficiente
  • 500 falha ao enviar mensagem

Última atualização

9 de fevereiro de 2026

Editar esta página no GitHub