Ir al contenido
API de entrega
Antes de planificar en torno a una función, consulte el estado de las capacidades.

GuíasInteracción

Chatbot del sitio web

Añada un chatbot de Atlas a su sitio web, con flujos guionizados, respuestas de IA basadas en su propio contenido y captación de clientes potenciales.

Esta página fue traducida del inglés. Si hay alguna diferencia, prevalece la versión en inglés. Leer en inglés

  • Flujos guionizados creados en Studio: saludos, botones, preguntas y captación de clientes potenciales.
  • Respuestas de IA a partir del contenido publicado de su propio sitio, pagadas con los créditos de IA de su plan. Cuando no quedan créditos, el bot da su mensaje de respaldo.
  • Apariencia y activadores: colores, imagen del lanzador y cuándo se abre, definidos por sitio en Studio.
  • Protección Turnstile cuando la conversación parece automatizada.
  • Clientes potenciales: los datos que un visitante comparte en un paso de captación llegan a Forms & leads → Leads, como las consultas de los formularios.

Todavía no hay traspaso en directo a un agente humano.

Los chatbots viajan a Producción dentro de los lanzamientos. Cuando Producción está activada y hay un lanzamiento firmado en vivo, el chatbot publicado responde a visitantes reales, usando el conocimiento de las páginas de ese lanzamiento (hasta 5.000 pasajes). Los cambios de Desarrollo llegan a los visitantes solo con el siguiente lanzamiento aprobado.

Mientras Producción está desactivada, las direcciones del chatbot responden 404 CP_NOT_FOUND; con Producción activada pero sin lanzamiento en vivo, 403 CP_PRODUCTION_LOCKED.

  1. Muestre el widget una vez en su diseño raíz. No necesita ningún token: el navegador habla directamente con Atlas, y Atlas solo acepta el origen registrado de su sitio web.

    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 Atlas en su Content-Security-Policy: añada el origen de la API de Atlas a connect-src y img-src.

  3. Use el id del entorno de Producción en su despliegue en vivo, y el de Desarrollo en todos los demás.

El paquete del widget se distribuye directamente a los clientes conectados; todavía no está en el registro público de npm. Sin React, use el cliente simple createChatClient({ apiOrigin, environmentId, botKey }), que ofrece bot(), start(path) y send(…).

  • Las conversaciones están vinculadas a un secreto aleatorio guardado en el almacenamiento de sesión del visitante. No hay cookies.
  • Los datos del cliente potencial solo se almacenan cuando el visitante los envía en un paso de captación.
  • Se aplican límites de frecuencia por dirección IP y por conversación; consulte Límites.