POST
/api/v1/messages/send

Enviar mensagem

Envia uma mensagem de texto simples ou com mídia para um contato via WhatsApp.

Autenticação

Todas as requisições requerem autenticação via API Key no header.

Authorization: Bearer YOUR_API_KEY

Parâmetros

number
string
obrigatório

Número do destinatário no formato internacional (ex: 5511999999999)

message
string
obrigatório

Conteúdo da mensagem de texto

media_url
string
opcional

URL da mídia (imagem, vídeo, documento ou áudio)

media_type
string
opcional

Tipo de mídia: image | video | document | audio

delay
number
opcional

Delay em segundos antes de enviar (padrão: 0)

Resposta

Retorna um objeto com os detalhes do envio.

{
  "success": true,
  "message_id": "msg_abc123xyz",
  "status": "sent",
  "timestamp": "2025-11-10T12:00:00Z",
  "number": "5511999999999"
}

Códigos de Erro

400

Bad Request

Parâmetros inválidos ou ausentes

401

Unauthorized

API Key inválida ou ausente

404

Not Found

Instância não encontrada

429

Too Many Requests

Limite de taxa excedido

500

Internal Server Error

Erro interno do servidor