Pular para o conteúdo
Abrir o Leadz

Perguntas frequentes

As dúvidas que mais aparecem sobre o Sparkle Leadz, com respostas curtas e o caminho para o guia completo.

Nesta página

Respostas diretas para as dúvidas mais comuns. Se o que você tem é uma mensagem de erro, vá para a Solução de problemas.

#Primeiras dúvidas

Qual a diferença entre o WhatsApp API oficial e o WhatsApp por QR Code?

O oficial usa a API da Meta: exige templates aprovados para iniciar conversa e segue a janela de 24 horas. O por QR Code conecta como um aparelho, não usa templates e funciona em grupos, mas o WhatsApp pode limitar ou bloquear o número. Compare os dois em Visão geral dos canais.

Quem paga a IA dos agentes?

Você, direto ao provedor de IA, com a sua própria chave. O Leadz não cobra pelo uso da IA nem revende créditos. Veja Provedores e modelos.

Preciso do Sparkle Tracker para ligar o meu checkout?

Não. Sem ele, você cria um webhook e mapeia os campos do evento de compra. Com o Tracker, o checkout, o pagamento pendente e a compra chegam prontos e se juntam na mesma negociação. Veja Checkouts e plataformas.

Posso usar o Leadz no celular?

Sim, pelo navegador, no mesmo endereço. A barra de baixo traz Conversas, CRM, Contatos e Painel, e Mais abre o menu completo. Veja Perfil e preferências.

Posso conectar mais de um número ou conta no mesmo canal?

Sim, em Configurar contas, no cartão do canal. A quantidade depende do seu plano; ao atingir o teto, o cartão mostra Limite do plano.

Por onde eu começo?

Pelo roteiro de Primeiros passos: criar a conta, conectar um canal, atender a primeira conversa e só então montar funil e agente IA.

#Canais e mensagens

Por que não consigo escrever para um contato no WhatsApp oficial?

A janela de 24 horas fechou: a Meta só aceita texto livre até 24 horas depois da última mensagem do contato. Clique em Enviar template de mensagem; quando ele responder, o texto livre volta. Veja Janela de 24 horas.

Quanto tempo a Meta leva para aprovar um template?

Costuma sair em minutos e pode levar até 24 horas. O status muda sozinho; para conferir na hora, clique em Sincronizar Meta. Veja Templates do WhatsApp.

Por que a conversa do Instagram aparece sem nome e sem foto?

A Meta só libera nome e foto depois que a pessoa manda mensagem. Se ela já escreveu e continua sem nome, a ligação com a Meta caiu: em Configurar contas, use Continuar com Meta com a mesma conta. Veja Instagram.

Posso mandar mensagem para quem nunca falou comigo no Instagram ou no Messenger?

Não. Nesses canais a conversa começa sempre pelo contato. Mensagens automáticas só chegam a quem escreveu nas últimas 24 horas, e a resposta manual vai até 7 dias.

O que é o erro 463 no WhatsApp por QR Code?

É uma trava temporária do próprio WhatsApp para iniciar conversas novas, por volume ou qualidade. Espere o prazo sem insistir: repetir o envio prolonga a trava. Veja WhatsApp por QR Code.

O número do QR Code envia, mas não recebe. O que faço?

Em Configurar contas, clique em Reparar recebimento. Não use Reconectar para esse caso.

Qual o tamanho máximo de arquivo no Chat de conversas?

Imagem, vídeo e áudio de até 32 MB são aceitos e comprimidos; depois de comprimido, o arquivo precisa caber em 15 MB. Documento vai sem compressão e tem limite de 15 MB. Veja Enviar mensagens e mídia.

Apaguei uma mensagem. O contato ainda vê?

No WhatsApp e no Instagram, sim: apagar tira a mensagem só do Leadz. No Messenger ela some para o contato, se apagada em até 10 minutos.

O número ao lado da conversa é de mensagens não lidas?

Não, é de mensagens sem resposta. Ele some quando você responde ou usa Marcar como lido no menu da conversa.

Mudei o Chatbot e o meu site continua igual. Por quê?

A mudança ficou em rascunho. Clique em Publicar alterações. O código colado no site não muda. Veja Chatbot do site.

Colei o código do Chatbot e ele não aparece no site

Confira se o chatbot está publicado, se o endereço do site está em Domínios autorizados e se o site abre em https. Veja Instalar o Chatbot.

