Janela de 24 horas no WhatsApp API: como o agente de IA deve agir
Entenda como a janela de atendimento de 24 horas do WhatsApp API funciona, o que o agente de IA pode enviar dentro e fora dela e quando usar template.
Quer aplicar isso na sua empresa?
Agendar conversa com o Juan →Janela de 24 horas no WhatsApp API: como o agente de IA deve agir
A janela de 24 horas do WhatsApp API é o período em que a empresa pode responder ao cliente com mensagem de texto livre, contado a partir da última mensagem que o cliente enviou. Quando ela fecha, a empresa só consegue iniciar contato com um template aprovado, e a janela volta a abrir quando o cliente escreve de novo. Para um agente de IA, isso muda o comportamento: antes de cada resposta ele precisa saber se a janela está aberta e qual tipo de mensagem é permitido naquele momento.
Principais pontos
- A janela abre quando o cliente envia uma mensagem e é renovada a cada nova mensagem dele. Mensagens da empresa não renovam a janela.
- Com a janela aberta, o agente pode enviar mensagens livres. Com a janela fechada, só template aprovado pela Meta.
- O controle da janela deve estar no sistema, com regra determinística, e não no prompt do modelo.
- Template não é atalho para contornar a janela: ele tem categoria, aprovação e, em muitos casos, exige permissão prévia do cliente.
- Fora da janela, muitas vezes a melhor decisão é registrar o caso, passar para uma pessoa e esperar o cliente voltar.
Como a janela de atendimento funciona segundo a documentação?
A documentação da Cloud API da Meta descreve o modelo assim: quando o cliente envia uma mensagem para o número da empresa, abre-se uma janela de atendimento. Dentro dela, a empresa pode enviar mensagens de qualquer tipo suportado, como texto, imagem, documento ou mensagem interativa, sem template. A janela dura 24 horas contadas a partir da última mensagem recebida do cliente.
Dois detalhes importam para quem constrói o agente. O primeiro: o relógio depende da mensagem do cliente, não da sua. Se a empresa responde dez vezes, a janela continua expirando no mesmo horário. O segundo: quando o cliente escreve de novo, a janela é renovada por inteiro.
Fora da janela, a empresa só pode iniciar a conversa com uma mensagem de template, que precisa ter sido criada e aprovada antes. Se o sistema tentar enviar texto livre com a janela fechada, a API recusa o envio e devolve um erro. Esse erro não é falha técnica a ser tratada com nova tentativa: é uma regra do canal sendo aplicada.
Vale uma ressalva. Existem regras específicas para conversas que começam por anúncios que levam ao WhatsApp, e as categorias de template e a forma de cobrança mudam com o tempo. Por isso, trate este texto como explicação do mecanismo e confira os detalhes na documentação oficial de envio de mensagens antes de configurar a operação. Também lembre que essa janela se aplica à API da plataforma, não ao uso manual do aplicativo no celular.
O que o agente pode fazer com a janela aberta?
Com a janela aberta, o agente tem liberdade de formato, mas não de escopo. A conversa continua limitada pelo que foi definido para o fluxo: quais perguntas responde, quais dados consulta, quais ações executa e quando transfere para uma pessoa.
Dentro da janela, o comportamento esperado é este:
- Responder dúvidas dentro do escopo, com base em fontes que a empresa controla.
- Pedir informações que faltam, uma pergunta por vez, em vez de despejar um formulário.
- Enviar mensagens interativas, como botões de resposta, quando isso reduz erro de interpretação.
- Executar ações permitidas, como consultar status de pedido ou propor horários, com registro de cada passo.
- Transferir para uma pessoa quando o assunto sai do escopo, quando há reclamação séria ou quando o cliente pede.
Um ponto que costuma ser ignorado: a pessoa da equipe que assume a conversa também está sujeita à mesma janela. A transferência para humano não dá um prazo extra. Se o atendente demora a pegar o caso e a janela expira, ele também fica limitado a templates. Por isso o agente deve registrar, na transferência, o horário em que a janela fecha, para que a equipe priorize os casos que estão perto de expirar.
Se você está desenhando o fluxo de ponta a ponta, o artigo sobre n8n com WhatsApp Cloud API mostra como organizar recebimento, decisão e envio em etapas separadas.
O que muda quando a janela fecha?
Quando a janela fecha, o agente perde a capacidade de escrever livremente. O que ele ainda pode fazer é pouco, e é bom que esteja decidido de antemão:
- Não enviar nada e registrar o assunto pendente.
- Enviar um template aprovado, se houver um adequado e se a empresa tiver permissão para contatar aquele cliente.
- Encaminhar o caso para uma pessoa, que decide se vale um novo contato por template ou por outro canal.
O erro mais comum de projeto é deixar o modelo de linguagem tentar resolver isso sozinho. Ele não tem como saber, só pelo texto da conversa, se passou o prazo. E, se descobrir o bloqueio pelo erro da API, pode tentar reformular a mensagem e repetir, o que gera ruído, log inútil e, em volume, risco para a reputação do número. O artigo sobre número de WhatsApp banido trata desse risco com mais detalhe.
O outro cuidado é de produto. Muita gente espera que a IA continue a conversa de ontem como se nada tivesse acontecido. Com a janela fechada, o cliente pode ter saído do WhatsApp, mudado de ideia ou resolvido o assunto por telefone. Reabrir com um template deve ser uma decisão com motivo claro, e não um reflexo automático. Para pensar o que responder na hora e o que adiar, veja atendimento fora do horário com IA.
Quando usar template e quem deve escrever o texto?
Template é uma mensagem com texto, categoria e variáveis definidos antecipadamente e enviados à Meta para aprovação. A documentação de templates explica como cada componente é montado e enviado. Na prática, o agente não escreve o template: ele escolhe um entre os aprovados e preenche as variáveis.
Isso tem uma consequência boa para controle. O texto que sai fora da janela é revisado por uma pessoa da empresa antes da aprovação, e o modelo só decide entre opções fechadas e fornece valores como nome, protocolo ou data. Uma lista simples ajuda a decidir:
- O cliente escreveu há pouco e a janela está aberta: use mensagem livre, não template.
- A janela fechou e o assunto é continuação direta de um pedido do próprio cliente, como aviso de status ou confirmação: avalie um template de utilidade.
- A janela fechou e o objetivo é oferta, campanha ou reativação: é mensagem de marketing, exige permissão específica e passa por revisão humana.
- A janela fechou e não há template adequado: não improvise. Registre e transfira.
- O cliente pediu para não receber mais contato: nenhum template, de nenhuma categoria.
A categoria do template afeta aprovação e regras de uso, e a Meta pode reclassificar o que a empresa declarou. Por isso, evite descrever como utilidade algo que é promoção. A leitura combinada de templates, opt-in e boas práticas ajuda a desenhar essa parte sem depender de interpretação.
Sobre a LGPD, vale lembrar que o número de telefone e o histórico da conversa são dados pessoais. Contato ativo por template deve ter base legal e finalidade claras, e o cliente precisa conseguir recusar. A página da ANPD é a referência oficial para orientações. Em caso de dúvida sobre a base legal de um fluxo específico, a decisão é jurídica, não do time de tecnologia.
Como o sistema deve controlar a janela, e não o prompt?
O controle da janela deve ficar em código, em uma etapa que roda antes de qualquer envio. O princípio é o mesmo de agentes bem construídos em geral, como discute a Anthropic em Building effective agents: colocar regras previsíveis em fluxo determinístico e reservar o modelo para o que exige julgamento.
Um desenho simples costuma bastar:
- Ao receber cada mensagem do cliente pelo webhook, guardar o horário de recebimento informado pela plataforma, em formato padronizado.
- Calcular o fim da janela somando o prazo ao horário da última mensagem recebida do cliente.
- Antes de enviar, comparar o horário atual com o fim da janela e decidir entre três caminhos: mensagem livre, template ou transferência.
- Entregar essa decisão ao agente como parte do contexto, por exemplo com um campo indicando janela aberta ou fechada, para que ele não tente algo impossível.
- Bloquear no código qualquer envio de texto livre com a janela fechada, mesmo que o modelo peça.
- Registrar cada decisão, com horário, caminho escolhido e motivo, para auditoria e melhoria.
Há também o caso das conversas longas, em que a resposta do agente demora por causa de uma consulta externa ou de uma fila. Se a janela estiver perto de expirar, o sistema pode priorizar uma mensagem curta de encerramento ou uma pergunta que convide o cliente a responder, o que renova a janela. Isso deve ser regra explícita, não improviso do modelo.
Por fim, trate o horário do servidor com cuidado. Diferença de fuso e atraso de fila causam erros pequenos, mas que viram falhas em casos de borda. Uma margem de segurança antes do fim teórico da janela evita tentativas que falham por segundos.
Cenário ilustrativo: pedido sobre prazo de entrega
Este é um cenário ilustrativo, sem relação com cliente real. Uma loja virtual usa um agente no WhatsApp. No fim da tarde, um cliente pergunta quando seu pedido chega. O agente consulta o sistema de pedidos e vê que a transportadora ainda não atualizou o rastreio. Ele responde com o que sabe e avisa que a equipe vai confirmar o prazo.
O caso é transferido para a logística, com o fim da janela registrado junto. Na manhã seguinte, a logística tem a informação, mas a janela já fechou, porque o cliente não escreveu mais.
O sistema oferece duas opções à pessoa: enviar um template de utilidade de atualização de pedido, com o código do pedido e o novo prazo como variáveis, ou aguardar o cliente voltar. Como o cliente tinha feito a pergunta e o assunto é continuação direta dela, a equipe aprova o envio do template. O agente não escreve o texto: preenche as variáveis e o sistema grava o envio.
Se o cliente responder, a janela abre de novo e o agente retoma a conversa, com o histórico anterior à mão. Se não responder, o caso fica resolvido com a informação entregue, sem insistência.
Como aplicar isso em uma operação real?
No nosso método, o trabalho segue quatro movimentos: mapear, limitar, pilotar e transferir. Aplicado à janela de atendimento, fica assim.
Mapear: levantar quantas conversas acabam com pendência depois do primeiro contato, quais assuntos exigem retorno posterior e quem na empresa responde por cada um. Sem esse retrato, não dá para saber quais templates fazem falta.
Limitar: definir um conjunto curto de templates aprovados, cada um com finalidade, categoria e condição de uso. Limitar também o que o agente pode fazer fora da janela, que na maioria dos casos é registrar e transferir.
Pilotar: rodar um fluxo real com logs de cada decisão de janela e um critério de sucesso combinado antes, por exemplo a proporção de pendências que foram resolvidas sem retrabalho. Testar os caminhos de borda com ambiente simulado, como mostra o artigo sobre mocks e sandbox para agentes, antes de expor clientes.
Transferir: entregar à equipe a regra da janela documentada, os templates e o painel de casos perto de expirar, e decidir com base nos registros se o piloto expande, ajusta ou para.
Os pontos do desenho que merecem revisão periódica são os mesmos: templates que ninguém usa, casos em que a janela expirou antes da transferência ser assumida e mensagens ativas sem motivo claro.
Perguntas frequentes
A janela de 24 horas é renovada quando a empresa responde? Não. A janela depende da última mensagem enviada pelo cliente. Respostas da empresa, inclusive as do agente de IA, não estendem o prazo. Só uma nova mensagem do cliente reinicia a contagem.
O agente de IA pode enviar texto livre depois que a janela fecha? Não pela API oficial. Com a janela fechada, a plataforma só aceita mensagens de template aprovado, e o envio de texto livre retorna erro. O mais seguro é bloquear isso no código e não depender de o modelo reconhecer a situação.
Todo template pode ser enviado a qualquer cliente? Não. Cada template tem uma categoria e regras próprias, e mensagens de marketing exigem permissão específica do cliente. Além disso, o contato precisa ter base legal e finalidade claras pela LGPD. Veja como coletar permissão em opt-in no WhatsApp.
A transferência para um atendente humano dá mais tempo? Não. A janela é uma regra do canal e vale para quem estiver respondendo, seja agente de IA ou pessoa. Por isso a transferência deve levar o horário de expiração, para que a equipe priorize os casos perto de fechar e escolha um template quando necessário.