Instalar o Chatbot no site

Depois de criar e configurar o Chatbot, falta colocar no ar. A aba Instalar guia em três passos e oferece quatro formas de uso: um botão em todas as páginas do site, um link direto, o chat aberto dentro de uma página ou um arquivo pronto.

#Antes de começar

• O chatbot precisa estar publicado. Rascunho não aparece para ninguém.
• Para usar no seu site, o endereço do site precisa estar em Domínios autorizados, na aba Site e IA.
• O site precisa abrir em https.
• Você precisa de acesso para editar o código ou o rodapé do site. Se outra pessoa cuida do site, envie a ela o código do passo 3.

#Abrir a aba Instalar

No topo da aba, um quadro mostra o estado da instalação:

#Instalar no seu site

É a forma mais comum: um botão no canto de todas as páginas.

O código tem este formato. A sua chave aparece no lugar de pk_live_SUA_CHAVE:

<script src="https://chat.sparkleleadz.com/loader.js" data-key="pk_live_SUA_CHAVE" async></script>

Copie sempre pela tela, para a chave vir certa.

#Em construtores de site

Em plataformas de criação de site e de página de vendas, procure o campo de código personalizado do rodapé (às vezes chamado de «código antes de </body>» ou «scripts do rodapé») e cole o código ali. O nome e o lugar do campo mudam de plataforma para plataforma: consulte a ajuda da sua.

#Quais endereços autorizar

• loja.com.br e www.loja.com.br contam como o mesmo site. Basta adicionar um.
• Outros subdomínios, como curso.loja.com.br, precisam ser adicionados. Para liberar todos de uma vez, use *.loja.com.br.
• O chat só abre nos sites da lista. É o que impede outra pessoa de usar o seu chat no site dela.

#Usar como link (bio e anúncios)

Para quem não tem site ou quer um link direto para o chat.

Para anúncios, use o Link para anúncio. Ele traz o final ?utm_source=facebook&utm_medium=paid&utm_campaign=nome-da-campanha. Troque nome-da-campanha pelo nome da sua campanha: é ele que aparece no contato e nos números da aba.

A página mostra o seu nome e o aviso de que as ofertas são de sua responsabilidade. Ela não entra em buscadores.

#Abrir o chat dentro de uma página

Para mostrar o chat já aberto em um espaço da página, sem botão. Por exemplo, em uma página de contato.

O código tem este formato:

<div data-sparkle-chat style="height:600px"></div>
<script src="https://chat.sparkleleadz.com/loader.js" data-key="pk_live_SUA_CHAVE" async></script>

Para mudar a altura do chat, troque o 600px da primeira linha. O domínio da página também precisa estar autorizado.

#Usar o arquivo HTML

Para quem quer uma página pronta, só com o chat, no próprio servidor.

#Como testar

Para testar antes de instalar, use a Prévia ao vivo do editor. O teste da prévia fica só no seu navegador.

#Mais opções

No fim da aba, Mais opções reúne recursos opcionais.

#Evento de lead no Pixel e no GTM

Ligue Enviar o evento Lead para avisar o Pixel da Meta e o Google Tag Manager quando a pessoa se identifica no chat. Nenhum dado dela é enviado.

• Se o seu site já tem o Pixel ou o GTM, deixe ID do Pixel e ID do GTM em branco: o evento vai pelo que já está lá.
• No GTM, o evento personalizado se chama sparkle_chat_lead.
• Na página hospedada (link do chat), só o Pixel funciona.
• Informe na sua política de privacidade que você usa Pixel ou GTM.

#Domínio próprio

Faz o chat abrir em um endereço do seu site, como chat.suaempresa.com.br. Depende do seu plano.

#Identificar quem já fez login no seu site

Se o seu site tem área de membros, o chat pode reconhecer o usuário logado. A conversa vai para o contato certo, e a pessoa encontra o histórico em qualquer aparelho. Essa parte exige programação no seu site: a tela traz guias para WordPress, Google Tag Manager, React e Next.js e Outro sistema. Envie a quem cuida do site. Sem isso, o chat funciona normalmente.

#Avisos para o seu sistema e Sparkle Tracker

• Avisos para o seu sistema: o chatbot chama um endereço seu quando algo importante acontece. É uma integração para programadores. Nenhum aviso leva o texto das mensagens.
• Enviar ao Sparkle Tracker os leads com telefone, com a origem da visita: liga o envio dos leads do chat para o Sparkle Tracker.

#Resultado por campanha

No fim da aba, Resultado por campanha mostra Pessoas, Conversas e Leads por origem e campanha, no período escolhido. A origem vem dos parâmetros do link, como no Link para anúncio.

#Problemas comuns

Colei o código e o chat não aparece

Confira, nesta ordem:

1. O chatbot está publicado, e não em rascunho nem Pausado.
2. O endereço do site está em Domínios autorizados, escrito igual ao do navegador (um subdomínio diferente precisa ser adicionado).
3. O site abre em https.
4. O código foi colado inteiro, uma vez, antes de </body>.
5. A página foi publicada na sua plataforma e o cache foi limpo. Teste em janela anônima.

O estado continua «Aguardando a primeira visita»

O chat ainda não foi aberto em um site autorizado. Abra uma página do seu site depois de colar o código. Se o chat não aparecer, siga a lista acima.

«Não consegui copiar sozinho. Selecione o código e copie com Ctrl+C.»

O navegador bloqueou a cópia automática. Clique dentro do quadro do código, selecione tudo e copie manualmente.

«Ligue a página acima e publique: o link aparece aqui.»

Na opção Link e anúncios, o link só existe depois de ligar Usar página hospedada e publicar.

«Publique o chatbot para ter este código.»

O código da opção Dentro de uma página só é gerado com o chatbot publicado.

O domínio próprio continua em «Aguardando verificação»

Os registros de DNS ainda não foram encontrados. Confira se criou os dois, com nome e valor iguais aos da tela, e clique em Verificar de novo depois de alguns minutos.

Mudei as cores e o site não mudou

A mudança ficou no rascunho. Clique em Publicar alterações. O código do site não precisa ser trocado.

#Veja também

• Chatbot do site
• Visão geral dos canais