Erros no envio de mensagens
O envio de mensagens para o WhatsApp através da API oficial pode apresentar alguns erros conhecidos. No geral, temos dois tipos de erros: os internos, gerados pelo RastreioZap, e os que são da própria Meta/WhatsApp.
Abaixo listamos todos os possíveis erros mais comuns e uma breve explicação.
| Nome do erro | Descrição | Tipo |
| Template não existe | O template da mensagem em questão ainda não foi configurado na Gupshup. | Interno |
| Variáveis não existem | As variáveis do template ainda não foram configuradas no painel do RastreioZap. | Interno |
| Categoria do template não aceito | O template criado na Gupshup foi identificado ou alterado automaticamente pela Meta, para uma categoria diferente de 'Utilidade'. Aceite o envio desta categoria na configuração de integração com a Gupshup, no painel do RastreioZap. | Interno |
| Não aceita mensagens | Seu cliente/destinatário das mensagens optou por não receber notificações, através do botão de opt-out configurado no template. A decisão pode ser feita a qualquer momento, e a vontade do cliente deve ser respeitada. | Interno |
| Número não existe no WhatsApp | O destinatário da mensagem/cliente não possui WhatsApp no número fornecido pela loja. Por esse motivo, a mensagem não pode ser enviada. | Externo |
| Verifique se existe saldo na Gupshp | O saldo de créditos na Gupshup pode estar muito baixo ou zerado, impossibilitando o envio das mensagens. | Externo |
| Número de telefone desativado | O número de telefone do destinatário/cliente não está mais disponível no WhatsApp. | Externo |
| Resposta inválida do WhatsApp | A Meta/WhatsApp retornou uma resposta inválida ou genérica após o envio da mensagem. Informe o problema ao suporte do RastreioZap para obter auxílio. | Externo |
| Template não aprovado | O template que criou na Gupshup ainda aguarda aprovação ou foi recusado pela Meta/WhatsApp. | |
| Template está pausado | O template foi pausado automaticamente pela Meta/WhatsApp ou manualmente por você. Verifique as condições deste template específico direto na Gupshup. | Externo |
| Saldo de créditos baixo na Gupshup | O saldo de créditos na Gupshup pode estar muito baixo ou zerado, impossibilitando o envio das mensagens. | Externo |
| Envio de marketing limitado pela Meta | A Meta decidiu, por conta própria, não enviar a mensagem. A decisão ocorre devido ao limite de mensagens de marketing atingido. Para resolver, ajuste o tipo do template para a categoria 'Utilidade'. | Externo |
| O usuário faz parte de um experimento da Meta | A Meta/WhatsApp pode selecionar uma pequena parcela de usuários para experimentos e testes internos deles. Com isso, algumas mensagens de marketing podem não ser enviadas. | Externo |
Status de sucesso
Além dos status de erros listados acima, também temos status de sucesso no envio de mensagens, que são:
| Nome do status | Descrição | Tipo |
| Na fila | Mensagem já foi enviada para a Meta/WhatsApp e o RastreioZap aguarda confirmação do envio. | Interno |
| Enviada | A mensagem chegou para o destinatário/cliente, porém ainda não foi aberta. | Interno |
| Enviada e lida | A notificação chegou e o destinatário/cliente já faz a leitura da mensagem. | Interno |