Pular para o conteúdo
Abrir o Leadz

Solução de problemas

Os erros mais comuns do Leadz, por assunto, com a causa e o que fazer em cada um.

Nesta página

Esta página reúne as mensagens de erro que você pode encontrar no Leadz, agrupadas por assunto. Procure pelo texto que apareceu na tela ou pelo número entre parênteses (por exemplo, #131026). Cada item diz a causa e o que você mesmo pode fazer.

As mensagens de envio aparecem na própria mensagem que falhou, no Chat de conversas, e no resultado do disparo ou da execução do funil. Quando a mensagem pede para reconectar «em Integrações», o caminho é Conexões › Integrações, na aba Canais.

#Entrar na conta

«E-mail ou senha incorretos»

Confira o e-mail do cadastro e a tecla de maiúsculas. Se não lembrar a senha, use Esqueci minha senha na tela de entrada.

«Muitas tentativas de acesso a esta conta. Aguarde alguns minutos e tente de novo.»

Houve 5 ou mais senhas erradas seguidas. A espera vai de 1 minuto a 1 hora. Para entrar antes, redefina a senha em Esqueci minha senha.

«Confirme seu e-mail para entrar.»

Falta abrir o link de confirmação do cadastro. Clique em Reenviar e-mail de confirmação, ao lado da mensagem, e olhe a caixa de spam.

Perdi o celular do código de 6 dígitos

Na tela do código, clique em Usar um código de recuperação. Sem os códigos, só o suporte libera. Veja Segurança e verificação em duas etapas.

Aparece a tela «Workspace bloqueado»

Há pagamento pendente. Quem administra o workspace usa Pagar agora na própria tela. Veja Financeiro.

#WhatsApp oficial

«Janela de 24h fechada — o cliente não falou recentemente.»

A Meta só aceita texto livre até 24 horas depois da última mensagem do contato. Fora desse prazo, envie um template de mensagem aprovado. Quando o contato responder, o texto livre volta a funcionar. Veja Janela de 24 horas.

«A Meta não consegue entregar a este número (#131026)»

O número não tem WhatsApp, usa uma versão muito antiga do aplicativo ou está errado. Confira o telefone na ficha do contato. Se o Chat mostrar a faixa Número inválido, ela diz o que está errado (DDD que não existe, dígito a mais, celular que não começa com 9). Corrija e envie de novo.

«A Meta segurou esta mensagem: o contato já recebeu marketing a mais no período (#131049)»

A Meta limita quantas mensagens de marketing cada pessoa recebe, somando todas as empresas. Não é erro do template nem do seu número. Espere algumas horas ou use um template de utilidade.

«A ligação desta conta WhatsApp expirou ou foi revogada na Meta (#190)»

A autorização do número venceu ou foi retirada. Abra Conexões › Integrações, na aba Canais, e reconecte o número. No cartão do canal, a linha Validade do token avisa antes: «Expira em N dia(s) — reconecte».

«A Meta travou o envio por limite de spam neste número (#131048)»

A qualidade do número caiu. Reduza o volume, revise a lista e o texto, e espere antes de tentar de novo. Insistir piora a avaliação.

«Template não existe neste número ou está noutro idioma (#132001)»

O template foi apagado ou alterado na Meta. Em Conexões › Integrações, aba Canais, clique em Templates Meta no cartão do número. Depois clique em Sincronizar Meta e escolha de novo o template no funil ou no disparo. Veja Templates do WhatsApp.

«O número de variáveis enviadas não bate com o template aprovado (#132000)»

Falta ou sobra variável. Sincronize os templates e preencha todas as variáveis no bloco ou no disparo.

«Template pausado pela Meta por qualidade baixa (#132015)»

Muitas pessoas bloquearam ou denunciaram a mensagem. Use outro template e revise o texto e a lista.

Meu template está como «Rejeitado»

O motivo aparece no próprio template, em «Motivo rejeição». Corrija o texto e envie de novo com outro nome. O status muda sozinho; para conferir na hora, use Sincronizar Meta.

«A conta não está elegível para enviar: problema de pagamento na Meta (#131042)»

O problema é na conta da Meta, não no Leadz. Confira a forma de pagamento no Gerenciador de Negócios da Meta.

#WhatsApp por QR Code

«O WhatsApp bloqueou temporariamente este número para iniciar conversas novas (erro 463)»

O próprio WhatsApp travou o número por volume ou qualidade de envio. Você ainda responde quem escrever, mas não abre conversa nova até a trava acabar (a mensagem informa a data, quando disponível). Não insista: cada tentativa prolonga a trava. Pause funis e disparos desse número, ou fale com o contato por outro número.

«A instância da Sparkle API está desconectada. Reconecte o número em Integrações antes de enviar.»

O celular saiu da sessão. Abra Conexões › Integrações, na aba Canais, e leia o QR Code de novo com o WhatsApp do aparelho. Veja WhatsApp por QR Code.

«Este número não existe no WhatsApp segundo a Sparkle API. Confira o telefone do contato.»

O telefone do contato está errado ou não tem WhatsApp. Corrija na ficha.

«O WhatsApp bloqueou este número não oficial. Envio suspenso até a conta ser liberada.»

O número foi bloqueado pelo WhatsApp. O Leadz não consegue reverter. Resolva pelo aplicativo do WhatsApp no celular e considere o WhatsApp oficial para envio em volume.

#Instagram e Messenger

«Fora da janela de mensagens da Meta: só dá para responder dentro de 24h da última mensagem do contato (7 dias com agente humano).»

Funis e disparos só alcançam quem mandou mensagem nas últimas 24 horas. Comentário, curtida ou seguir a conta não abrem a janela. Uma pessoa da equipe ainda pode responder pelo Chat de conversas por até 7 dias.

A conversa aparece sem nome, sem @ ou sem foto

O Instagram só entrega o nome e a foto depois que a pessoa manda uma mensagem. Em conversa aberta pela sua conta, o perfil chega quando ela responder. Se todas as conversas novas chegam sem perfil, a ligação da conta pode ter vencido (ela tem validade de cerca de 60 dias): reconecte em Conexões › Integrações, na aba Canais.

«A ligação desta conta expirou ou foi revogada na Meta (#190). Reconecte em Integrações.»

Abra Conexões › Integrações, na aba Canais, e reconecte a conta. O histórico continua.

«A Meta diz que esta pessoa não está disponível agora (#551)»

Normalmente a pessoa bloqueou a conta, apagou a conversa ou desativou o perfil. Não há o que fazer pelo Leadz.

«Esta conta Instagram não está elegível para mensagens (#2018108)»

A conta precisa ser profissional e estar com as mensagens ligadas nas configurações do Instagram. Ajuste e reconecte.

«Mídia indisponível» ou «Prévia indisponível»

O Instagram não deixa mais baixar aquele arquivo. É comum em story que saiu do ar. Clique no cartão para tentar abrir a publicação no próprio Instagram.

#Funil

«Não foi possível carregar a fonte de verdade: …»

A lista de funis não veio do servidor, e a tela mostra a última cópia guardada no navegador. Confira a internet e recarregue a página antes de editar. Se continuar, fale com o suporte.

O funil não enviou a mensagem

No menu Funil, clique em Execuções e veja o motivo na execução do contato. Os mais comuns: janela de 24 horas fechada (WhatsApp oficial exige template; Instagram e Messenger não enviam), número inválido, canal desconectado ou workspace bloqueado por pagamento.

«Seu plano não inclui …» ao ativar um funil

O recurso ou o bloco usado não faz parte do plano. Veja Planos e limites.

#Disparos

O disparo saiu para menos gente do que a lista

No Instagram e no Messenger, quem está fora da janela de 24 horas fica de fora. O Leadz avisa antes de disparar, com a quantidade de bloqueados. No WhatsApp oficial, o limite de marketing por pessoa (#131049) também segura parte dos envios.

«Limite de envio deste número atingido (#130429)»

O número atingiu o limite de envio da Meta. Espere e repita, ou divida a lista em mais de um disparo.

Apaguei um contato e ele recebeu o disparo

Disparo agendado ou em andamento não é alterado. Cancele o disparo antes de apagar o contato.

#Agentes IA

O agente não respondeu

Confira, nesta ordem:

  1. O agente está ativo e com um provedor de IA com token válido.
  2. O agente está vinculado ao número ou à conta que recebeu a mensagem.
  3. Ninguém da equipe respondeu aquela conversa há pouco. Resposta humana pausa o agente por um tempo.
  4. Não há funil em andamento para o contato, nem um gatilho que disparou com aquela mensagem. O funil tem prioridade.
  5. A conversa não é de grupo. O agente não responde em grupos.
  6. A conversa não foi transferida para a equipe e não está fora do horário configurado no agente.
«O provedor recusou o token: ele é inválido, foi revogado ou está sem permissão.»

A chave do provedor de IA não vale mais. Gere uma chave nova no site do provedor e troque em Agentes IA, na aba Tokens de IA. Veja Provedores e modelos.

«O provedor recusou por limite de uso ou falta de crédito na conta.»

Acabou o crédito ou o limite da sua conta no provedor de IA. Recarregue por lá.

«O modelo configurado não existe nesta conta. Troque o modelo do token.»

O modelo escolhido não está disponível para a sua chave. Escolha outro modelo.

O agente não move o card de etapa

O agente só move cards do próprio contato. Confira se o contato tem card no CRM, se o nome da etapa na instrução é igual ao do quadro e se a etapa existe no quadro em que o card está. Veja Ações no CRM.

#Webhooks

O evento chegou como «Sem ação no CRM»

Abra o evento em Webhooks e Postbacks e leia o motivo:

  • «Nome (contact.firstName) não encontrado no payload»: o mapeamento do nome aponta para um campo que não veio;
  • «Nenhum mapeamento configurado»: falta mapear os campos;
  • «Nenhum contato encontrado pelas regras de vínculo»: o webhook só vincula e a pessoa ainda não existe;
  • «Automação CRM desativada»: a criação de contato está desligada naquele webhook.
«Limite de contatos atingido»

O workspace bateu o limite do plano e o contato não foi criado. Veja Planos e limites.

O contato foi criado sem telefone

A plataforma de origem mandou o telefone vazio, ou o mapeamento aponta para o campo errado. Abra o evento, confira o que veio e ajuste o mapeamento. Sem telefone, o Leadz não tem para onde enviar no WhatsApp. Veja Webhooks de entrada.

#Contatos

A mesma pessoa aparece duas vezes

O Leadz junta números iguais mesmo com formatos diferentes: com ou sem o 55, com ou sem o nono dígito. Vira outro contato quando o DDD ou o país muda, ou quando a pessoa chegou por canais diferentes (Instagram e WhatsApp, por exemplo). Corrija o número na ficha e exclua o cadastro repetido.

#Tela e navegador

«Não foi possível contatar o backend…»

O navegador não conseguiu falar com o servidor do Leadz. Confira a internet, desligue VPN ou bloqueador de anúncios e recarregue. O restante da mensagem é uma instrução técnica e pode ser ignorado. Se a sua equipe técnica vir «CORS» ou «Failed to fetch» no console, a causa é a mesma: o servidor não respondeu naquele momento.

A tela ficou em branco, travada ou com dado antigo

Recarregue a página. Se não resolver, saia e entre de novo. Como último passo, limpe os dados do site no navegador: isso apaga o que fica guardado só nele, como a foto do perfil, o tema e os atalhos de filtro.

Um item sumiu do menu

O seu cargo não tem acesso àquela tela, ou você está em outro workspace. Veja Equipe e cargos.

#Não achou o seu problema?

Veja Falar com o suporte e mande a mensagem exata que apareceu.

Este artigo ajudou?

Mais em Ajuda