{"id":104,"date":"2026-10-25T12:56:09","date_gmt":"2026-10-25T12:56:09","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/enviar-midia-api-whatsapp\/"},"modified":"2026-10-25T13:09:23","modified_gmt":"2026-10-25T13:09:23","slug":"enviar-midia-api-whatsapp","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/enviar-midia-api-whatsapp\/","title":{"rendered":"Como enviar imagem, PDF, \u00e1udio e v\u00eddeo pela API do WhatsApp"},"content":{"rendered":"\n

Atualizado em 25\/10\/2026<\/em><\/p>\n\n\n\n

Para enviar um arquivo pela API do WhatsApp, voc\u00ea faz um POST<\/code> no endpoint de mensagens com type<\/code> igual a image<\/code>, document<\/code>, audio<\/code> ou video<\/code> e indica o arquivo de duas formas: pelo id<\/code> de uma m\u00eddia enviada antes ao endpoint \/media<\/code> ou por um link<\/code> p\u00fablico. A Meta recomenda o upload com id<\/code>, aceita imagens JPEG e PNG at\u00e9 5 MB, \u00e1udio e v\u00eddeo at\u00e9 16 MB e documentos at\u00e9 100 MB. Fora da janela de 24 horas, a m\u00eddia s\u00f3 vai como cabe\u00e7alho de um template aprovado.<\/p>\n\n\n\n

Este guia mostra os formatos aceitos, quando usar upload ou link, quanto tempo um media ID vale, como receber e baixar arquivos que o cliente manda e exemplos prontos em cURL, Node.js e Python.<\/p>\n\n\n\n

Upload ou link: as duas formas de enviar m\u00eddia<\/h2>\n\n\n\n

Toda mensagem de m\u00eddia da Cloud API tem um objeto com o nome do tipo (image<\/code>, document<\/code>, audio<\/code>, video<\/code> ou sticker<\/code>). Dentro dele vai um<\/strong> destes campos, nunca os dois:<\/p>\n\n\n\n

Campo<\/th>O que \u00e9<\/th>Quando usar<\/th><\/tr><\/thead>
id<\/code><\/td>ID devolvido pelo endpoint POST \/<PHONE_NUMBER_ID>\/media<\/code> depois do upload<\/td>Recomendado pela Meta. Arquivo reutilizado em muitos envios, campanhas, arquivos privados<\/td><\/tr>
link<\/code><\/td>URL HTTPS p\u00fablica onde o arquivo est\u00e1 hospedado<\/td>Envios pontuais, arquivos que j\u00e1 est\u00e3o num CDN. A Meta marca essa op\u00e7\u00e3o como “n\u00e3o recomendada” por desempenho<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Com link<\/code>, os servidores da Meta precisam baixar o arquivo do seu servidor no momento do envio. Se a URL exige login, redireciona para uma p\u00e1gina HTML ou devolve um Content-Type<\/code> diferente do arquivo real, o envio falha. Com id<\/code>, o arquivo j\u00e1 est\u00e1 na Meta e o envio n\u00e3o depende do seu servidor estar no ar.<\/p>\n\n\n\n

Na pr\u00e1tica, muitos sistemas fazem assim: o arquivo que vai para muita gente (o cat\u00e1logo em PDF, o v\u00eddeo do tutorial) \u00e9 enviado uma vez ao \/media<\/code>, e o id<\/code> \u00e9 reutilizado enquanto valer. Arquivos gerados na hora (um boleto, uma nota) podem ir por link<\/code> assinado de curta dura\u00e7\u00e3o ou por upload logo antes do envio.<\/p>\n\n\n\n

Formatos e limites de tamanho oficiais<\/h2>\n\n\n\n

A tabela abaixo resume a p\u00e1gina de m\u00eddia da Cloud API<\/a>:<\/p>\n\n\n\n

Tipo<\/th>Formatos (MIME)<\/th>Tamanho m\u00e1ximo<\/th><\/tr><\/thead>
Imagem<\/td>image\/jpeg<\/code>, image\/png<\/code> (8 bits, RGB ou RGBA)<\/td>5 MB<\/td><\/tr>
Documento<\/td>application\/pdf<\/code>, text\/plain<\/code>, Word (.doc<\/code>, .docx<\/code>), Excel (.xls<\/code>, .xlsx<\/code>), PowerPoint (.ppt<\/code>, .pptx<\/code>)<\/td>100 MB<\/td><\/tr>
\u00c1udio<\/td>audio\/aac<\/code>, audio\/amr<\/code>, audio\/mpeg<\/code> (MP3), audio\/mp4<\/code> (M4A), audio\/ogg<\/code> (somente codec OPUS, mono)<\/td>16 MB<\/td><\/tr>
V\u00eddeo<\/td>video\/mp4<\/code>, video\/3gpp<\/code> (v\u00eddeo H.264 e \u00e1udio AAC)<\/td>16 MB<\/td><\/tr>
Sticker<\/td>image\/webp<\/code><\/td>100 KB est\u00e1tico, 500 KB animado<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Alguns detalhes que causam falha com frequ\u00eancia:<\/p>\n\n\n\n