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.

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
base64	string	Base64 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

Content-Type

string

requerido

Exemplo:

application/json

Authorization

string

requerido

Exemplo:

Bearer {{token}}

Parâmetros Bodyapplication/json

messageData

object

requerido

string

requerido

Contato whatsapp

base64

string

requerido

Arquivo no formato base64 que vai ser enviado

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": "551199999999@s.whatsapp.net",
    "base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKAAAACgCAMAAAC8...",
    "fileName": "imagem.png",
    "type": "image",
    "caption": "string",
    "mimeType": "image/jpeg"
  }
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Envio de arquivos (BASE64)