Re-engagement message

O erro “Re-engagement message” é comumente retornado pela API do WhatsApp Business quando uma empresa tenta enviar uma mensagem fora da janela de atendimento permitida, sem utilizar um modelo de mensagem aprovado (template/HSM).

Esse erro indica que a janela de 24 horas de mensagens de sessão expirou.

---

O que é a Janela de 24 Horas do WhatsApp?

No ecossistema do WhatsApp Business API:

• A empresa pode enviar mensagens livres (mensagens de sessão) somente dentro de 24 horas após a última resposta do usuário.

• Após esse período, qualquer nova mensagem iniciada pela empresa precisa obrigatoriamente ser um template aprovado pela Meta.

Caso contrário, a API retorna o erro de reengajamento.

Janela de 24h - Whatsapp API

---

O que significa “Re-engagement message”?

A mensagem de reengajamento ocorre quando:

• O usuário não respondeu nenhuma mensagem nas últimas 24 horas

• A empresa tenta enviar uma mensagem comum (não-template)

• O WhatsApp bloqueia o envio para proteger a experiência do usuário e evitar spam

📌 Esse controle é feito automaticamente pela Meta.

---

Código do Erro

• Código: 131047

• Descrição: Re-engagement message

• Origem: WhatsApp Business API (Meta)

---

Exemplo Prático

1. Um cliente envia uma mensagem hoje às 10h

2. A empresa responde normalmente até amanhã às 10h

3. Após esse horário:

   • ❌ Não é permitido enviar mensagens livres

   • ✅ Só é permitido enviar templates aprovados

Se a empresa tentar enviar uma mensagem comum após esse prazo, o erro 131047 – Re-engagement message será retornado.

---

Como Resolver o Erro de Re-engajamento

✅ 1. Enviar um Template de Mensagem

Utilize um modelo de mensagem previamente aprovado pela Meta para iniciar novamente a conversa.

Exemplos comuns:

• Confirmação de atendimento

• Aviso de retorno

• Notificação de status

• Mensagem de follow-up comercial

---

✅ 2. Aguardar a Resposta do Usuário

Assim que o usuário responder:

• A janela de 24 horas é reaberta

• Mensagens de sessão normais voltam a ser permitidas

---

Boas Práticas para Evitar o Erro

• Sempre valide se a conversa está dentro da janela de 24 horas

• Configure automações para:

  • Usar templates automaticamente fora da janela

  • Priorizar respostas rápidas do usuário

• Evite mensagens promocionais excessivas

• Utilize templates claros e objetivos para reengajamento

---

Referência Oficial da Meta

Documentação oficial do WhatsApp Business API: 🔗 https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes

📌 Código para consulta: 131047