Envio de arquivos (URL)

Envio de arquivos (mediaURL)

Este método permite o envio de arquivos para seus chats de uma forma distinta:

Através de um Link: Caso o arquivo já esteja disponível online, você pode simplesmente enviar seu URL.

Quanto ao tamanho e aos formatos dos arquivos, as diretrizes do WhatsApp mudam com frequência. Por isso, é sempre uma boa prática consultar o site oficial do WhatsApp para as informações mais recentes. Encontre orientações detalhadas sobre tamanhos e formatos de arquivo aqui.

Atributos	Tipo	Descrição
to	string	Contato que vai receber a mensagem
url	string	URL da mídia a ser enviada
fileName	string	Nome do arquivo
type	string	É o tipo de mídia a ser enviada image video audio (formato compartilhado) ptt (audio formato gravado) document
caption	string	É a legenda da mídia a ser enviada (Funciona somente em imagem e vídeo)
mineType	string	MineTypes: imagem = image/jpeg video = video/mp4 audio = audio/ogg; codecs=opus pdf = application/pdf xlsx = application/vnd.openxmlformats-officedocument.spreadsheetml.sheet word = application/vnd.openxmlformats-officedocument.wordprocessingml.document php, bin, html = application/octet-stream sql = application/x-sql

Exemplo

Fique atento!
Para enviar para contatos privados, o contato deve conter o @s.whatsapp.net. Para envios em grupo, você precisará coletar os ID's dos grupos utilizando o endpoint listGroup, os ID's devem conter @g.us

⚠️ Atenção
Tenha em mente que o envio de mensagens para um grande número de contatos simultaneamente pode ser interpretado pelo WhatsApp como comportamento de spam. Esta prática aumenta significativamente o risco de ter sua conta banida ou restrita. Recomendamos fortemente moderar a frequência e o volume dos envios para evitar tais consequências.

Requisição

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Content-Type

string

requerido

Exemplo:

application/json

Authorization

string

requerido

Exemplo:

Bearer {{token}}

Parâmetros Bodyapplication/json

messageData

object

requerido

string

requerido

Contato Whatsapp

url

string

requerido

URL do arquivo

fileName

string

requerido

Nome do arquivo

type

string

requerido

Tipo de arquivo
image
video
audio (formato compartilhado)
ptt (audio formato gravado)
document

caption

string

requerido

Legenda

mimeType

string

requerido

MineTypes:
imagem = image/jpeg,
video = video/mp4,
ptt = audio/ogg; codecs=opus,
audio = audio/ogg; codecs=opus,
pdf = application/pdf,
xlsx = application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,
word = application/vnd.openxmlformats-officedocument.wordprocessingml.document,
php, bin, html = application/octet-stream,
sql = application/x-sql

Exemplo

{
  "messageData": {
    "to": "556195562618@s.whatsapp.net",
    "url": "https://www.thecampusqdl.com/uploads/files/pdf_sample_2.pdf",
    "fileName": "pdfExemplo.pdf",
    "type": "document",
    "caption": "string",
    "mimeType": "application/pdf"
  }
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200Sucesso

application/json

Body

error

boolean

requerido

message

string

requerido

messageData

object

requerido

key

object

requerido

message

object

requerido

messageTimestamp

string

requerido

status

string

requerido

Exemplo

{
  "error": true,
  "message": "string",
  "messageData": {
    "key": {
      "remoteJid": "string",
      "fromMe": true,
      "id": "string"
    },
    "message": {
      "audioMessage": {
        "url": "string",
        "mimetype": "string",
        "fileSha256": "string",
        "fileLength": "string",
        "seconds": 0,
        "ptt": true,
        "mediaKey": "string",
        "fileEncSha256": "string",
        "directPath": "string",
        "mediaKeyTimestamp": "string",
        "waveform": "string"
      }
    },
    "messageTimestamp": "string",
    "status": "string"
  }
}

🟢200Whatsapp inválido

🟢200Error Arquivo

🟢200Não autorizado

Envio de arquivos (mediaURL)#

Exemplo#

Requisição

Exemplos de Requisição

Respostas

Envio de arquivos (mediaURL)

Exemplo