Chat Público (Script o Enlace)

Qué es

El Chat Público es la forma más simple de publicar el chatbot: copias un código listo y lo pegas en tu sitio. Cualquier visitante puede hablar con el bot — sin login, sin backend, sin configuración de servidor.

1. Cuándo usarlo

Usa el modo Público cuando quieres que:

• Cualquier persona que acceda al sitio pueda iniciar una conversación;
• La instalación sea solo copiar y pegar un código, sin tocar el servidor;
• El chat aparezca como un globo flotante (o incrustado en un área fija de la página).

2. Configurando en la plataforma

1. Accede a tu Proyecto → menú Chatbots → selecciona el chatbot deseado.
2. Haz clic en la pestaña Publicar y luego en la subpestaña Sitios.
3. Haz clic en Agregar.
4. En el modal “Publicar en Sitios o Sistemas Web”, completa:
   • Nombre de la publicación: un nombre interno para identificar esta conexión (ej.: “Sitio institucional”);
   • Tipo de integración: selecciona “Pública (Script o Enlace)”.
5. Haz clic en Guardar Publicación.

¡Listo! La nueva conexión aparece en el Listado de publicaciones.

3. Qué muestra la plataforma después de crear

Al expandir la publicación, verás el código de instalación listo para copiar:

<script>
  var carameloaiChatbot = {
    publicApiKey: "ct_...",
    project_id: "TU_PROJECT_ID",
    pluginVersion: "VERSIÓN_DEL_PLUGIN"
  };
</script>
<script src="https://static.carameloai.com/prod/index.js"></script>

Para instalar: pega ese código antes del </body> en todas las páginas del sitio donde el chat debe aparecer. Eso es todo — no necesitas backend ni configuración de servidor.

3.1 Entendiendo cada campo del código

💡 Consejo: a medida que cambias las configuraciones visuales (sección 6), el código mostrado en la plataforma se actualiza automáticamente con los parámetros correspondientes. Copia el código después de hacer tus ajustes.

3.2 Probando sin instalar nada

En el título de la tarjeta de la publicación hay un botón de enlace externo (ícono 🔗): abre una página de prueba con tu chatbot funcionando, para que valides la experiencia antes de pegar el código en el sitio.

3.3 Cambiando el chatbot de la publicación

En la propia tarjeta hay un selector de chatbot: puedes cambiar qué bot atiende esa publicación en cualquier momento, sin cambiar el código instalado en el sitio.

4. Cómo se conecta todo

┌─────────────────────┐                        ┌──────────────────────┐
│  Visitante abre tu  │   1. la página carga   │  Tu sitio            │
│  sitio              │ ─────────────────────▶ │  (script del chat    │
└─────────────────────┘                        │  pegado en el HTML)  │
                                               └──────────┬───────────┘
                                                          │ 2. el script genera un ID
                                                          │    anónimo para el visitante
                                                          ▼
                                               ┌──────────────────────┐
                                               │  API Caramelo        │
                                               │  → valida la clave   │
                                               │    pública           │
                                               │  → crea la conversac.│
                                               └──────────┬───────────┘
                                                          │ 3. chat disponible
                                                          ▼
                                               ┌──────────────────────┐
                                               │  Globo del chat en   │
                                               │  la esquina de la    │
                                               │  pantalla, listo     │
                                               └──────────────────────┘

En resumen:

1. El visitante abre una página de tu sitio;
2. El script del chat carga y crea un identificador anónimo para ese navegador;
3. La plataforma valida la clave pública y abre la conversación;
4. El globo del chat aparece en la esquina de la pantalla.

5. Cómo se identifica al visitante

A diferencia del modo Intranet, aquí no hay login: la plataforma genera automáticamente un ID anónimo (ej.: user-a1b2c3...) que queda guardado en el navegador del visitante.

📌 ¿Necesitas saber quién es el visitante? Puedes configurar el chatbot para pedir datos (nombre, e-mail, teléfono) durante la conversación. Y si tu sitio tiene área logueada y quieres la identidad garantizada por tu sistema, el modo correcto es el Intranet (Acceso Autenticado) — consulta la guía específica.

6. Configuraciones visuales del chat

En la tarjeta de la publicación, columna “Configuraciones”, ajustas el comportamiento del widget (haz clic en Guardar después de modificar):

• Posición del chat en el sitio: esquina de la pantalla donde aparece el globo;

• Iniciar y mantener la caja de conversación abierta: el chat queda siempre abierto, sin opción de cerrar;

• Modo Compacto: el chat ocupa el menor tamaño posible;

• Retención de Atención: después de un tiempo de inactividad (10 segundos por defecto, ajustable en “Timer de Ausencia”), la pestaña del navegador llama la atención y el chat queda brillando para que el visitante vuelva;

• Retención con inicio oculto: el chat no carga de inmediato — solo aparece después de un tiempo de inactividad (definido en “Tiempo de espera”), llamando la atención de la misma forma;

• Renderizar en un lugar fijo de la página: en lugar de flotar, el chat se muestra dentro de un área tuya. Al activarlo, la plataforma muestra un código de <div> para pegar donde el chat debe aparecer:

  <div id="chatbox_ID_DE_LA_PUBLICACIÓN"></div>
  

⚠️ Atención: “Retención de Atención” e “Inicio oculto” son opciones que se desactivan mutuamente — marcar una desmarca la otra.

7. Preguntas frecuentes