A janela de 24 horas do WhatsApp: o que abre, o que fecha e o que ninguém te avisa

O que abre a janela — e aqui o mercado está desatualizado

Todo artigo sobre o assunto diz a mesma coisa: a janela abre quando o cliente manda mensagem, e reinicia a cada nova mensagem dele.

Está certo, e está incompleto. A documentação atual da Meta diz: *"When a WhatsApp user messages you or calls you, a 24-hour timer called a customer service window starts. If the user messages or calls you again before the timer expires, the timer resets to 24 hours."*

Chamada recebida abre e reinicia a janela. Os artigos brasileiros que ranqueiam para essa busca foram escritos antes de a Meta liberar chamadas na API, e nenhum deles menciona isso.

Na prática muda o seguinte: se o seu cliente te liga e não completa a conversa, você tem 24 horas para retomar por mensagem, sem modelo e sem custo de marketing. Quem opera atendimento por telefone e por WhatsApp ao mesmo tempo estava deixando essa janela passar sem saber que ela existia.

Fora da janela, e o erro exato que você vai ver

Passadas as 24 horas, só sai modelo aprovado previamente. Se o seu sistema tentar mandar mensagem comum, a API devolve:

131047 — Message outside 24-hour window

*"More than 24 hours have passed since the recipient last replied to the sender number."*

Vale decorar o vizinho dele, porque a confusão entre os dois faz gente diagnosticar errado: o 131049 não é janela. Ele é o limite por usuário de mensagens de marketing, e falha na entrega, não na chamada. Se você recebeu 131049, o problema não é o horário, é que a Meta decidiu não entregar aquele marketing para aquela pessoa.

A janela não é só permissão. É preço.

Essa é a parte que muda a conta e quase ninguém escreve.

Desde que a Meta passou a cobrar por mensagem, a janela virou também uma regra de custo:

Mensagem comum dentro da janela: gratuita.

Modelo de utilidade dentro da janela: gratuito. A Meta é explícita — *"Utility template messages sent within an open customer service window are free"* — e a mensagem chega no webhook marcada como free_customer_service, com billable = false.

Modelo de utilidade fora da janela: cobrado.

Marketing e autenticação: cobrados sempre, com a janela aberta ou fechada.

A consequência é direta: responder rápido deixou de ser boa prática e virou economia. Confirmação de pedido, aviso de entrega e lembrete de agendamento saem de graça se a conversa estiver aberta, e viram custo se você demorar.

Ninguém avisa que a janela vai fechar

Procurei um aviso e ele não existe.

Não há nenhum webhook de expiração de janela na lista da Cloud API. Existem avisos de conta, de qualidade de número, de modelo — nenhum de janela. O único sinal que a Meta já ofereceu foi um campo com o horário de expiração, presente apenas no status de mensagem enviada. E a partir da versão 24 da API da Meta esse objeto está sendo removido.

Ou seja: o relógio corre e você não vê. Quem descobre pela mensagem de erro descobre tarde, porque a essa altura a resposta já não sai.

Isso não é falha da sua ferramenta. É como a plataforma funciona. Quem quer enxergar prazo precisa contar as 24 horas por conta própria, a partir da última mensagem ou chamada do cliente, e mostrar isso na tela de quem atende.

No Instagram e no Messenger é diferente

Se você atende nos três canais, tratar tudo como "a janela de 24 horas" vai te dar problema. São três regimes.

A duração é 24 horas nos três. Só isso é igual.

O que abre a janela é mais amplo no Messenger e no Instagram: além de mensagem, abre por clique em botão de chamada para ação, por anúncio de clique para Messenger, por link com referência, e até por reação a uma mensagem. Uma pessoa que só reagiu com um emoji abriu janela ali, e não teria aberto no WhatsApp.

A saída é o ponto crítico. No WhatsApp, fechada a janela, você paga um modelo e fala. No Messenger e no Instagram não existe modelo pago equivalente para atendimento — existem etiquetas de exceção para casos específicos, e fora delas a conversa simplesmente acabou.

Traduzindo: no WhatsApp perder a janela custa dinheiro. No Instagram e no Messenger, perder a janela custa o cliente.

A janela de 72 horas do anúncio é outra coisa

Quem anuncia clique para o WhatsApp ouve falar de uma janela gratuita de 72 horas e junta as duas na cabeça. São independentes, e a Meta diz isso: *"the customer service window is independent of the FEP window, so if the customer service window closes, you will only be able to send template messages."*

A janela de 72 horas define custo: nada é cobrado nesse período.

A janela de 24 horas define permissão: o que você pode enviar.

Dá para estar dentro das 72 horas gratuitas e fora das 24 horas de permissão ao mesmo tempo. Nesse caso você continua sem poder mandar mensagem comum — só que o modelo que você mandar não será cobrado.

Perguntas frequentes