Acompanhar a entrega de mensagens da campanha
Como acompanhar o status de entrega de mensagens de campanha no Chakra Chat
Este guia explica como verificar o status de entrega em tempo real de cada mensagem enviada em uma campanha do WhatsApp, incluindo códigos de erro detalhados e soluções recomendadas.
Etapas para ver o status de entrega
- Acesse a guia Campanhas na barra lateral esquerda
- Clique na campanha específica que você quer verificar
- Clique na guia Status (ao lado de Visão geral, Criador etc.)
Agora você verá um relatório completo para cada destinatário.
Entenda a guia Status
A guia Status está dividida em três seções principais:
1. Detalhamento dos erros de tentativa
Resumo dos contatos para os quais o Chakra nem sequer tentou enviar a mensagem (por exemplo, número inválido etc.).
2. Detalhamento dos erros de entrega
Resumo das mensagens que o Chakra enviou ao WhatsApp/Meta, mas que o WhatsApp não conseguiu entregar ao destinatário.
3. Lista de status da campanha (tabela principal)
Status detalhado, linha por linha, para cada destinatário.
Campo | Descrição |
|---|---|
Lead | ID do lead do contato |
E-mail/número de telefone | Número de telefone do destinatário |
Data e hora da última etapa | Quando a última etapa da campanha foi acionada (visível no Criador) |
Última etapa executada | Nome da campanha |
Status da última etapa | Status da última etapa executada |
Detalhes da última etapa | Informações adicionais sobre a última etapa |
Status de entrega | Resultado final da entrega (entregue, lida, enviada, com falha etc.) |
Mensagem de erro de entrega | Descrição do erro + código de erro, se a mensagem não foi entregue |
4. Baixar relatório de entrega da campanha
Use o botão Baixar ⬇️ para baixar a campanha em um arquivo CSV
Códigos de erro comuns de entrega do WhatsApp & soluções
Código de erro | Motivo | Solução sugerida |
|---|---|---|
131026 | O número do destinatário não está no WhatsApp OU o usuário não aceitou os Termos de Serviço/Política de Privacidade mais recentes OU está usando uma versão desatualizada do WhatsApp | Peça ao usuário (por SMS/e-mail/ligação) que: • Confirme que consegue enviar mensagens para o número da sua empresa • Aceite os Termos mais recentes (Configurações → Ajuda) • Atualize o WhatsApp para: Android ≥ 2.21.15.15, iOS ≥ 2.21.170.4 |
131042 | Problema de pagamento ou elegibilidade da conta empresarial | Acesse o WhatsApp Manager → Verifique a cobrança e a forma de pagamento. Confirme se a linha de crédito está ativa e dentro do limite. Verifique se a WABA não foi suspensa/excluída. Defina o fuso horário e a moeda, se estiverem ausentes |
131049 | A Meta bloqueou a mensagem para proteger o ecossistema (geralmente, por limite de modelos de marketing) | Isso geralmente é causado pelo limite de modelos de marketing por usuário. Aguarde pelo menos 24 horas antes de tentar novamente com o mesmo usuário. Não reenvie imediatamente — a mensagem falhará novamente. |
131056 | Limite de taxa por conversa: muitas mensagens enviadas do seu número para o mesmo destinatário em pouco tempo | Aguarde alguns minutos/horas antes de enviar outra mensagem para o mesmo usuário. Você ainda pode enviar mensagens para outros usuários imediatamente. Recomendado: ative o limite de taxa na Etapa 4 da campanha no Chakra |
131048 | Muitas mensagens anteriores foram bloqueadas/sinalizadas como spam → A classificação de qualidade do número de telefone caiu | Verifique a qualidade dos seus modelos e os limites de envio de mensagens no WhatsApp Manager. Melhore a classificação de qualidade antes de enviar mais mensagens de marketing. |
131051 | Tipo de mensagem ou modelo não compatível | Use somente tipos de mensagem/modelo compatíveis (consulte a documentação do WhatsApp). |
131052 | O WhatsApp não conseguiu baixar o arquivo de mídia | Peça ao usuário que envie a mídia novamente por outro canal ou carregue outra vez um arquivo menor ou em formato compatível. |
Dicas para reduzir erros de entrega
- Sempre valide se os números de telefone estão ativos no WhatsApp antes de importá-los.
- Use o limite de taxa integrado do Chakra (Etapa 4 da criação da campanha) para evitar o erro 131056.
- Monitore diariamente a classificação de qualidade da sua conta do WhatsApp Business.
- Evite enviar o mesmo modelo de marketing para o mesmo usuário em um intervalo de 24 horas.
Se os problemas persistirem após seguir as soluções acima, entre em contato com o suporte do Chakra e informe o ID da campanha e os números de telefone/códigos de erro específicos. Crie um chamado
Tudo pronto! Agora você pode acompanhar e solucionar com confiança os problemas de entrega de todas as mensagens das suas campanhas.
Como acompanhar o status de entrega de qualquer mensagem
É possível acompanhar a entrega de todas as mensagens usando eventos de webhook recebidos
- Eventos de webhook do Chakra
- Eventos de passagem
Consulte a documentação da API/Webhook sobre webhooks recebidos - https://apidocs.chakrahq.com/doc-919167
Como configurar (passagem)
Acesse a página de configuração do WhatsApp
Clique na aba Mais
Localize o campo "URL do webhook de passagem para eventos da Meta" (veja a captura de tela abaixo)
Insira a URL do webhook no campo acima
Clique em Salvar no canto superior direito da página
Como configurar (Webhook do Chakra)
Acesse a página de configuração do WhatsApp
Clique na aba Mais
Ative a opção "Ativar webhooks do Chakra"
Localize o campo "URL do webhook do Chakra" (veja a captura de tela abaixo)
Insira a URL do webhook no campo acima
Clique em um ou mais eventos em "Quais eventos enviar". Os tipos de evento selecionados serão enviados pelo webhook
Clique em Salvar no canto superior direito da página