Envio de arquivos (URL)

POST/rest/sendMessage/{{instance_key}}1/mediaUrl

Envio de arquivos (BASE64)

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

Utilizando Base64: Para esta opção, sua aplicação deve incluir uma funcionalidade para transformar a imagem em Base64. Uma boa maneira de verificar se a conversão foi bem-sucedida é copiar o código Base64 gerado e colá-lo na barra de endereços do navegador. Se a imagem for exibida corretamente, significa que a conversão foi efetiva. Se não, é sinal de que algo precisa ser ajustado. Lembre-se de adicionar 'data:{mimetype};base64,' antes do seu código Base64.

Para testar este método, você pode usar ferramentas online de conversão de imagens para Base64. Aqui estão alguns exemplos de conversores que você pode experimentar.
Base64 Guru

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.

Exemplo

:::info[]
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
:::

:::danger[]
⚠️ 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.
:::

Request

Authorization: Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Exemplo

Authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379

Parâmetros Header

Content-Type

string

requerido

Exemplo:

application/json

Authorization

string

requerido

Exemplo:

Bearer {{token}}

messageData

object

requerido

string

requerido

url

string

requerido

fileName

string

requerido

type

string

requerido

caption

string

requerido

mimeType

string

requerido

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

Request samples

Respostas

Sucesso(200)

Whatsapp inválido(200)

Error Arquivo(200)

Não autorizado(200)

HTTP Code: 200

Content Type : JSONapplication/json

error

boolean

requerido

message

string

requerido

messageData

object

requerido

key

object

requerido

message

object

requerido

messageTimestamp

string

requerido

status

string

requerido

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