#Contatos e CRM

Importar a mesma planilha duas vezes duplica os contatos?

Não. O Leadz reconhece o contato por e-mail, WhatsApp, telefone ou @ do Instagram e atualiza o cadastro. Célula em branco não apaga dado, e as tags só são somadas. Veja Importar e exportar contatos.

Como exporto meus contatos?

Em Contatos, abra Mais opções e clique em Exportar. Sem ninguém marcado, saem todos, mesmo com filtro aplicado.

Se eu excluir uma tag, o que acontece com os contatos?

A tag sai da lista e de todos os contatos que a tinham, sem volta. O aviso de confirmação mostra quantos contatos serão afetados. Veja Campos personalizados e tags.

Mover o card para a última etapa fecha a negociação?

Não. Card e negociação são independentes. Mude a etapa da negociação na ficha do contato, ou monte um funil que faça as duas coisas. Veja Negociações.

Por que a «Receita ganha» do Painel está zerada?

O Painel conta como ganho o card que está numa etapa com «ganho», «fechado» ou «cliente» no nome, e soma o valor gravado no card. As negociações da ficha do contato não entram nesse número. Veja Painel.

Meus painéis personalizados sumiram. Perdi os dados?

Não. A montagem dos painéis fica guardada no navegador em que foi criada. Em outro computador, ou depois de limpar os dados do site, aparece só a «Visão geral». Os números são os mesmos.

O Leadz me lembra quando uma tarefa vence?

Não há lembrete de prazo. O sino avisa quando uma tarefa é atribuída a você e quando um agente IA executa uma tarefa. Acompanhe «Para hoje» e «Atrasadas» na tela Tarefas.

#Funil e disparos

Editei o funil e os contatos continuam recebendo o texto antigo. Por quê?

O Leadz guarda as alterações como rascunho, e o rascunho não vai ao ar. Clique em Salvar, se o funil está publicado, ou em Publicar, se está pausado. Veja Testar e publicar.

Quem comprou continua recebendo as mensagens do funil?

Sim, a compra não tira o contato do funil sozinha. Antes de cada cobrança, ponha um Aguardar Evento com «Compra concluída» ou uma Condição por produto ou tag. A receita Recuperar Pix e boleto mostra a montagem.

Por que a mensagem do funil não saiu depois de uma espera longa?

No WhatsApp oficial, no Instagram e no Messenger, mensagem livre só chega a quem escreveu nas últimas 24 horas. No WhatsApp oficial, use Enviar Template depois de esperas longas. Veja Funil e janela de 24 horas.

O que acontece com quem está no meio se eu pausar o funil?

Ninguém novo entra, e quem estava no meio não continua: a execução fica como «Falhou» na hora do próximo passo. Para mudar um bloco sem parar ninguém, edite e clique em Salvar com o funil publicado.

O «Testar fluxo» envia mensagem de verdade?

Não. Ele simula a conversa, pula as esperas e não chama WhatsApp, IA nem outros sistemas. Também não aplica a janela de 24 horas.

Posso usar mais de um gatilho no mesmo funil?

Sim. Qualquer um deles inicia o funil, e dá para mandar cada gatilho para um bloco diferente. Veja Gatilhos.

Como sei por que um contato parou no funil?

Em Automação › Funil › Execuções, abra a execução. O motivo aparece em «Não enviou:» ou «Cancelado:», e a Jornada no funil mostra o bloco. Veja Execuções e métricas.

Qual a diferença entre Disparos e o gatilho Disparo Agendado?

Disparos envia uma mensagem única, agora ou numa data marcada. Disparo Agendado é um gatilho que roda um funil inteiro em dias e horários que se repetem. Veja Disparos.

Dá para pausar um disparo em andamento?

Não, só cancelar, em Em andamento e falhas. Quem já recebeu fica com a mensagem, e os demais não recebem.

#Agentes IA

O agente respondeu, mas não moveu o card. Por quê?

As causas, na ordem em que vale conferir: a chave Atualizar CRM durante a conversa está desligada; a etapa não está marcada nas ações do agente; o nome da etapa nas instruções não é idêntico ao do quadro; o contato não tem card, e o agente não cria card. Veja Ações no CRM.

Por que o agente ficou calado?

