Skip to main content
A janela de 24h (customer service window) é a regra da Meta que define quando a empresa pode mandar mensagem livre e quando precisa de template aprovado. Errar isso é o motivo mais comum de “minha mensagem não saiu”.

Como funciona

A contagem parte da última mensagem do cliente, não da sua. Cada nova mensagem dele renova as 24h.
Mandar template não abre a janela. Ela só abre quando o cliente responde.
Template aprovado pode ser enviado a qualquer momento, com a janela aberta ou fechada, em qualquer categoria. O que a janela controla é o envio de conteúdo que não é template: texto livre, mídia, mensagem interativa, localização e reação.

Como abrir a janela

Com um cliente que nunca falou com você, ou que está sem responder há mais de 24h:
  1. Envie um template aprovado.
  2. O cliente responde: a janela abre.
Não existe outro caminho. Mensagem livre com a janela fechada é recusado.

Como verificar o status

Antes de mandar mensagem livre, consulte a janela de até 200 números por chamada:
Resposta:
Se você mandar mais de 200 números, a resposta considera os 200 primeiros e traz truncated: true.

Mensagem livre com a janela fechada

A API recusa com HTTP 422:
Trate esse código com fallback para template.

Resposta com fallback

Padrão recomendado para atendimento:
Quando o cliente responder ao template, a janela abre e você envia o texto pendente.

Janela e custo

  • Template: paga a tarifa Meta da categoria (MARKETING, UTILITY ou AUTHENTICATION), dentro ou fora da janela.
  • Mensagem livre dentro da janela: a Meta não cobra. A carteira paga só o custo do provedor.
  • Mensagem recebida do cliente: a carteira paga só o custo do provedor.
Valores em Preços.

Casos de borda

O cliente respondeu, mas o evento ainda não chegou

Se o cliente respondeu há poucos segundos e o evento ainda não foi processado, window-status pode vir fechado. Espere alguns segundos ou tente de novo ao receber CONVERSATION_WINDOW_CLOSED.

O cliente respondeu no meio de uma campanha

Durante uma campanha, um cliente pode responder e abrir a janela. Marque a conversa como aberta ao receber o webhook message.received e faça o seu envio consultar esse estado antes de enviar o próximo template para a mesma pessoa.

Mais de uma equipe no mesmo número

A janela é por número da empresa e cliente. Se atendimento e marketing usam o mesmo número, a resposta do cliente para um libera mensagem livre para o outro. Coordene.

Próximos passos

Templates

O que mandar fora da janela.

Criar e aprovar um template

Regras para o template de retomada.

Receita: caixa de entrada

Atendimento com vários atendentes.