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