Ele não responde em grupos, nem com um funil em andamento para o contato, nem durante a pausa depois que alguém da equipe respondeu, nem fora do horário configurado. Também fica calado com o agente ou o token pausado, ou se a conta do canal não está marcada nele. Veja Agentes IA: visão geral.

Posso escrever as instruções do agente com o ChatGPT ou o Claude?

Pode, e é o caminho recomendado. Cole o Manual para criar o prompt na sua IA junto com a descrição do seu negócio. Sem o manual, a outra IA escreve instruções que fazem o agente responder e esquecer as ações.

O agente lê o PDF que eu cadastrei como material?

Não. Do material ele conhece o título, o texto de instruções e as tags, e envia o arquivo quando faz sentido. O PDF que o contato manda na conversa ele lê. Veja Materiais e base de conhecimento.

O agente pode inventar um link?

Não. Ele só envia um endereço que esteja escrito nas instruções, no material ou na própria conversa.

Quantos botões o agente manda?

Até 3, com até 20 caracteres cada. Com um botão de link, sobram 2 de resposta. Veja Botões e mídia.

O «Testar» grava algo ou manda mensagem?

Não. Ele mostra o que o agente faria, usa tokens da sua chave, ignora o horário de atendimento e não conhece a ficha de um contato real. Veja Testar o agente.

O que o agente precisa para entender áudio?

Um token da OpenAI ou da Groq escolhido como chave de transcrição de áudio. Sem isso, só os modelos Gemini ouvem o áudio direto.

A transferência para humano avisa a equipe?

Não sozinha. Para avisar, monte um funil com o gatilho Agente IA encerrou atendimento e uma notificação ou tarefa.

#Integrações

O Tracker aparece conectado, mas não chega nada. Por quê?

A conta do Tracker está com os eventos desligados para o Leadz. A escolha fica no Tracker, na tela de integrações. Veja Sparkle Tracker.

Os eventos do Tracker colocam tag no contato?

Não. Para marcar com tag, use o gatilho Evento do Sparkle Tracker num funil e aplique a tag ali.

Por que o webhook não criou o contato?

Falta mapear o Nome, ou o comportamento do webhook está em «Só vincular». O motivo aparece no próprio evento recebido. Veja Webhooks de entrada.

Postback cria contato novo?

Não. Ele só atualiza quem já existe, encontrado por telefone, e-mail, ID do contato ou um código da origem. Veja Postbacks.

O webhook de saída tenta de novo se falhar?

O bloco Webhook não. O bloco HTTP Request repete até 3 vezes, se você ligar a opção, e só em erro do outro servidor, excesso de chamadas ou falha de rede. Veja HTTP Request.

#Conta, plano e segurança

Como troco a minha senha?

Pela tela de entrada, em Esqueci minha senha. O link vale 1 hora e funciona uma vez. Trocar a senha encerra as sessões nos outros aparelhos. Veja Criar conta e entrar.

Quantas pessoas posso convidar?

Depende do seu plano. Convite pendente também ocupa vaga, e o link do convite vale 7 dias. Veja Equipe e cargos.

Como limito o que um atendente vê?

Pelo cargo, que define as telas, e pelas contas de canal, que definem os números e páginas que ele atende no Chat de conversas.

O que acontece quando atinjo o limite de contatos?

Nenhum contato novo entra, nem pela tela, nem por importação, nem por webhook. Os que já existem continuam. Veja Planos e limites.

Onde vejo meu consumo e mudo de plano?

Em Financeiro: «Seu consumo» mostra o uso e «Mudar de plano» traz os planos. Só Dono e Administrador concluem a troca. Os preços estão em sparkleleadz.com/planos.

Posso ter mais de um workspace?

Sim. Cada plano cobre um workspace. Em Novo workspace você contrata o plano do novo ambiente e dá o nome. Veja Workspaces.

O Leadz tem verificação em duas etapas?

Sim, opcional, por aplicativo autenticador, com 10 códigos de recuperação. Cada pessoa ativa a sua. Veja Segurança e verificação em duas etapas.

Como apago todos os dados de uma pessoa que pediu?

Na ficha do contato, aba Informações, seção «Dados do contato», use Apagar tudo deste contato e digite APAGAR TUDO. Não tem volta. Veja Seus dados.

#Não achou a sua dúvida?

Este artigo ajudou?

Mais em Ajuda