Pular para o conteúdo principal

Editando mensagem enviada

Resumo: Você pode editar o texto de uma mensagem até 15 minutos depois de tê-la enviado. Após isso, o WhatsApp bloqueia a edição. O cliente vê a tag "editada" ao lado do horário.

Quando usar isso

Quando você percebeu um erro logo após enviar — um número trocado, uma palavra escrita errada, um link quebrado — e quer corrigir sem precisar apagar e reenviar (o que polui a conversa e pode confundir o cliente).

Regras importantes

⚠️ Atenção: O limite de 15 minutos é uma regra do próprio WhatsApp, não do gateway. Após esse prazo, qualquer tentativa de editar é rejeitada — você só pode apagar e reenviar.

  • Só edita texto. Imagens, vídeos, áudios e documentos não podem ser editados — você teria que apagar e reenviar com a mídia corrigida.
  • Funciona no Baileys e WABA. Não disponível no Instagram.
  • Tamanho: o texto novo pode ter até 4096 caracteres (mesmo limite de mensagem normal).
  • Não tem como editar legenda de mídia — também precisa apagar e reenviar.

Como funciona

A edição é uma operação separada do envio. Tecnicamente, o gateway recebe o ID da mensagem original e o novo texto, e dispara a edição para o WhatsApp/WABA.

Passo a passo (interface típica)

  1. Localize a mensagem na conversa (que você enviou).
  2. Pressione e segure (mobile) ou clique no menu ao lado dela.
  3. Selecione Editar.
  4. Altere o texto.
  5. Confirme.

A mensagem original é substituída pela nova. Para o cliente, aparece o texto atualizado com uma tag pequena "Editada" ao lado do horário.

O que o cliente vê

  • A mensagem aparece com o novo texto (a versão antiga é descartada).
  • Ao lado do horário, aparece "Editada".
  • Se o cliente apertar e segurar a mensagem, em alguns clientes WhatsApp aparece um histórico das versões anteriores (não em todos).

Mensagens de erro comuns

ErroSignificadoO que fazer
MESSAGE_KEY_NOT_FOUNDA mensagem é muito antiga (>7 dias no cache) ou nunca foi enviada por este canalNão dá para editar; apague e reenvie se ainda for relevante
EDIT_WINDOW_EXPIRED (ou erro genérico)Já passou de 15 min do envioNão dá para editar; apague e reenvie
PHONE_NOT_CONNECTEDO canal está desconectadoReconecte o canal e tente novamente

Dúvidas comuns

Editei e o cliente disse que continua vendo o texto antigo. Pode acontecer em alguns casos: cliente com WhatsApp desatualizado, sem conexão no momento, ou ainda não abriu o app desde a edição. A versão correta vai aparecer assim que ele atualizar a conversa.

Posso editar mensagem que enviei pelo celular (e não pelo gateway)? Sim, mas só pelo próprio celular — o gateway não tem o ID dela em cache se foi enviada por outro aparelho.

Editar custa dinheiro? No Baileys, não. No WABA, conta como mensagem service (custo Meta). Veja Como funciona a cobrança.

E se eu editar várias vezes seguidas? A última edição prevalece. Não há limite explícito de quantas vezes — só o limite de 15 minutos total.

O cliente vê o histórico das edições? Em clientes WhatsApp mais novos, sim — ele pode tocar e segurar para ver as versões anteriores. Não é garantido em todos.

Artigos relacionados