Send Media

POST

/api/v1/messages/media

Sends media files (images, videos, audio) with optional captions.

⚠️ The newsletter functionality is in beta testing. Features and implementation may change. As we are using the latest WhatsApp features, you may experience some instability or unexpected behavior when sending messages to Newsletters.

Request

Header Params

Body Params application/json

Example

{
  "to": "12036337",
  "url": "https://sourei-autonotify.s3.sa-east-1.amazonaws.com/messages/012bc088-3014-415e-a737-95470611048e/3e3da4ff-de8a-4f7c-8ba7-fda1112114fb.mp4",
  "type": "video",
  "caption": "Meu vídeo"
}

/*
Imagem

{
  "to": "12036337",
  "url": "https://cdn.discordapp.com/attachments/855163145106096178/1331716214946267196/18a5e0803c90fac0b79dc2de8f7cdc1b.jpeg?ex=6792a0df&is=67914f5f&hm=eb1419162357f52bc050af3d34579ff7294b9205609e34080c3f8d8b33018ae0&",
  "type": "image",
  "caption": "Minha imagem"
}

Vídeo
{
  "to": "12036337",
  "url": "https://exemplo.com/video.mp4",
  "type": "video",
  "caption": "Meu vídeo"
}

Áudio (mensagem de voz)
{
  "to": "12036337",
  "url": "https://exemplo.com/audio.mp3",
  "type": "audio",
  "ptt": true
}

Documento
{
  "to": "12036337",
  "url": "https://exemplo.com/documento.pdf",
  "type": "document",
  "fileName": "documento.pdf",
  "caption": "Meu documento"
}
*/

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://nexus.sourei.com.br/api/v1/messages/media' \
--header 'Authorization: Bearer {{token}}' \
--header 'x-session-id: {{session_id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "to": "12036337",
  "url": "https://sourei-autonotify.s3.sa-east-1.amazonaws.com/messages/012bc088-3014-415e-a737-95470611048e/3e3da4ff-de8a-4f7c-8ba7-fda1112114fb.mp4",
  "type": "video",
  "caption": "Meu vídeo"
}

/*
Imagem

{
  "to": "12036337",
  "url": "https://cdn.discordapp.com/attachments/855163145106096178/1331716214946267196/18a5e0803c90fac0b79dc2de8f7cdc1b.jpeg?ex=6792a0df&is=67914f5f&hm=eb1419162357f52bc050af3d34579ff7294b9205609e34080c3f8d8b33018ae0&",
  "type": "image",
  "caption": "Minha imagem"
}

Vídeo
{
  "to": "12036337",
  "url": "https://exemplo.com/video.mp4",
  "type": "video",
  "caption": "Meu vídeo"
}

Áudio (mensagem de voz)
{
  "to": "12036337",
  "url": "https://exemplo.com/audio.mp3",
  "type": "audio",
  "ptt": true
}

Documento
{
  "to": "12036337",
  "url": "https://exemplo.com/documento.pdf",
  "type": "document",
  "fileName": "documento.pdf",
  "caption": "Meu documento"
}
*/'

Responses

🟢200OK

application/json

Body

Example

{
    "status": "string",
    "messageId": "string"
}

Modified at 2025-04-29 12:46:55

Send Plain Text

Send Poll