Skip to main content
POST
https://api.enviaai.app
/
v1
/
messages
/
send
Enviar Mídia
curl --request POST \
  --url https://api.enviaai.app/v1/messages/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instanceId": "<string>",
  "to": "<string>",
  "mediaUrl": "<string>",
  "mediaType": "<string>",
  "caption": "<string>",
  "filename": "<string>"
}
'
{
  "success": true,
  "messageId": "msg_xyz789",
  "status": "queued",
  "timestamp": "2026-02-03T12:00:00.000Z"
}

Visão Geral

Envie arquivos de mídia via URL. O EnviaAI faz download do arquivo e envia pelo WhatsApp.

Tipos de Mídia

TipoFormatosTamanho Máx
imageJPEG, PNG, WebP5 MB
videoMP4, 3GP16 MB
audioMP3, OGG, AAC, M4A16 MB
documentPDF, DOC, XLS, etc100 MB

Request Body

instanceId
string
required
ID da instância
to
string
required
Número do destinatário
mediaUrl
string
required
URL pública do arquivo
mediaType
string
required
Tipo: image, video, audio, document
caption
string
Legenda (opcional)
filename
string
Nome do arquivo (para documentos)

Exemplos

Imagem

await client.messages.send({
  instanceId: 'inst_abc123',
  to: '5511999999999',
  mediaUrl: 'https://example.com/produto.jpg',
  mediaType: 'image',
  caption: 'Nosso novo produto!'
});

Documento PDF

await client.messages.send({
  instanceId: 'inst_abc123',
  to: '5511999999999',
  mediaUrl: 'https://example.com/contrato.pdf',
  mediaType: 'document',
  filename: 'Contrato-2026.pdf',
  caption: 'Segue o contrato para assinatura'
});

Áudio

await client.messages.send({
  instanceId: 'inst_abc123',
  to: '5511999999999',
  mediaUrl: 'https://example.com/audio.mp3',
  mediaType: 'audio'
});

Vídeo

await client.messages.send({
  instanceId: 'inst_abc123',
  to: '5511999999999',
  mediaUrl: 'https://example.com/tutorial.mp4',
  mediaType: 'video',
  caption: 'Tutorial de uso'
});
{
  "success": true,
  "messageId": "msg_xyz789",
  "status": "queued",
  "timestamp": "2026-02-03T12:00:00.000Z"
}

Requisitos da URL

  • Deve ser HTTPS (HTTP não é aceito)
  • Deve ser acessível publicamente
  • Content-Type correto no header
  • Não pode exigir autenticação

Erros Comuns

CódigoDescrição
media_too_largeArquivo excede limite
unsupported_media_typeFormato não suportado
media_download_failedNão conseguiu baixar
invalid_media_urlURL inválida