Cada bloco abaixo é uma pergunta independente. Para procedimentos completos, siga os links no fim de cada resposta.
Produto
O que é o Data Lead?
É um assistente de conversa com IA que você instala no seu site. Ele aborda o visitante, responde com base no conhecimento da sua empresa, qualifica o interesse e entrega o lead ao seu time — por WhatsApp, reunião marcada, CRM ou webhook.
O Data Lead responde com base em quê?
Nas fontes de conhecimento que você cadastra (o seu site, documentos enviados ou texto livre), no perfil do negócio e no playbook ativo. Ele não inventa link: as respostas são saneadas contra endereços fora dos domínios do seu site.
O agente pode falar qualquer coisa com o visitante?
Ele trabalha dentro de trilhos: o playbook define o que perguntar, em que ordem e quando qualificar. Dado sensível nunca vira campo do playbook, e o assistente não toma decisão automatizada com efeito jurídico sobre a pessoa.
Dá para testar sem colocar no ar?
Sim. Em Agente → Playbooks → Testar este playbook você conversa com o mesmo motor do site. A conversa de teste grava o histórico para você revisar, mas não cria leads, não conta nas métricas e não publica conversões.
Instalação
Como instalo o widget no meu site?
Copie o snippet em Instalação e cole antes do fechamento do </body> em todas as páginas.
É o mesmo código para qualquer plataforma — só o passo a passo muda entre HTML, GTM, WordPress,
Shopify e construtores como Webflow, Wix e Elementor.
O snippet é o mesmo para todos os meus sites?
Não. Cada site tem uma chave própria, e o snippet muda de site para site. Copie o código do cartão do site certo em Instalação.
Como sei que a instalação funcionou?
O Data Lead detecta sozinho: o coletor manda um sinal de vida a cada página visitada, e a tela de Instalação mostra o estado do site e as páginas vistas. O botão Verificar agora adianta essa checagem por até um minuto.
O widget deixa meu site mais lento?
O carregador tem no máximo 2 KB comprimidos e sobe de forma assíncrona; o chat (até 40 KB) só carrega quando o navegador fica ocioso ou no primeiro gesto do visitante. Quem só passa pela página não baixa o chat.
Funciona em site de página única (SPA)?
Sim. O carregador acompanha as trocas de rota sozinho. Não reinjete o snippet a cada navegação.
Agente e conversas
Quanto tempo leva para o agente ficar pronto?
O caminho é: cadastrar o site, gerar o agente (ele lê o seu site e escreve perfil e playbook), instalar o snippet e fazer o primeiro teste. A geração roda em segundo plano e aparece na tela quando termina.
Posso editar o que a IA gerou?
Sim. Perfil do negócio e playbook são editáveis, e o playbook só passa a valer no site depois de você clicar em Ativar.
O agente aborda o visitante sozinho?
Só se você configurar um gatilho (tempo na página, rolagem, intenção de saída, inatividade, páginas visitadas, clique ou abandono de formulário). O gatilho decide quando; a regra decide como. No celular, o painel nunca abre sozinho.
Posso testar duas abordagens diferentes?
Sim, com um experimento A/B, dividido 50/50 por padrão. Os números por variante aparecem nos painéis; não espere diferença visível com poucas dezenas de sessões.
Leads
Quando uma conversa vira lead?
Assim que e-mail ou telefone é confirmado na conversa. O lead nasce com situação em aberto e acompanha o desfecho: qualificado, desqualificado, encaminhado ou encerrado.
O que é o score do lead?
Uma nota calculada por regras do playbook mais um julgamento de IA, com a explicação registrada. Score e desfecho são informação interna: não são enviados ao navegador do visitante.
Consigo exportar meus leads?
Sim, em CSV, pela tela de Leads. A exportação exige sessão de uma pessoa — é o caminho para o contato completo, que a API devolve mascarado.
Como funciona o encaminhamento para o WhatsApp?
O chat mostra um botão que leva ao WhatsApp com um código de atendimento (DL-XXXXXXXX) já
no texto. O código vale 7 dias, registra o clique uma única vez e não leva nenhum dado do
visitante na URL.
Para qual número o lead vai?
Para o número do vendedor roteado, quando há um; senão, para a roleta de números do site,
configurada em Integrações. Você também define o texto pré-preenchido, usando o marcador
{codigo}.
Posso abrir o WhatsApp de um lead pelo painel?
Sim, pela ação Abrir WhatsApp no painel da conversa. Ela abre o WhatsApp direto, sem gastar o código do visitante.
Integrações
Quais CRMs o Data Lead integra?
RD Station e HubSpot por autorização (OAuth) e Pipedrive por token de API. O CRM é por conta e vale para todos os sites dela.
Preciso criar campos no meu CRM?
Sim, uma única vez, para os dados que nenhum CRM tem de fábrica (CNAE, score, resumo da conversa). Se o campo não existir, o contato entra do mesmo jeito — só sem aquele dado.
O que acontece se o meu CRM ficar fora do ar?
Nada se perde. Quando o problema é do provedor — indisponibilidade, limite de chamadas ou tempo esgotado —, o envio é repetido com espera crescente, até 14 tentativas ao longo de cerca de 82 horas. Erros de configuração, mapeamento ou autenticação falham já na primeira tentativa. Nos dois casos a linha aparece no log de entrega e pode ser reenviada de lá.
Como confiro que um webhook veio mesmo do Data Lead?
Pela assinatura no cabeçalho X-DataLead-Signature, no formato t=<segundos>,v1=<hex>: o v1 é
o HMAC-SHA256 de <timestamp>.<corpo cru> com o segredo do endpoint. Aceite apenas assinaturas dentro de uma janela de 5 minutos e ignore entregas com
X-DataLead-Id repetido.
O webhook leva os dados do lead?
Não. O corpo tem apenas identificadores, score e site — sem dado pessoal. Quem precisa do contato busca o lead pela API.
API
Como crio um token da API?
Em Configurações → Tokens da API. Escolha entre somente leitura (padrão) e leitura e escrita. O token aparece uma única vez: copie e guarde num cofre de segredos.
Perdi meu token. E agora?
Gere outro e revogue o antigo. Não há como exibir de novo um token já criado — o sistema guarda apenas um resumo criptográfico dele.
Onde está a documentação da API?
Em GET /api/v1/openapi.json, um documento OpenAPI 3.1 público. Cole no Swagger UI, no Postman
ou no gerador de cliente da sua preferência.
Por que os contatos vêm mascarados na API?
Porque um token de leitura não pode ser a porta dos fundos para o contato completo de todos os leads. Para o dado inteiro, use a exportação em CSV da tela de Leads.
Planos
O que muda entre os planos?
| Grátis | Pro | Full | |
|---|---|---|---|
| Identificações por mês | 100 | 1 000 | 10 000 |
| Remover a marca do widget | não | sim | sim |
| Integração com CRM | não | sim | sim |
| Webhooks de saída | não | sim | sim |
| Conversão para mídia paga | não | sim | sim |
O que conta como uma "identificação"?
Um sujeito distinto no mês — o visitante identificado ou a conversa enriquecida. A cascata de um mesmo contato conta como uma identificação só.
O que acontece se eu estourar o limite do mês?
As conversas continuam normalmente. O que para são as identificações e os enriquecimentos novos, com aviso na tela de uso a partir de 80% do limite.
Como mudo de plano?
Clique em Solicitar upgrade — o botão está no cartão Plano, em Configurações, e também em todo recurso bloqueado por plano em Integrações. Ele abre um e-mail para a Data Stone já com o seu plano atual e o recurso que você tentou usar preenchidos. O cartão de plano continua somente leitura: não há compra automática dentro do painel nesta versão.
LGPD
O widget respeita o meu banner de cookies?
Sim. Quando a página tem Cookiebot ou OneTrust, o Data Lead não mostra faixa nenhuma e segue o que o seu gerenciador informar. A faixa do Data Lead cobre só o assistente — ela não é um gerenciador de cookies.
O que o widget coleta de quem não aceita nada?
O necessário para a conversa: mensagens, um identificador de sessão que morre com a aba, a página da conversa e o IP truncado no registro de consentimento. Além disso, o coletor mede a navegação: página, título, referenciador, campanha, tipo de aparelho e idioma — sem nenhum identificador persistente.
Como atendo um pedido de exclusão de dados?
Em Configurações → Direitos do titular: procure a pessoa por e-mail, telefone ou
identificador, baixe o pacote de dados e exclua tudo digitando a palavra EXCLUIR. O prazo
legal de resposta é de até 15 dias.
Por quanto tempo os dados ficam guardados?
Pelo prazo que você definir em Configurações → Privacidade e retenção: de 30 a 1095 dias para conversas sem lead, sessões e eventos (padrão 365), e de 90 a 3650 dias para leads — ou em branco para guardar sempre (o padrão). A conversa que gerou um lead segue o prazo do lead, não o dos dados brutos: ela é a explicação daquele contato.
Equipe
Como convido alguém para a minha conta?
Em Configurações → Equipe, informe o e-mail e escolha o papel. O convite vale 7 dias e só pode ser aceito pelo endereço convidado, com e-mail já confirmado.
Quantos papéis existem e o que cada um faz?
Quatro: Dono (conta inteira, inclusive plano), Administrador (agente, integrações, equipe e LGPD), Vendedor (painel e ação sobre os leads) e Leitura (só consulta).
Como transfiro a propriedade da conta?
Pelo suporte. O papel de dono não é atribuído pela tela — nem por um administrador.
Veja também
Precisa de ajuda?
Fale com o suporte da Data Stone pelo canal combinado com a sua conta. Diga o nome do site e a tela em que você estava — isso encurta o atendimento pela metade.