Use este guia quando texto simples envia normalmente, mas imagens, vídeos, documentos, áudios, stickers ou arquivos falham.

## Causas mais comuns

- Arquivo acima do limite aceito pelo canal.
- Formato, codec ou extensão não suportados.
- URL privada, expirada, bloqueada por login ou inacessível pelo provedor.
- Content-type incorreto no arquivo hospedado.
- Nome de arquivo com caracteres especiais que o canal rejeita.
- Mídia enviada dentro de template com parâmetro incompatível.
- Canal ou provedor recusando aquele tipo de mensagem.

## Teste de isolamento

1. Envie uma mensagem de texto simples para o mesmo contato.
2. Se texto falhar, o problema não é a mídia; volte ao diagnóstico geral.
3. Se texto funcionar, envie uma imagem pequena em formato comum.
4. Se a imagem pequena funcionar, o problema está no arquivo original.
5. Se qualquer mídia falhar, teste outro contato e outro canal.
6. Se a mídia vem de automação/API, envie manualmente o mesmo arquivo pela conversa.

## Como resolver por sintoma

| Sintoma | Provável causa | Correção |
|---|---|---|
| Só um arquivo falha | Tamanho, formato, codec ou nome do arquivo. | Converta, reduza tamanho e renomeie o arquivo. |
| Toda mídia falha no WhatsApp | Canal/provedor recusando upload ou download. | Teste arquivo simples e colete código 131052/131053, se aparecer. |
| Link de mídia falha | URL privada, expirada ou sem content-type correto. | Use URL pública, estável e acessível sem login. |
| Template com mídia falha | Variável de mídia incompatível ou template mal preenchido. | Confira tipo do cabeçalho e parâmetros do template. |
| Vídeo falha, imagem funciona | Codec, duração, tamanho ou formato do vídeo. | Exporte em formato mais comum e menor. |
| Documento falha | Arquivo grande, extensão bloqueada ou política do canal. | Envie link seguro ou converta para formato aceito. |

## Códigos comuns de mídia no WhatsApp

| Código | Leitura prática | Ação |
|---|---|---|
| 131052 | O canal não conseguiu baixar a mídia. | Verifique se a URL é pública, estável e não expira rápido. |
| 131053 | O canal recusou upload, formato ou processamento. | Reduza tamanho, troque formato e valide o tipo do arquivo. |
| 131051 | Tipo de mensagem não suportado. | Use texto, imagem comum ou link como fallback. |
| 63005 ou 63021 | Conteúdo recusado pelo provedor/canal. | Ajuste arquivo, payload ou componente de mídia. |

## Antes de pedir ajuda

- Envie o arquivo original ou um link de download.
- Informe canal, caixa de entrada, contato e horário da tentativa.
- Diga se texto simples funciona para o mesmo contato.
- Diga se outro arquivo pequeno funciona.
- Inclua print do erro ou código retornado.