Instale o widget de chat do ZapClaw no seu site

Em resumo: o widget é uma única tag de script. Você a cola uma vez no seu site, um balão de chat aparece e seu agente do ZapClaw responde aos visitantes com o conhecimento que você deu a ele. O chat roda num frame no domínio do próprio ZapClaw, chat.zapclaw.app, e por isso nunca lê a sua página.

O snippet

<script async src="https://chat.zapclaw.app/loader.js" data-widget-id="YOUR_WIDGET_ID"></script>

Copie o snippet exato do seu widget na área Agents do painel. O id acima é um exemplo: o seu é diferente.

O async impede que o loader atrase a sua página, e o loader só cria o frame do chat quando um visitante abre o balão pela primeira vez.

Escolha a sua plataforma

• WordPress, para um site hospedado por você.
• WordPress.com, nos planos que permitem plugins.
• Google Tag Manager, com uma tag de HTML personalizado.

Qualquer outro construtor de sites que permita adicionar um script a todas as páginas funciona do mesmo jeito: cole o snippet onde a plataforma aceita código personalizado, em geral o rodapé ou logo antes da tag body de fechamento. Alguns planos gratuitos não aceitam código personalizado, e nesse caso o widget não pode ser instalado ali.

Sites permitidos. No painel, inclua o endereço do seu site nos sites permitidos do widget, exatamente como os visitantes o veem. https://www.example.com e https://example.com são dois endereços diferentes. Um site que não está na lista não mostra o balão.

Se o seu site tem uma Content Security Policy

A maioria dos sites não precisa de nada aqui. Um site com uma Content Security Policy rígida acrescenta duas entradas à sua política, e nada mais:

script-src https://chat.zapclaw.app
frame-src https://chat.zapclaw.app

• script-src permite que a página carregue o pequeno arquivo do loader.
• frame-src permite que a página mostre o frame do chat.
• Só se a sua política também restringe connect-src (ou não tem connect-src mas restringe default-src), acrescente também connect-src https://chat.zapclaw.app. O loader lê dali o visual do seu balão antes de desenhá-lo.
• Nenhuma entrada de style-src é necessária: o loader aplica os estilos pela API de estilos do navegador, nunca por uma tag de estilo inline.

Acrescente o endereço à diretiva que você já tem. Se você não tem script-src nem frame-src, o navegador recorre ao default-src, então acrescente nele.

Modo anônimo

O widget destes guias funciona no modo anônimo: ele não sabe quem é o visitante. Mesmo assim responde com as bases de conhecimento que você marcou como públicas, coleta um contato quando precisa de um e passa o caso para uma pessoa quando deve.

Reconhecer um visitante logado exige um token de identidade assinado, gerado pelo seu próprio servidor. Um site sem servidor ou sem desenvolvedor, como um site num construtor de páginas ou no WordPress.com, continua anônimo, e um visitante anônimo nunca alcança as bases que você manteve privadas.

O que o widget faz no seu site

• Sem cookies, sem rastreamento. Ele não grava cookie e não carrega analytics, pixel nem terceiros na sua página.
• Nada gravado no seu domínio. A única coisa que ele guarda é um id de sessão aleatório, dentro do frame do chat, em chat.zapclaw.app. Os navegadores mantêm esse armazenamento separado para cada site.
• Ele não lê a sua página. O chat roda num frame de outro domínio e por isso não enxerga seus formulários nem seu texto.
• O visitante é avisado de que é uma IA. O chat abre com um aviso de que as respostas vêm de uma IA e diz como falar com uma pessoa.

Uma frase para a sua política de privacidade

O widget trata o que seus visitantes digitam, em seu nome, então a sua política de privacidade deve dizer isso. Você pode adaptar esta frase:

O assistente de chat deste site é fornecido pelo ZapClaw, que trata as mensagens digitadas pelos visitantes em nosso nome, como nosso operador. O chat não grava cookies neste site, e as conversas são mantidas por 90 dias.

É um ponto de partida, não aconselhamento jurídico: adapte-a à sua política e às leis que se aplicam a você. Como o ZapClaw trata os dados está na Política de Privacidade.

Confira se funcionou

1. Abra o seu site numa janela privada, para que nenhum cache nem extensão atrapalhe.
2. Procure o balão no canto que você escolheu. Abra-o e envie uma pergunta que o seu agente saiba responder.
3. Sem balão? Confira, nesta ordem: o agente está publicado, o widget está ativo, o seu endereço está nos sites permitidos, o snippet está na página (veja o código-fonte da página e procure por chat.zapclaw.app) e nenhum bloqueador de conteúdo nem Content Security Policy o impede.

Outros guias de instalação

• WordPress, para um site hospedado por você.
• WordPress.com, nos planos que permitem plugins.
• Google Tag Manager, com uma tag de HTML personalizado.