WhatsApp Business API

Como funciona a janela de 24 horas do WhatsApp Business (e o que fazer fora dela)

Como funciona a janela de 24 horas do WhatsApp Business (e o que fazer fora dela)
Como enviar mensagem de template no WhatsApp Business API na prática

A janela de 24 horas do WhatsApp Business funciona assim: sempre que um cliente te manda uma mensagem, abre um período de 24 horas em que sua empresa pode responder com o que quiser, texto, imagem, botão, áudio, sem precisar de aprovação prévia. Passou esse prazo sem o cliente escrever de novo? A janela fecha, e a partir dali você só consegue iniciar uma conversa usando um template aprovado pela Meta.

Essa é a regra que mais confunde quem está começando na API oficial, e também a que mais gera aquele susto do tipo "por que minha mensagem não saiu?". Vou explicar o mecanismo por dentro, com os casos que aparecem no nosso suporte quase toda semana.

O gatilho é sempre o cliente

Quem abre a janela é o cliente, nunca a empresa. Isso é o coração da regra. A cada mensagem que a pessoa envia para o seu número, o relógio de 24 horas reinicia a partir daquele momento. Se o cliente escreve às 10h, você tem até às 10h do dia seguinte para conversar livremente. Se ele responde de novo às 15h, a janela se estende até as 15h do dia seguinte.

Dentro desse período você troca mensagens sem restrição de formato e sem custo de template. É a chamada conversa de serviço, ou atendimento. É onde acontece a maior parte do suporte, tira-dúvidas e negociação.

Fora da janela, a lógica inverte. Você não pode simplesmente disparar um "oi, tudo bem?". Para reabrir a conversa por iniciativa da empresa, o único caminho é o template aprovado.

O que muda quando a janela fecha

Fechou a janela, três coisas passam a valer:

  • Mensagens de texto livre para aquele contato são recusadas pela API. Você recebe um erro em vez do envio.
  • Para reabrir o contato, precisa de um template já aprovado, nas categorias marketing, utilidade ou autenticação.
  • Quando o cliente responde ao seu template, uma nova janela de 24 horas abre, e você volta a conversar livremente.

Na prática, o template é o "toque na campainha". Ele reabre a porta. O que acontece depois, dentro das 24 horas, é conversa normal.

Segundo a covercut, BSP oficial do WhatsApp, o erro mais comum que recebemos de clientes iniciantes é justamente tentar mandar texto simples para quem não escreve há dias. A API bloqueia, e a pessoa acha que o número está com problema. Não está: a janela apenas fechou.

Por que a Meta criou essa regra

A janela existe para proteger a experiência de quem recebe. Sem ela, qualquer empresa poderia bombardear números o dia inteiro. Ao amarrar a conversa livre à iniciativa do usuário, a Meta garante que o cliente sempre deu o primeiro passo, ou pelo menos consentiu em ser contatado por template.

É por isso que o opt-in importa tanto. Para disparar template fora da janela, você precisa do consentimento do cliente para receber mensagens ativas. Não é burocracia decorativa: número que dispara para quem não pediu tende a receber bloqueios e reclamações, e isso derruba a qualidade dele.

Templates: o que são e por que precisam de aprovação

Template é um modelo de mensagem que você submete à Meta antes de usar. Confira aqui sobre templates. Ele passa por revisão e só depois de aprovado pode ser enviado. As categorias hoje são três:

  • Utilidade (utility): mensagens transacionais ligadas a algo que o cliente já fez ou espera, como confirmação de pedido, aviso de entrega, lembrete de agendamento.
  • Marketing: promoções, novidades, reativação de base, qualquer coisa com intenção comercial.
  • Autenticação: códigos de verificação e login.

Quando um cliente nos procura com o template rejeitado, quase sempre é por um destes motivos: categoria errada (um texto de venda cadastrado como utilidade), variável mal formatada, ou conteúdo que parece spam. Escolher a categoria certa não é detalhe. A Meta reprova rápido quando percebe marketing disfarçado de utilidade.

Exemplo prático da diferença

Imagine uma clínica. O paciente marca consulta pelo site e recebe, no dia anterior, um lembrete no WhatsApp. Como faz dias que ele não escreve para a clínica, a janela está fechada. Esse lembrete precisa ser um template de utilidade aprovado.

O paciente lê e responde "posso remarcar?". Nesse instante, abre a janela de 24 horas. A recepcionista agora conversa à vontade, oferece horários, confirma tudo, sem template nenhum. Foi o paciente quem reabriu a porta.

Como a janela afeta a operação de atendimento

Se você usa uma ferramenta de atendimento integrada à API, como o Chatwoot, é comum a interface avisar quando a janela está prestes a fechar ou já fechou. Isso ajuda o agente a saber se ainda dá para mandar texto livre ou se vai precisar disparar um template.

