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

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

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

Parâmetros Header

Parâmetros Bodyapplication/json

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"
    }
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200Sucesso

application/json

Body

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

Códigos de solicitação

Respostas

Envio de arquivos (mediaURL)

Exemplo