Tempo de vida da mensagem no WhatsApp: evite que códigos, lembretes e avisos de entrega cheguem atrasados

Um cliente pede o código de acesso do app de banco enquanto embarca em um voo em Guarulhos. O celular entra no modo avião e, quatro horas depois, ao pousar, o WhatsApp entrega um código que venceu após dez minutos. Outro cliente recebe à noite “seu entregador chega em 20 minutos” por um pedido que a vizinha pegou ao meio-dia. E o “sua consulta começa em uma hora” de uma clínica chega só na manhã seguinte.

Nenhuma dessas mensagens está errada quando é enviada. Ela está errada quando chega. O WhatsApp continua tentando entregar uma mensagem a um celular desligado ou sem conexão e, na maioria dos modelos, tenta por até 30 dias. O tempo de vida da mensagem (TTL) é a configuração que diz ao WhatsApp quando parar.

Desde a versão 3.8.46, o criador de modelos do MonoChat permite definir o tempo de vida em modelos de Utilidade e de Autenticação, como já era possível nos de Marketing. Este guia explica como o tempo de vida funciona, os padrões e limites de cada categoria, que valor combina com cada mensagem e como configurar.

Como o WhatsApp tenta entregar uma mensagem

Quando você envia um modelo de mensagem, o WhatsApp primeiro tenta entregá-lo ao celular do cliente. Se o aparelho está desligado, sem conexão ou ficou fora do ar por um tempo, a mensagem espera do lado do WhatsApp, que tenta de novo. A Meta chama a duração desse período de tentativas de tempo de vida da mensagem.

Duas coisas acontecem quando o tempo de vida acaba:

• A mensagem é descartada. A documentação da Meta diz que o sistema descarta as mensagens que não puderam ser entregues dentro do tempo de vida padrão ou personalizado. O cliente nunca a vê.
• Você não recebe o status de entregue. A orientação da Meta é simples: se nenhum webhook de entrega chegou antes do fim do tempo de vida, presuma que a mensagem foi descartada.

O período padrão de tentativas é longo porque a maioria das mensagens continua útil dias depois: um comprovante, um extrato, uma newsletter. As mensagens de que este guia trata são justamente as que não continuam.

Padrões e limites por categoria

A Meta define o tempo de vida por modelo, e o intervalo permitido depende da categoria do modelo:

Categoria	Padrão	Intervalo que você pode definir	No MonoChat (segundos)
Autenticação	10 minutos (30 dias para modelos criados antes de 23 out. 2024)	30 segundos a 15 minutos	30 a 900
Utilidade	30 dias	30 segundos a 12 horas	30 a 43200
Marketing	30 dias	12 horas a 30 dias	43200 a 2592000, em uma conta integrada à API de Mensagens de Marketing

Três detalhes passam despercebidos com facilidade:

• Modelos de autenticação antigos mantêm 30 dias. Se o seu modelo de verificação foi criado antes de 23 de outubro de 2024 e você nunca definiu um tempo de vida, um código ainda pode chegar semanas depois. Definir um valor resolve.
• Utilidade não tem uma janela curta por padrão. Um aviso de entrega sem tempo de vida definido é tentado por 30 dias, o mesmo que uma newsletter.
• A mudança de categoria apaga o valor. Quando a Meta move um modelo para outra categoria, ela apaga o tempo de vida, e o modelo volta ao padrão da nova categoria até que você defina um novo valor dentro do intervalo dela.

Que valor combina com cada mensagem

Defina o tempo de vida como o momento em que a mensagem deixa de ser verdadeira ou útil, e não como o momento em que você gostaria que o cliente a lesse. Alguns pontos de partida:

Mensagem	Categoria	Tempo de vida sugerido	Por quê
Código de acesso ou de verificação válido por 10 minutos	Autenticação	600 segundos ou menos	A Meta recomenda um tempo de vida igual ou menor que a validade do código
Código de confirmação de pagamento válido por 5 minutos	Autenticação	300 segundos	Um código que chega depois de vencido só gera chamado no suporte
”Seu entregador chega em cerca de 30 minutos”	Utilidade	1800 segundos	Depois disso, o entregador já passou ou já foi embora
”Sua mesa está pronta” ou “seu pedido está pronto para retirada”	Utilidade	1800 a 3600 segundos	Só serve enquanto o cliente está por perto
Lembrete de consulta enviado 3 horas antes	Utilidade	10800 segundos	Descartá-lo depois do horário da consulta evita uma mensagem confusa
Confirmação de janela de entrega no mesmo dia	Utilidade	21600 a 43200 segundos	A janela já passou no fim da tarde
Confirmação de pedido, comprovante, nota fiscal	Utilidade	Deixe em branco	Continua útil dias depois
Uma promoção relâmpago de 48 horas	Marketing	172800 segundos	A oferta acaba quando a promoção acaba

Duas regras práticas:

• Deixe em branco quando atrasar não faz mal. Um comprovante que chega amanhã é melhor do que nenhum. Não defina um tempo de vida curto em mensagens que precisam chegar sempre.
• Planeje uma alternativa quando atrasar é pior do que não chegar. Um código descartado deve levar a um “reenviar código” no seu app; um “entregador por perto” descartado pode virar uma ligação do entregador. Decida isso antes de encurtar o tempo de vida.