Vale lembrar que a API oficial não tem um app de conversa próprio. Tudo passa por integração. Então a lógica da janela vive dentro da sua plataforma, não num aplicativo de celular. Se você está em coexistência, usando o app WhatsApp Business no telefone junto com a API no mesmo número, as mensagens que chegam pelo app também contam: quando o cliente escreve, a janela abre para os dois lados da operação.

Erros que a gente vê o tempo todo

Alguns tropeços aparecem com frequência e valem o alerta:

  • Achar que 24 horas conta a partir da sua última mensagem. Não conta. Conta a partir da última mensagem do cliente. Você pode ter respondido há minutos, mas se o cliente escreveu há 25 horas, a janela já fechou.
  • Deixar templates só de marketing prontos. Muita empresa cadastra apenas templates promocionais e trava quando precisa de um aviso transacional urgente. Tenha templates de utilidade aprovados antes de precisar deles, porque a aprovação leva um tempo.
  • Disparar template para base fria sem opt-in. Isso gera bloqueios e reclamações, e a qualidade do número cai. Qualidade baixa reduz limites e pode restringir o envio.
  • Confundir custo. A conversa livre dentro da janela de atendimento e a conversa iniciada por template têm tratamentos diferentes na cobrança da Meta. A Meta cobra por conversa, não por mensagem individual, e o modelo muda com o tempo.

E quem paga por tudo isso?

Um ponto que gera confusão: as conversas são cobradas pela Meta direto do cliente. Você cadastra seu cartão na conta da Meta e é lá que a cobrança por conversa acontece. A covercut não cobra por mensagem, por conversa nem por template. Nossa mensalidade é fixa e cobre plataforma, conexão do número pelo fluxo oficial da Meta com suporte a coexistência, infraestrutura e suporte. A cobrança das mensagens fica sempre entre você e a Meta.

Saber disso muda o planejamento. Como a Meta cobra por conversa iniciada, faz sentido concentrar o atendimento dentro da janela de 24 horas sempre que possível, e usar template quando realmente precisa reabrir o contato. Não é sobre economizar de qualquer jeito, é sobre não disparar template à toa.

Um roteiro simples para não errar

Se você está montando sua operação agora, pense assim: primeiro, garanta opt-in de quem vai receber mensagem ativa. Depois, deixe aprovados os templates de utilidade e autenticação que sua rotina exige, e só então os de marketing. No dia a dia, treine o time para reconhecer se a janela está aberta antes de responder. E monitore a qualidade do número, porque ela dita seus limites de envio.

Quando essa lógica entra na cabeça da equipe, a operação flui. A janela deixa de ser um obstáculo e vira o ritmo natural da conversa: o cliente puxa, você responde, e o template só entra quando faz sentido reabrir o assunto.

Perguntas frequentes

A janela de 24 horas reinicia toda vez que o cliente responde?

Sim. Cada mensagem enviada pelo cliente reinicia a contagem de 24 horas a partir daquele momento. Se ele responde várias vezes ao longo do dia, a janela vai se estendendo. Ela só fecha quando passam 24 horas sem nenhuma mensagem nova do cliente.

Posso mandar qualquer mensagem dentro da janela de 24 horas?

Dentro da janela você envia mensagens de formato livre, texto, imagem, áudio, documento, botões, sem precisar de template aprovado. Continua valendo o bom senso e as políticas da Meta, mas não há restrição de modelo prévio como acontece fora da janela.

O que acontece se eu tentar mandar texto livre com a janela fechada?

A API oficial recusa o envio e retorna um erro. Para contatar esse cliente fora da janela, você precisa usar um template já aprovado. Quando ele responder ao template, abre uma nova janela de 24 horas e você volta a conversar livremente.

Template também vale para responder o cliente?

Não precisa. Template é para iniciar conversa ou reabrir contato fora da janela. Se o cliente escreveu recentemente e a janela está aberta, você responde com mensagem normal, sem template. O template só é obrigatório quando a empresa toma a iniciativa fora das 24 horas.

Na coexistência, mensagens recebidas pelo app abrem a janela?

Sim. No modo de coexistência, o mesmo número usa o app WhatsApp Business no celular e a API ao mesmo tempo. Quando o cliente envia mensagem, a janela de 24 horas passa a valer para a operação, independentemente de a conversa ter chegado pelo app ou pela integração.

Pronto para usar a API oficial do WhatsApp?

A covercut é BSP oficial da Meta. Conecte seu número e comece a enviar em minutos.

Ver planos

Receba as novidades por e-mail

Sempre que publicarmos algo novo sobre a API oficial do WhatsApp, você recebe no seu e-mail. Sem spam.

Ao assinar, você concorda em receber e-mails do blog da covercut. Cancele quando quiser.