Como enviar um arquivo HTML pelo WhatsApp, e por que ele chega quebrado

O WhatsApp aceita o arquivo .html como documento e entrega sem erro. O problema aparece depois: ao tocar no anexo, o aplicativo repassa o arquivo ao sistema do celular, e o sistema decide o que fazer com ele. Como .html é classificado como arquivo de texto, o resultado costuma ser código na tela ou uma escolha de aplicativo que o destinatário não sabe fazer.

No Brasil isso importa mais que em outros mercados. O WhatsApp é o canal padrão de negociação com cliente: a proposta, o orçamento e o relatório passam por lá antes de passar pelo e-mail. Um formato que não abre no WhatsApp é um formato que não circula.

O WhatsApp aceita arquivos .html?

Sim, como documento. Você anexa pelo botão de anexo, opção Documento, e o arquivo é enviado normalmente. O limite publicado pelo WhatsApp é de 2 GB por documento, e um HTML de proposta ou relatório fica entre 50 KB e 3 MB. Tamanho nunca vai ser o seu problema.

O que não está documentado: o WhatsApp publica lista de formatos suportados apenas para vídeo. Não existe, na documentação oficial, nenhuma lista de tipos de documento aceitos nem qualquer descrição do que acontece ao abri-los. Quem afirma o contrário está reproduzindo suposição.

Por que quem recebe não consegue abrir?

Porque o WhatsApp não renderiza o arquivo. Ele o entrega ao sistema operacional, e a partir daí depende de existir um aplicativo capaz de lidar com aquele tipo.

A própria documentação do WhatsApp descreve esse modelo usando PDF como exemplo: se você não tem um leitor de PDF instalado, não vai conseguir abrir um PDF baixado.

A diferença é que praticamente todo celular já vem com leitor de PDF, e nenhum vem com "abridor de arquivo HTML" configurado como padrão. O navegador sabe renderizar HTML, mas não costuma se registrar como o aplicativo padrão para abrir um arquivo local com essa extensão.

O resultado prático, relatado com frequência por quem envia: o cliente toca no anexo e vê o código, ou recebe uma lista de aplicativos e desiste na primeira tela.

O que o Android e o iPhone fazem com um .html

Aqui é importante separar o que está documentado do que é folclore.

Android. A documentação do Google descreve o mecanismo: ao abrir um arquivo, o sistema procura um aplicativo que tenha se registrado para aquele tipo de conteúdo, e avisa explicitamente que o desenvolvedor precisa se preparar para o caso em que nenhuma atividade consegue lidar com a solicitação. O que o Google não documenta é o resultado final para um .html baixado.

iPhone. A Apple documenta duas coisas que, juntas, sugerem o comportamento sem confirmá-lo. Primeiro, que HTML é um tipo que conforma a public.text, ou seja, o sistema o classifica como arquivo de texto. Segundo, que o Quick Look pré-visualiza arquivos que conformam a public.text. A Apple não documenta se o Quick Look renderiza a página ou mostra o código.

Conclusão honesta: o comportamento em celular não está documentado por nenhum dos dois fabricantes. O que está documentado é a classificação, e ela põe HTML na categoria "texto", não na categoria "página web".

Compactar em .zip antes de enviar resolve?

Não. Piora.

CaminhoPassos para o clienteChance de dar certo
Enviar o .html diretoTocar no anexo, escolher appBaixa
Enviar em .zipBaixar, descompactar, achar o arquivo, escolher appMenor ainda
Converter em PDFTocar no anexoAlta
Enviar um linkTocar no linkAlta

Compactar acrescenta dois passos técnicos a um destinatário que já travou no primeiro. E muitos celulares não descompactam sem um aplicativo extra instalado.

O caminho que funciona: mandar um link, não um arquivo

Um link no WhatsApp abre no navegador. O navegador é o único programa que sabe renderizar HTML. É isso, o resto é consequência.