Como definir no MonoChat

Você precisa de um número de WhatsApp conectado como canal WhatsApp Business (Cloud).

1. Abra os modelos. Vá em Configurações › Chat › Canais, abra o menu ⋮ do canal e escolha Mensagens de modelo.

2. Crie o modelo. Clique em Criar e escolha a categoria: Utilidade para avisos, Autenticação para códigos. Para um código, escolha o tipo Senha de uso único; para um aviso, Padrão, ou Da biblioteca da Meta para partir de um dos modelos de utilidade prontos da Meta (veja nosso guia da biblioteca de modelos).

3. Informe o tempo de vida. Abaixo do nome e do idioma, preencha Tempo de vida da mensagem (segundos). O MonoChat confere o intervalo enquanto você digita e mostra “Insira um valor entre 30 e 43200 segundos” para Utilidade, ou “entre 30 e 900 segundos” para Autenticação, quando o número está fora dele. Deixe em branco para manter o padrão do WhatsApp.

4. Nos códigos, combine com a validade. Em um modelo de Senha de uso único, Validade do código (minutos, 1–90) aceita de 1 a 90 minutos. Defina o tempo de vida com a mesma duração ou menor. Um código válido por 10 minutos com tempo de vida de 600 segundos nunca chega depois de deixar de funcionar.

5. Envie. Termine a mensagem, os botões e os exemplos como de costume (nosso guia para criar um modelo no WhatsApp percorre cada campo) e envie para análise. O tempo de vida acompanha o modelo: toda mensagem enviada a partir dele, pelo chat, por um fluxo, por um envio em massa ou pelo seu próprio sistema, usa o mesmo valor.

Modelos de marketing mostram o mesmo campo somente quando a sua conta do WhatsApp Business está integrada à API de Mensagens de Marketing da Meta, o que o MonoChat detecta sozinho. O intervalo ali é de 43200 a 2592000 segundos.

Um exemplo: as mensagens do dia de uma clínica odontológica

Uma clínica odontológica em Belo Horizonte envia três tipos de mensagem pelo WhatsApp a partir de um fluxo do MonoChat ligado à agenda de consultas:

• Confirmação de agendamento (Utilidade, sem tempo de vida). Continua útil se o paciente a ler no dia seguinte.
• Lembrete três horas antes (Utilidade, 10800 segundos). Se o celular do paciente ficar desligado a manhã toda, o lembrete é descartado quando a consulta começa, em vez de chegar depois dela.
• “A doutora está com 20 minutos de atraso” (Utilidade, 1200 segundos). Só é verdade pelos próximos vinte minutos.

O fluxo envia cada uma com o nó Enviar mensagem de modelo. Quando um paciente responde “dá para remarcar para as 17h?”, a resposta abre a janela de atendimento ao cliente de 24 horas e cai na caixa de entrada da equipe, onde a recepcionista responde com texto livre.

A confirmação poderia dividir o modelo com o lembrete se a clínica não ligasse para o horário. Como o tempo de vida é definido por modelo, mensagens que precisam de durações diferentes precisam de modelos separados.

Quanto custa

A Meta cobra por mensagem entregue, pela tarifa da categoria do modelo e do país do destinatário. A página de preços dela diz que as empresas só são cobradas quando a mensagem é entregue, então uma mensagem descartada ao fim do tempo de vida não é cobrada. Encurtar o tempo de vida, portanto, nunca custa mais; no máximo economiza a cobrança de uma mensagem que chegaria tarde demais para ajudar. A Meta cobra diretamente a sua empresa, e o MonoChat, um Meta Business Partner oficial, não acrescenta margem. Estime uma campanha com a calculadora de envio em massa.

Checklist

• Liste todo modelo cuja mensagem deixa de ser verdadeira depois de um tempo: códigos, “a caminho”, “pronto”, lembretes do mesmo dia, promoções relâmpago
• Modelos de autenticação: tempo de vida igual ou menor que a Validade do código
• Modelos de autenticação criados antes de 23 out. 2024: defina um valor, ou eles mantêm 30 dias
• Avisos de utilidade ligados a um horário: um tempo de vida que termina quando o aviso deixa de ser verdadeiro
• Comprovantes, confirmações e notas fiscais: deixe em branco
• Modelos separados para mensagens que precisam de durações diferentes
• Uma alternativa para mensagens descartadas: reenviar no app, uma ligação, uma nova mensagem quando o cliente escrever
• Depois que a Meta recategorizar um modelo: defina o tempo de vida de novo

Fontes

• Meta for Developers: Configure message time-to-live (tentativas, padrões e intervalos por categoria, mensagens descartadas, webhook de entrega, recomendação para autenticação, recategorização; acessado em 6 de novembro de 2026)
• Meta for Developers: Pricing on the WhatsApp Business Platform (“Businesses are only charged when a message is delivered”; acessado em 6 de novembro de 2026)
• Central de ajuda do MonoChat: Mensagens de modelo (campo Tempo de vida da mensagem e intervalos, validade do código da Senha de uso único, API de Mensagens de Marketing; acessado em 6 de novembro de 2026)
• Changelog do MonoChat 3.8.46 (tempo de vida para modelos de Utilidade e de Autenticação; acessado em 6 de novembro de 2026)