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

Parâmetros Bodyapplication/json

Exemplo

{
    "messageData": {
        "to": "551199999999@s.whatsapp.net",
        "base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKAAAACgCAMAAAC8...",
        "fileName": "imagem.png",
        "type": "image",
        "caption": "string",
        "mimeType": "image/jpeg"
    }
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Envio de arquivos (BASE64)