Como identificar e corrigir falhas de envio em mensagens do whatsapp?

1) Onde ver o código do erro na Leadster

1. Abra a conversa.
2. Procure a mensagem marcada com “Falha ao enviar”.
3. Passe o cursor sobre o aviso (ou toque e segure no mobile).
4. Será exibido um balão com “Error code: xxxxx”.
5. Anote o código (ex.: 63016, 63032, 63024).

Nos prints anexos você vê o balão “Error code: 63016 / 63032” aparecendo logo acima da etiqueta “Falha ao enviar”.

2) O que significa cada código (e como resolver)

🔔 Erro 63016 — “Failed to send freeform message because you are outside the allowed window”

Motivo (WhatsApp): você tentou enviar uma mensagem livre (não-template) fora da janela de 24h do WhatsApp. Nesse caso, só é permitido enviar template message (modelo aprovado).

Causas comuns

• O cliente não envia mensagem há >24h e você respondeu com texto livre.
• O texto que você enviou não corresponde exatamente a um template aprovado (ou o template foi alterado/reprovado).

Como corrigir na Leadster

• Reabra a conversa com um Modelo (Template): envie um template aprovado (com as variáveis preenchidas) para retomar o contato fora da janela de 24h.
• Confirme o template: garanta que o texto bate 100% com o aprovado (inclusive pontuação, variáveis e namespace). Se o conteúdo mudou, cadastre um novo template e aguarde aprovação.
• Sandbox/Testes: se estiver usando o Sandbox do WhatsApp, mande primeiro uma mensagem de entrada para abrir a janela; do contrário, verá o 63016.

Plano B

• Se a conversa precisar continuar sem template, aguarde o usuário responder (abre nova janela de 24h).

🧪 Erro 63032 — “We cannot send this message… because of a WhatsApp limitation (user’s number is part of an experiment)”

Motivo (WhatsApp): o número do usuário está em um experimento/restrição do WhatsApp, e a plataforma bloqueia o envio. Não é algo que você consiga remover na sua conta.

O que fazer

• Tente outro canal (ex.: Ligação ou e-mail). O whatsapp recomenda ligação quando detecta 63032.
• Tente novamente mais tarde (quando a restrição do experimento terminar).
• Este é um caso classificado como restrição imposta pela Meta, fora da capacidade de correção do cliente.

🚫 Erro 63024 — “Invalid message recipient”

Motivo (WhatsApp): o destinatário é inválido para WhatsApp. Exemplos: o número não tem WhatsApp, não aceitou os Termos de Serviço/Política de Privacidade, ou está em versão muito antiga do app.

Checklist de correção

1. Valide o número em E.164 (+55… no Brasil) e se é mesmo do cliente.
2. Confirme que o cliente tem WhatsApp ativo (às vezes em aparelhos recém-ativados isso ainda não ocorreu).
3. Peça ao cliente para abrir uma conversa com sua conta de WhatsApp Business (isso confirma que o número está apto e pode abrir janela).

📣 Erro 63049 — “Meta chose not to deliver this WhatsApp marketing message”

Motivo (WhatsApp):

Esse erro indica que a própria Meta bloqueou a entrega de uma mensagem de template de categoria Marketing no WhatsApp.

Em resumo, a mensagem foi enviada corretamente pela Leadster/Twilio, mas o WhatsApp decidiu não entregar ao usuário final.

Como corrigir na Leadster

Para contatos dos EUA (+1):

• Não use WhatsApp para marketing com esses números. A Meta bloqueia todas as mensagens dessa categoria.
• Migre essas comunicações para outros canais, como SMS ou MMS, usando a mesma infraestrutura da Twilio.

Para contatos fora dos EUA:

• Evite reenviar o mesmo template imediatamente. O bloqueio é temporário e reenviar logo em seguida só vai gerar novos 63049.
• Tente reenviar o template em intervalos maiores (ex.: depois de algumas horas ou no dia seguinte), usando uma política de retry crescente (1h → 3h → 24h).
• Revise se a mensagem precisa mesmo ser Marketing. Se o conteúdo for confirmação de compra, status de pedido ou informação transacional, avalie usar um template de Utility/Service, que sofre menos restrições — sempre respeitando a política da Meta (não “maquie” marketing como utility).
• Reduza a frequência de campanhas e foque em contatos mais engajados (quem abriu/ respondeu campanhas anteriores), para não piorar a reputação e não atingir os limites com tanta facilidade.

3) Passo a passo rápido (decisão)

1. Pegue o código passando o mouse sobre “Falha ao enviar”.
2. 63016? Envie template aprovado (ou peça uma mensagem do cliente) para reabrir a janela de 24h. Twilio
3. 63032? Bloqueio/experimento do WhatsApp → use ligação ou outro canal de contato (SMS/e-mail, ligação) ou tente depois de algumas horas.
4. 63024? Destinatário inválido para WhatsApp → valide número, confirme que ele tem WhatsApp, mude o número ou faça uma ligação.