Skip to main content
POST
/
media
Upload de Mídia
curl --request POST \
  --url https://apis.vectalk.com.br/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "messaging_product": "<string>"
}
'
Requer token de instância.
Após o upload, use o id retornado no campo id (em vez de link) ao enviar mensagens de imagem, documento, áudio ou vídeo.

Limites por tipo

TipoMIME typesTamanho máximo
Imagemimage/jpeg, image/png, image/webp5 MB
Áudioaudio/aac, audio/mp4, audio/mpeg, audio/ogg16 MB
Vídeovideo/mp4, video/3gp16 MB
Documentoapplication/pdf, text/plain, Office100 MB
Stickerimage/webp (animado ou estático)100 KB

Parâmetros

Path

phone-number-id
string
required
ID do número de telefone.

Body (multipart/form-data)

file
file
required
Arquivo a ser enviado.
type
string
required
MIME type do arquivo. Ex: image/jpeg.
messaging_product
string
required
Sempre "whatsapp".

Exemplo

curl -X POST https://apis.vectalk.com.br/whatsapp/PHONE_NUMBER_ID/media \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@/caminho/para/imagem.jpg" \
  -F "type=image/jpeg" \
  -F "messaging_product=whatsapp"

Resposta

{
  "id": "1234567890"
}
Use o id em uma mensagem de imagem:
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "image",
  "image": {
    "id": "1234567890",
    "caption": "Confira!"
  }
}