Erro 131047 do WhatsApp: mensagem de reengajamento
O erro 131047 significa que passaram mais de 24 horas desde a última mensagem daquele cliente, então a janela de atendimento fechou e texto livre não vai entregar. Só um template já aprovado pela Meta reabre a conversa.
Código da Meta para mensagem de reengajamento enviada fora da janela.
Por quanto tempo uma mensagem do cliente mantém o texto livre liberado.
O que é preciso para reabrir uma conversa fechada: um template aprovado.
O que causa o erro 131047?
Uma mensagem de texto livre enviada para alguém cuja última mensagem para você tem mais de 24 horas.
A WhatsApp Business Platform só permite que um negócio escreva livremente dentro de uma janela de atendimento, e essa janela abre quando o cliente manda mensagem e dura 24 horas. Dentro dela você envia o que quiser. Fora dela, a API rejeita texto livre com 131047 em vez de entregar algo que o destinatário não pediu.
O motivo de isso aparecer em produção e não em teste é o tempo. Quem testa uma integração envia uma mensagem e responde segundos depois, o que está sempre dentro da janela. O primeiro caso de um dia para o outro, ou o primeiro cliente que some por um dia, é quando o erro aparece.
Como corrigir?
Envie um template aprovado no lugar do texto livre.
Templates são mensagens que você submete à Meta antes e que a Meta revisa. Uma vez aprovado, um template pode ser enviado a qualquer momento, inclusive para quem nunca escreveu para você. Enviar um reabre a conversa, e no instante em que o cliente responde você tem 24 horas novas de texto livre.
Então a correção duradoura não é repetir. É uma ramificação: antes de enviar, verifique há quanto tempo aquele contato mandou mensagem. Dentro de 24 horas, texto livre. Fora, o template que couber na situação. Uma integração que só sabe enviar texto livre vai bater nisso sempre, e para quem acompanha a conversa vai parecer silêncio, não erro.
Isso vale num número em Coexistência?
Vale, e com uma consequência extra que merece atenção.
A janela funciona igual, tenha o número entrado por Coexistência ou não, porque é regra da plataforma e não do modo de onboarding. O que muda é quem pode agir. Num número em Coexistência o app do WhatsApp Business não envia templates, então tudo que estiver fora da janela precisa passar pela API.
Isso significa que uma equipe atendendo pelo celular responde livremente numa conversa viva, mas não consegue reiniciar uma conversa fria pelo app. Reiniciar é trabalho de API, e essa é uma das razões práticas para um negócio conectar o número.
Erros comuns
- Repetir a mesma mensagem de texto livre. A janela não reabre sozinha, então a repetição falha igual.
- Medir a janela a partir da sua última mensagem em vez da dele. É a mensagem dele que abre.
- Achar que dá para escrever e enviar um template no mesmo momento. A Meta revisa antes, normalmente em minutos, às vezes em um dia.
A EasyCoexistence lista os templates de um número e submete novos, pelo painel ou pelo conector MCP, então um assistente escolhe o certo quando a janela já fechou.
Perguntas frequentes
Dá para estender a janela de 24 horas?
Não. Ela é fixada pela Meta e nenhum provedor consegue aumentar. A única coisa que reabre é o cliente escrever de novo.
O cliente responder a um template reabre?
Sim. Qualquer mensagem do cliente começa 24 horas novas, inclusive uma resposta a um template que você mandou.
Qual categoria de template usar?
Utility para transacional, marketing para promocional. Envios de marketing exigem um meio de pagamento na sua própria conta do WhatsApp Business.
O erro 131047 é o mesmo que o 131049?
Não. O 131047 é a janela fechada. O 131049 é a Meta limitando entrega para proteger a saúde do ecossistema, que é outra condição.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em