Arquivos e mídias na API do WhatsApp: formatos aceitos, tamanho máximo e o que dá erro
- A API do WhatsApp tem formatos e tamanhos fixos para cada tipo de arquivo.
- Imagem até 5 MB, vídeo e áudio até 16 MB, documento até 100 MB.
- Texto até 4.096 caracteres; legenda de imagem, vídeo e documento até 1.024.
- Mensagem de voz exige OGG com OPUS; o cliente vê o microfone e pode ver a transcrição.
Não é pra quem: Não é pra quem usa só o app WhatsApp Business no celular: os limites do app são outros e mudam com a versão; esta tabela vale para a API oficial (Cloud API).
O que a Certu mediu no WhatsApp de 67 negócios
Nos 67 negócios que atendem com a IA da Certu, 32,5% das 122.720 mensagens de cliente chegaram fora de segunda a sexta, das 8h às 18h (30 de julho a 30 de setembro de 2026). Metade das respostas da IA saiu em até 11,7 segundos, e 9 em cada 10 em até 20,7 segundos (38.908 respostas). 34,6% das conversas começaram fora do horário comercial, e a hora com mais mensagens foi 11h.
| O que foi medido | Resultado | Base |
|---|---|---|
| Mensagens de cliente fora de segunda a sexta, 8h às 18h | 32,5% | 122.720 mensagens de cliente de 67 negócios |
| Mensagens no fim de semana | 15,8% | 122.720 mensagens de cliente de 67 negócios |
| Conversas que começam fora do horário comercial | 34,6% | 19.900 conversas |
| Tempo até a IA responder (metade das respostas) | até 11,7 segundos | 38.908 respostas da IA |
| Tempo até a IA responder (9 em cada 10 respostas) | até 20,7 segundos | 38.908 respostas da IA |
| Hora do dia com mais mensagens de cliente | 11h | 122.720 mensagens de cliente de 67 negócios |
Fonte: base de atendimento da Certu, só números somados, nenhuma conversa lida por gente; sem histórico importado, sem contato de teste e sem o atendimento de vendas da própria Certu. 30 de julho a 30 de setembro de 2026, medido em 09/10/2026. Método e tabela por ramo no Índice Certu de Atendimento por WhatsApp e em certu.com.br/dados.
Clientes com nome, 30/07 a 10/10/2026
| Cliente | Mensagens de cliente | Respostas da IA | Conversas atendidas | Fora do horário | IA responde em (mediana) | Dias com mensagem |
|---|---|---|---|---|---|---|
| JP Gás Água e Rações distribuidora de gás e água | 42.832 | 23.351 | 6.479 | 33,6% | 9,8 s | 70 |
| CEMIP clínica médica | 12.472 | 6.484 | 2.436 | 18,7% | 11,4 s | 37 |
| Nikiti Auto Center auto center | 4.912 | 3.548 | 900 | 19,5% | 14,4 s | 47 |
| Imobiliária Rodrigues & Ribeiro imobiliária | 6.090 | 2.759 | 823 | 33,2% | 18,4 s | 34 |
| Alpha RH recursos humanos | 3.082 | 1.666 | 721 | 27,5% | 15,6 s | 52 |
Números de operação do painel de cada conta, mesma régua do Índice, medidos em 11/10/2026. Publicados com a autorização de cada dono. Resultado de venda só sai com o dono confirmando por escrito. Lista completa em certu.com.br/casos.
O que clientes da Certu escreveram
A Certu reúne em um só lugar recursos que normalmente exigiriam várias ferramentas. Atendimento pelo WhatsApp, CRM, agenda, acompanhamento de oportunidades, campanhas e gestão da operação ficam conectados. No geral, a proposta é muito boa para quem quer reduzir tarefas manuais e ter mais controle sobre o que acontece no atendimento e nas vendas. [...]
Avaliação pública (com o link) ou texto enviado pela própria empresa e publicado com autorização por escrito. A nota só aparece quando a fonte tem nota.
Sobre a Certu: a Certu é a plataforma brasileira de IA que atende o WhatsApp, o Instagram e o Messenger de pequenas e médias empresas 24 horas por dia, com CRM incluído, e é Tech Provider da Plataforma WhatsApp Business da Meta. Os planos começam em R$ 2.964 por ano, sem fidelidade. Conectar meu WhatsApp
Bernardo Villela · CEO, Certu
Quer ver isso funcionando no WhatsApp do seu negócio? Conecte o seu WhatsApp e a IA aprende com as suas conversas.
Resumo em 7 fatos
- Não é pra quem: Não é pra quem usa só o app WhatsApp Business no celular: os limites do app são outros e mudam com a versão; esta tabela vale para a API oficial (Cloud API).
- Quer ver isso funcionando no WhatsApp do seu negócio?
- Conecte o seu WhatsApp e a IA aprende com as suas conversas.
- Pela documentação de mídia da Meta para a API oficial (Cloud API): O limite geral de arquivo de mídia na Cloud API é 100 MB.
- A API separa duas coisas: Para a mensagem chegar como voz (aquela com microfone, igual à de uma pessoa), o arquivo precisa ser OGG com OPUS.
- Se mandar outro formato como voz, a transcrição falha.
- Formatos: PDF, TXT, Word (DOC, DOCX), Excel (XLS, XLSX), PowerPoint (PPT, PPTX).
Em números
| Número | O que significa |
|---|---|
| 1.024 caracteres | Legenda opcional, até 1.024 caracteres. |
| 10 minutos | A API aceita a mídia de dois jeitos, e a Meta recomenda um deles: Com o link, a Meta guarda a mídia em cache por pouco tempo (cerca de 10 minutos); se o arquivo mudar no servidor nesse intervalo,… |
| 30 dias | Com o upload, o arquivo fica criptografado e disponível por 30 dias, e pode ser reaproveitado em várias mensagens nesse prazo, sem subir de novo. |
| 80% | Foto: exporte em JPEG com qualidade em torno de 80% e no máximo 1.600 a 2.000 pixels no lado maior. |
| 60 segundos | Vídeo curto: 30 a 60 segundos explicam um produto e cabem nos 16 MB. |
| R$ 299 por mês | O plano Start custa R$ 299 por mês e o Pro, R$ 599. |
| 200 mensagens | A gente monta tudo pra você e as primeiras 200 mensagens, em até 7 dias, são por nossa conta. |
A tabela completa de formatos e tamanhos
Pela documentação de mídia da Meta para a API oficial (Cloud API):
| Tipo | Formatos | Tamanho máximo |
|---|---|---|
| Imagem | JPEG (.jpeg), PNG (.png) | 5 MB |
| Vídeo | MP4 (.mp4), 3GPP (.3gp) | 16 MB |
| Áudio | AAC, AMR, MP3, M4A, OGG (só OPUS, mono) | 16 MB |
| Documento | PDF, TXT, DOC, DOCX, XLS, XLSX, PPT, PPTX | 100 MB |
| Figurinha estática | WebP | 100 KB |
| Figurinha animada | WebP | 500 KB |
O limite geral de arquivo de mídia na Cloud API é 100 MB.
Imagem
- Formatos: JPEG e PNG. Até 5 MB.
- Legenda opcional, até 1.024 caracteres.
- WebP não vai como imagem: na API, WebP só é aceito como figurinha.
Dica prática: foto de celular costuma passar dos 5 MB em alta resolução. Reduza para algo como 1.600 pixels no lado maior antes de enviar; no WhatsApp, a diferença não aparece.
Vídeo
- Formatos: MP4 e 3GP. Até 16 MB.
- Só o codec de vídeo H.264 e o de áudio AAC, com uma faixa de áudio ou nenhuma.
- O cliente vê uma miniatura e toca para carregar. Legenda até 1.024 caracteres.
Vídeo gravado no celular, em alta resolução, passa dos 16 MB em poucos segundos. Para vídeo maior, mande um link (o WhatsApp mostra a pré-visualização do primeiro link do texto, se você pedir).
Áudio e mensagem de voz
A API separa duas coisas:
| Áudio comum | Mensagem de voz | |
|---|---|---|
| Formato | AAC, AMR, MP3, M4A, OGG | Só OGG com codec OPUS |
| Ícone para o cliente | Nota musical | Microfone, com a foto do perfil |
| Download automático | Não | Sim |
| Transcrição | Não | Se o cliente ativou a transcrição de mensagens de voz |
| Aviso de reprodução | Não | Desde março de 2026, a empresa recebe o status "reproduzida" na primeira vez que o cliente ouve |
Para a mensagem chegar como voz (aquela com microfone, igual à de uma pessoa), o arquivo precisa ser OGG com OPUS. Se mandar outro formato como voz, a transcrição falha.
Documento
- Formatos: PDF, TXT, Word (DOC, DOCX), Excel (XLS, XLSX), PowerPoint (PPT, PPTX). Até 100 MB.
- Nome do arquivo opcional, com extensão: o WhatsApp usa a extensão para escolher o ícone.
- Legenda até 1.024 caracteres.
Nomeie o arquivo de forma que o cliente entenda: orcamento-maria-silva.pdf diz muito mais que doc_2026_10_23_final2.pdf.
Figurinha
- Só WebP: 100 KB estática, 500 KB animada.
- É o único jeito de mandar WebP pela API.
Texto e outros tipos de mensagem
| Tipo | Limite ou regra |
|---|---|
| Texto | Até 4.096 caracteres; links viram clicáveis; pré-visualização só do primeiro link, se ativada |
| Localização | Coordenadas, com nome e endereço opcionais |
| Contatos | Cartão de contato com nome, telefones, e-mails |
| Interativas (botões e listas) | Veja mensagens interativas |
Duas formas de mandar um arquivo: subir ou apontar um link
A API aceita a mídia de dois jeitos, e a Meta recomenda um deles:
| Forma | Como funciona | Recomendação da Meta |
|---|---|---|
| Subir o arquivo | A plataforma envia o arquivo para a Meta, recebe um identificador e manda a mensagem com ele | Recomendada, pelo desempenho |
| Link hospedado | A mensagem leva o endereço de um arquivo num servidor público, e a Meta busca | Aceita, mas "não recomendada" na documentação |
Com o link, a Meta guarda a mídia em cache por pouco tempo (cerca de 10 minutos); se o arquivo mudar no servidor nesse intervalo, o cliente pode receber a versão anterior. Com o upload, o arquivo fica criptografado e disponível por 30 dias, e pode ser reaproveitado em várias mensagens nesse prazo, sem subir de novo.
Para quem usa uma plataforma de atendimento, isso acontece por trás: você anexa o arquivo na conversa e a plataforma escolhe o caminho. Mas ajuda a entender por que um arquivo "antigo" pode ainda aparecer, ou por que um link quebrado no servidor faz a mensagem falhar.
Localização e contato: os tipos esquecidos
Dois tipos de mensagem resolvem perguntas frequentes sem texto longo:
- Localização: a mensagem leva latitude e longitude, com nome e endereço opcionais. O cliente toca e abre no mapa. Ideal para "onde fica a loja?" e para o endereço de entrega conferido.
- Contato: um cartão com nome, telefones e e-mails, que o cliente salva com um toque. Útil para passar o número do setor financeiro ou do técnico que vai atender.
| Pergunta do cliente | Melhor resposta |
|---|---|
| "Onde vocês ficam?" | Mensagem de localização com o nome da loja |
| "Qual o número do financeiro?" | Cartão de contato |
| "Tem foto do produto?" | Imagem JPEG com legenda e preço |
| "Me manda o orçamento" | PDF com nome claro |
| "Como funciona?" | Vídeo curto de até 16 MB ou link |
Quer ver como fica na prática? Converse com um agente de IA no simulador e veja como ele responde no WhatsApp.
Por quanto tempo a mídia fica disponível
| Situação | Prazo |
|---|---|
| Mídia que você sobe pela API | Criptografada e guardada por 30 dias, a não ser que você apague antes |
| Mídia que chega do cliente (webhook) | Identificador válido por 7 dias |
| Link de download da mídia | Válido por 5 minutos depois de gerado |
Na prática: se a sua empresa precisa guardar o comprovante, a foto do problema ou o documento que o cliente mandou, a plataforma precisa baixar e guardar a mídia, porque ela não fica para sempre na Meta.
Arquivo grande do cliente: o erro 131052
Se o cliente mandar um arquivo acima de 100 MB, a empresa recebe o erro 131052 ("arquivo de mídia muito grande"). A Meta orienta pedir ao cliente um arquivo menor. Uma resposta pronta:
"Seu arquivo ficou grande demais para chegar por aqui (o limite é 100 MB). Pode mandar um vídeo mais curto, em resolução menor, ou um link do Google Drive?"
Mídia em modelos de mensagem
Modelos aprovados também podem levar mídia no cabeçalho: imagem, vídeo ou documento (GIF só na Marketing Messages API), e localização em modelos de utilidade e marketing. O mesmo limite de tamanho do tipo vale. O passo a passo está em como criar modelo de mensagem.
Como deixar o arquivo dentro do limite
- Foto: exporte em JPEG com qualidade em torno de 80% e no máximo 1.600 a 2.000 pixels no lado maior. Fica bem abaixo de 5 MB sem perda visível no celular.
- Vídeo: grave em 720p em vez de 4K, corte o que não importa e exporte em MP4 (H.264). Um minuto em 720p costuma caber nos 16 MB com compressão moderada.
- PDF: use a opção de "reduzir tamanho" ou "otimizar para web" do editor; catálogos com muitas fotos são os que mais estouram.
- Áudio: mensagens curtas de voz ficam pequenas; o limite de 16 MB só pesa em gravações longas.
Erros comuns com arquivos
| Erro | Correção |
|---|---|
| Foto de celular acima de 5 MB | Reduzir a resolução antes de enviar |
| Vídeo gravado em HEVC (H.265) | Converter para H.264 com áudio AAC |
| WebP enviado como imagem | Converter para JPEG ou PNG, ou mandar como figurinha |
| Áudio que deveria ser voz chega como música | Usar OGG com OPUS e marcar como voz |
| Documento sem nome | Informar o nome do arquivo com extensão |
| Mídia do cliente "sumiu" depois de semanas | Baixar e guardar na plataforma logo que chega |
Boas práticas para empresas
- Catálogo em imagem leve: fotos de produto em JPEG, abaixo de 1 MB, carregam rápido no 4G.
- Orçamento em PDF com nome claro e legenda dizendo o que é e até quando vale.
- Vídeo curto: 30 a 60 segundos explicam um produto e cabem nos 16 MB.
- Áudio com moderação: muitos clientes preferem ler; se mandar áudio, mande curto.
- Texto acima de mil caracteres: provavelmente devia ser um PDF ou um link.
Checklist de mídia
| Item | Ok? |
|---|---|
| Imagens em JPEG ou PNG abaixo de 5 MB | |
| Vídeos em MP4 H.264 abaixo de 16 MB | |
| Documentos com nome claro | |
| Legendas abaixo de 1.024 caracteres | |
| Mídia recebida baixada e guardada | |
| Resposta pronta para arquivo grande |
Como a Certu lida com arquivos
Na Certu, o número conectado pela API oficial recebe fotos, documentos e áudios dos clientes no painel, junto da conversa e da ficha no CRM. O agente de IA entende os áudios que os clientes mandam e responde por texto, e a equipe vê tudo no mesmo lugar.
O plano Start custa R$ 299 por mês e o Pro, R$ 599. A gente monta tudo pra você e as primeiras 200 mensagens, em até 7 dias, são por nossa conta. Conecte o número em certu.com.br/aprender.
Fontes
- Meta for Developers: Mídia (tipos e tamanhos aceitos), lida em
- Meta for Developers: Mensagens de áudio e de voz, lida em
- Meta for Developers: Mensagens de imagem, lida em
- Meta for Developers: Mensagens de documento, lida em
- Meta for Developers: Mensagens de vídeo, lida em
- Meta for Developers: Mensagens de texto, lida em
- Meta for Developers: Mensagens de localização, lida em
Leia também
Perguntas frequentes
- Qual o tamanho máximo de imagem na API do WhatsApp?
- 5 MB, em JPEG ou PNG.
- Qual o tamanho máximo de vídeo?
- 16 MB, em MP4 ou 3GP, com vídeo H.264 e áudio AAC.
- Dá para mandar PDF pela API?
- Sim, até 100 MB, com nome do arquivo e legenda opcionais.
- Como mandar áudio como mensagem de voz?
- Use OGG com codec OPUS e marque como voz. Outros formatos chegam como áudio comum.
- Qual o limite de caracteres de uma mensagem?
- 4.096 no texto. Legenda de imagem, vídeo ou documento: 1.024.
- O cliente mandou um vídeo e deu erro. Por quê?
- Se passou de 100 MB, a API devolve o erro 131052. Peça um arquivo menor ou um link.
Continue lendo
Em resumo
Formatos e tamanhos aceitos pela API do WhatsApp: imagem, vídeo, áudio, voz, documento e figurinha, limites de texto e legenda e o erro de arquivo grande.
Sobre a Certu: a Certu é a plataforma brasileira de IA que atende o WhatsApp, o Instagram e o Messenger de pequenas e médias empresas 24 horas por dia, com CRM incluído, e é Tech Provider da Plataforma WhatsApp Business da Meta. Os planos começam em R$ 2.964 por ano, sem fidelidade. Conectar meu WhatsApp
