Cadastrar o site

Tela: Comece por aqui · Endereço: /inicio · Passo 1 — Cadastre o seu site

Tudo no Data Lead é organizado por site: conversas, leads, conhecimento, playbooks, gatilhos e roteamento pertencem a um site. Por isso o cadastro do site é o primeiro passo — sem ele não há chave, não há snippet e não há agente.

Os dois campos

Clique em Cadastrar e ler o site.

O domínio

Você pode colar o endereço do jeito que tiver à mão. A tela normaliza antes de gravar:

A dica abaixo do campo diz exatamente isso: "Pode colar o endereço completo — a gente limpa o resto."

Endereços que não são aceitos

Alguns endereços são recusados de propósito, com a mensagem Esse endereço não pode ser usado.:

• localhost;
• faixas de rede privada e loopback (10.x, 127.x, 192.168.x, 172.16–31.x, 169.254.x);
• domínios terminados em .local, .internal, .localhost, .test, .invalid e .example.

O motivo é de segurança: quem lê o seu site é o servidor do Data Lead, e um "domínio" apontando para uma rede interna seria uma porta aberta para alcançar sistemas que não são seus.

Um endereço mal formado — ou um endereço de IP puro, como 1.2.3.4 — mostra Informe um domínio como minhaloja.com.br.

Um site por domínio

Recarregar a página, clicar duas vezes ou voltar no navegador não cria um segundo site: a conta e o domínio juntos identificam o site. Isso importa porque dois sites com o mesmo domínio significariam dois widgets disputando a mesma página — e os seus números partidos em dois.

No assistente, reenviar o mesmo domínio simplesmente continua para o passo seguinte. Em Adicionar site (abaixo), o mesmo domínio é recusado com "Esta conta já tem um site nesse endereço. Cada domínio tem um site só — é ele que dá a chave do widget.", porque ali você pediu um site novo e receber "pronto!" faria você procurar um site que não foi criado.

Cadastrar o segundo site (e o terceiro)

Tela: Instalação · Endereço: /instalacao

O assistente só mostra o passo 1 enquanto a conta não tem nenhum site. Depois do primeiro, o cadastro fica em Instalação, no botão Adicionar site ao fim da lista de sites. O formulário é o mesmo — Nome do site e Endereço do site — e as regras de domínio, origens permitidas e leitura do conteúdo valem igual.

Uma conta sem site nenhum abre essa tela já com o formulário aberto: sem site não há chave, e sem chave não há snippet.

O site novo nasce com chave, agente, playbooks e números próprios. Nada é herdado do site anterior: o conteúdo é lido de novo, e o agente é gerado a partir dele.

Com dois ou mais sites, o seletor de site aparece no topo do painel — veja Seletor de site.

As origens permitidas

Ao cadastrar o site, o Data Lead libera automaticamente duas origens:

https://minhaloja.com.br
https://www.minhaloja.com.br

As origens permitidas são a lista de endereços de onde o widget pode conversar com o Data Lead. Toda chamada do widget ao servidor traz a origem da página, e ela é conferida contra essa lista: uma origem fora dela é recusada. É o que impede que alguém copie o seu snippet e use a sua conta em outro site.

Só endereços https:// entram na lista. Um site que ainda serve em texto claro não deveria receber formulário de lead, e liberar http:// por padrão seria autorizar isso em toda conta nova.

Precisa liberar um subdomínio (loja.minhaloja.com.br, um ambiente de homologação, um domínio de campanha)? Isso ainda não é editável pelo painel — fale com o suporte da Data Stone com a lista de endereços.

A chave do site

A chave do site (a site key) é o identificador público que vai dentro do snippet. É por ela que o Data Lead sabe de qual site vem cada visitante, qual playbook usar e onde gravar a conversa.

Três coisas a saber sobre ela:

1. É pública, e tudo bem. Ela fica visível no código-fonte da sua página, como o identificador de qualquer tag de analytics. Quem protege a sua conta é a lista de origens permitidas, não o sigilo da chave.
2. É diferente em cada site. Como diz a tela de Instalação: "Cada site tem uma chave própria — o código muda de site para site, não de plataforma."
3. Não é um token de API. A chave do site não lê leads nem conversas; ela só serve ao widget. As credenciais de leitura e escrita da API são outras, criadas em Configurações.

Você não precisa copiar a chave manualmente: o snippet exibido em Instalação já vem com ela dentro.

O que acontece logo depois do cadastro

1. O domínio entra na fila de leitura como fonte de conhecimento (até 100 páginas, só públicas).
2. O e-mail de boas-vindas é enviado — uma vez por conta.
3. O assistente avança para o passo 2, Gere o agente.

Se a leitura não conseguir começar, a tela avisa: "Site cadastrado, mas não conseguimos começar a leitura do conteúdo. Tente de novo em Agente." O site foi criado — não cadastre de novo. Retome a leitura em Agente → Conhecimento, adicionando o endereço do site como fonte.

Gerar o agente cria o playbook, mas não o ativa. Enquanto nenhum playbook estiver ativo, o agente conversa e não qualifica ninguém — veja Playbooks e slots.

Veja também

• Primeiro acesso: o assistente do Início
• Instalar o snippet
• Conhecimento: fontes do agente
• Glossário

Precisa de ajuda?

Fale com o suporte da Data Stone pelo canal combinado no seu contrato. Para liberar subdomínios ou trocar o domínio de um site já cadastrado, envie o nome do site e a lista de endereços.