Chatbot do site

O que ele faz

• Fluxos roteirizados criados no Studio: saudações, botões, perguntas e captação de leads.
• Respostas de IA a partir do conteúdo publicado do seu próprio site, pagas com os créditos de IA do seu plano. Quando não restam créditos, o bot dá a sua mensagem de fallback.
• Aparência e gatilhos: cores, imagem do botão de abertura e quando ele abre, definidos por site no Studio.
• Proteção Turnstile quando a conversa parece automatizada.
• Leads: os dados que um visitante compartilha em uma etapa de lead chegam em Forms & leads → Leads, como os contatos dos formulários.

Ainda não há transferência ao vivo para um atendente humano.

No site no ar

Os chatbots seguem para o Production dentro dos releases. Quando o Production está ativado e há um release assinado no ar, o chatbot do release atende visitantes reais, usando o conhecimento das páginas desse release (até 5.000 trechos). As alterações feitas em Development só chegam aos visitantes com o próximo release aprovado.

Enquanto o Production está desativado, os endereços do chatbot respondem 404 CP_NOT_FOUND; com o Production ativado mas sem release no ar, 403 CP_PRODUCTION_LOCKED.

Adicione-o a um site Next.js

1. Renderize o widget uma vez no seu layout raiz. Ele não precisa de token: o navegador fala diretamente com o Atlas, e o Atlas só aceita a origem registrada do seu site.

   app/atlas-chat.tsx

   'use client';
   import { AtlasChat } from '@atlas/chat-widget';
   import '@atlas/chat-widget/styles.css';
   import { usePathname } from 'next/navigation';
   
   export function SiteChat() {
     const path = usePathname();
     return (
       <AtlasChat
         apiOrigin="https://delivery.atlas.example"
         environmentId="env_XXXXXXXX"
         botKey="support"
         path={path}
       />
     );
   }

2. Permita o Atlas na sua Content-Security-Policy: adicione a origem da API do Atlas a connect-src e img-src.

3. Use o id do ambiente de Production no seu deploy no ar e o de Development em todos os outros lugares.

O pacote do widget é distribuído diretamente aos clientes conectados; ele ainda não está no registro público do npm. Sem React, use o cliente simples createChatClient({ apiOrigin, environmentId, botKey }), que oferece bot(), start(path) e send(…).

Privacidade

• As conversas são ligadas a um segredo aleatório guardado no session storage do visitante. Não há cookies.
• Os dados do lead só são armazenados quando o visitante os envia em uma etapa de lead.
• Limites de taxa se aplicam por endereço IP e por conversa; veja Limites.

O que ler a seguir

Trabalhar com leadsEndpoints do navegador