Janela de 24h — API Oficial Meta
Janela de 24 Horas — WhatsApp API Oficial (Meta)
O que é
Quando você usa o WhatsApp API Oficial (Meta/WABA), as mensagens seguem uma regra específica da Meta chamada janela de 24 horas: você só pode enviar mensagens de texto livre para um contato nas 24 horas após a última mensagem dele. Fora desse período, só é permitido enviar templates aprovados pela Meta.
Essa regra se aplica apenas ao canal Meta (WABA). Conexões Baileys (WhatsApp pessoal/business não-oficial) não têm essa restrição.
Como a janela funciona
Cliente envia mensagem → janela abre por 24h
↓
Durante 24h: você pode enviar qualquer mensagem livremente
↓
Após 24h sem resposta do cliente: janela fecha
↓
Para contatar o cliente: use template aprovado
Cada vez que o cliente responde, a janela reinicia por mais 24 horas.
Templates (mensagens fora da janela)
Templates são mensagens pré-aprovadas pela Meta para iniciar ou retomar conversas fora da janela de 24 horas. Eles seguem um formato fixo e podem ter variáveis (como {{nome}}).
Categorias de templates
| Categoria | Uso |
|---|---|
| Utilitário | Confirmações, atualizações de pedido, lembretes de pagamento |
| Marketing | Promoções, ofertas, novidades (cobrado por mensagem pela Meta) |
| Autenticação | Códigos de verificação e OTP |
Aprovar um template
Templates são criados e aprovados no Meta Business Manager vinculado ao seu WABA. A aprovação leva de alguns minutos a 24 horas. Após aprovado, o template fica disponível para uso no ConvertaFlow.
Campanhas e a janela de 24h
Ao criar uma campanha com conexão Meta Oficial:
- Contatos com janela aberta (responderam nas últimas 24h): recebem a mensagem normalmente
- Contatos com janela fechada: a campanha usa automaticamente um template aprovado
O wizard de campanhas identifica o status da janela para cada contato e aplica a lógica correta. Você não precisa verificar manualmente.
Custos
A Meta cobra por conversa, não por mensagem individual:
- Conversa de serviço (iniciada pelo cliente): sem custo adicional durante a janela
- Conversa de utilidade (iniciada pela empresa): custo por conversa aberta
- Conversa de marketing (template de marketing): custo por conversa aberta
Os valores são definidos pela Meta por país e são cobrados diretamente na sua conta de anúncios da Meta — não passam pela ConvertaFlow. Consulte a página de preços da Meta para os valores atuais no Brasil.
ConvertaFlow nunca assume custos de mensagens Meta. O modelo é 100% BYOA (traga sua própria conta). doc:connections-meta-oficial
Perguntas frequentes
O que acontece se eu tentar enviar mensagem de texto livre fora da janela?
A mensagem não é enviada. A API da Meta retorna erro de "janela expirada". Você precisa usar um template.
Posso configurar a janela de 24h para ser maior?
Não. O período de 24 horas é uma regra da Meta e não pode ser alterado.
Conexões Baileys (WhatsApp pessoal) têm janela?
Não. A janela de 24 horas é exclusiva do WhatsApp API Oficial. Conexões Baileys funcionam como o WhatsApp normal — sem restrições de template ou janela.
Como sei se um contato está dentro ou fora da janela?
No perfil do contato, no ticket ativo da conversa, aparece um indicador de tempo desde a última mensagem. Qualquer mensagem recebida nas últimas 24h mantém a janela aberta.