gitlabEditar

exclamationRe-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.

whatsappJanela de 24h - Whatsapp APIchevron-right

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-codesarrow-up-right

📌 Código para consulta: 131047

Atualizado

Isto foi útil?