Publicar o HTML como página e enviar o endereço resolve o problema na origem, e traz três coisas que o anexo não tem.

Pré-visualização no próprio chat. Se a página tem as meta tags de Open Graph corretas, o WhatsApp mostra título, descrição e imagem antes de o cliente clicar. Um anexo .html aparece como ícone genérico de arquivo, e a diferença de percepção entre as duas coisas é grande na tela de conversa.

Correção depois do envio. Achou um erro de preço na proposta? Você corrige a página, o link continua o mesmo, e o cliente vê a versão certa. Com anexo, você precisa mandar "desconsidere o anterior", que é a mensagem mais cara de uma negociação. Na I LOVE HTML cada edição arquiva a anterior, e são 25 versões guardadas por documento.

Sinal de leitura. Você consegue saber que a página foi aberta, quando e por quanto tempo. Com anexo, o silêncio é ambíguo.

Plataformas que fazem isso: I LOVE HTML, Tiiny Host, Static.app e HTMLy, entre outras. Para quem já usa Git, GitHub Pages, Netlify e Cloudflare Pages fazem o mesmo de graça, com mais passos até o primeiro link. O que muda de uma para outra está em onde hospedar HTML de graça.

Como publicar o arquivo e configurar o link está em proposta comercial em HTML com IA, e o passo a passo do envio em como subir um arquivo.

Quando o anexo ainda é a resposta certa

Se o cliente precisa guardar o documento, para anexar a um processo, arquivar no contábil ou assinar, mande PDF. Link serve para ser lido, arquivo serve para ser guardado.

E se o conteúdo é confidencial, lembre que um link sem senha é público para qualquer um que o receba, e link no WhatsApp é encaminhado com um toque. Senha resolve o acesso casual e não substitui controle corporativo de acesso: as ressalvas estão em quando não usar a plataforma.

O que não conseguimos verificar

  • O comportamento real ao abrir um .html recebido pelo WhatsApp no Android e no iOS. Não há documentação oficial. O que está escrito acima descreve o mecanismo documentado, não um resultado testado.
  • Se o WhatsApp Web se comporta de forma diferente do aplicativo no celular.
  • Se há diferença entre WhatsApp e WhatsApp Business.

Perguntas frequentes

Dá para o cliente abrir o .html direto no WhatsApp, sem baixar?

Não. O WhatsApp não tem visualizador de HTML embutido. Ele entrega o arquivo ao sistema, e o sistema abre em outro aplicativo, quando encontra algum.

E se eu mandar o arquivo por e-mail em vez do WhatsApp?

Muda o problema, não o resolve. Em empresas que usam Microsoft 365, o Outlook na web trata .htm e .html como tipos que só podem ser salvos, não abertos, e isso é o valor padrão da política documentada pela Microsoft. O detalhe está em por que o cliente não consegue abrir o HTML.

O WhatsApp bloqueia arquivos HTML por segurança?

Não há nada na documentação do WhatsApp indicando bloqueio de .html. O arquivo é entregue. A dificuldade está em abri-lo, não em enviá-lo.

Qual o tamanho máximo?

2 GB por documento, conforme a documentação do WhatsApp. Um HTML de proposta ou relatório fica muito abaixo disso.

O link fica com aparência de spam no WhatsApp?

Depende de duas coisas: o endereço e a pré-visualização. Endereço personalizado com o nome do cliente ou do projeto passa muito melhor que um código aleatório, e uma página com Open Graph configurado aparece com título e descrição em vez de link cru. Mandar o link com uma frase dizendo o que a pessoa vai encontrar resolve o resto.


Fontes: WhatsApp Help Center, como enviar mídia, contatos ou localização, WhatsApp Help Center, problemas para baixar ou abrir arquivos, Android Developers, sending the user to another app, Apple Developer, UTType.html e Microsoft Learn, Set-OwaMailboxPolicy. Este artigo trata de política de produto de terceiro e é revisado a cada seis meses.

← Voltar ao blog