Chat con Usuario y Contraseña

Qué es

El Chat con Usuario y Contraseña es una forma de publicar el chatbot en la que todos los visitantes usan el mismo usuario y contraseña para abrir el chat. Funciona como una “portería”: quien tiene la contraseña entra y conversa; quien no, solo ve la pantalla de acceso.

1. Cuándo usarlo

Usa el modo Usuario y Contraseña cuando quieres que:

• Solo un grupo cerrado use el chat (equipo, clientes VIP, beta testers, evento);
• La distribución sea simple: un enlace + una contraseña, sin desarrollo;
• O incrustar el chat en un sitio, pero exigiendo una contraseña antes de la conversación.

⚠️ Importante: la contraseña es compartida — todos usan la misma. Controla el acceso, pero no identifica individualmente a cada visitante. Si necesitas saber quién es cada usuario, el modo correcto es el Intranet (Acceso Autenticado) — consulta la guía específica.

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 (ej.: “Área de soporte restringida”);
   • Tipo de integración: selecciona “Acceso con Usuario y Contraseña”;
   • Usuario de acceso: el usuario que se escribirá en la pantalla de entrada del chat;
   • Contraseña de acceso: mínimo 6 caracteres.
5. Haz clic en Guardar Publicación.

🔒 La contraseña se almacena de forma segura (hash) y no podrá ser visualizada después — anótala en un lugar seguro. Si la pierdes, podrás restablecerla en la tarjeta de la 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:

3.1 Enlace de acceso

Un enlace directo a una página de chat exclusiva, en el formato:

https://.../TU_CHATBOT_ID?public_api_key=ct_...

Es la forma más rápida de distribuir: envía el enlace + usuario + contraseña a quien debe tener acceso. Al abrirlo, la persona verá la pantalla de entrada del chat.

3.2 Usuario de acceso

El usuario definido en la creación, siempre visible en la tarjeta para consulta.

3.3 Restablecer contraseña

Como la contraseña actual no puede ser visualizada, la tarjeta ofrece el botón “Restablecer”: ingresa una nueva contraseña (mínimo 6 caracteres) y pasa a valer inmediatamente. La contraseña antigua deja de funcionar.

3.4 Código de instalación (script)

Alternativa al enlace: el mismo código de script del modo Público, para incrustar el chat en tu sitio — con la diferencia de que el chat abre en la pantalla de login en lugar de abrir directamente:

<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>

4. Cómo se conecta todo

┌─────────────────────┐                        ┌──────────────────────┐
│  Visitante abre el  │  1. accede al enlace   │  Página del chat     │
│  enlace o el sitio  │ ─────────────────────▶ │  (pantalla de login  │
└─────────────────────┘                        │  con la imagen del   │
                                               │  bot)                │
                                               └──────────┬───────────┘
                                                          │ 2. escribe usuario + contraseña
                                                          ▼
                                               ┌──────────────────────┐
                                               │  API Caramelo        │
                                               │  → verifica la       │
                                               │    contraseña (hash) │
                                               │  → aplica límite de  │
                                               │    intentos          │
                                               └──────────┬───────────┘
                                                          │ 3. acceso liberado
                                                          ▼
                                               ┌──────────────────────┐
                                               │  Conversación        │
                                               │  abierta, con el     │
                                               │  historial de ese    │
                                               │  navegador           │
                                               └──────────────────────┘

En resumen:

1. El visitante abre el enlace de acceso (o la página del sitio con el script);
2. En lugar de la conversación, aparece una pantalla de login personalizada con los colores y el avatar de tu chatbot;
3. Escribe el usuario y la contraseña compartidos;
4. La plataforma verifica las credenciales y libera la conversación.

5. Cómo funciona el acceso del visitante

💡 Buenas prácticas: cambia la contraseña periódicamente (botón “Restablecer”), evita contraseñas obvias y, si alguien deja el grupo, restablece la contraseña y distribuye la nueva.

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, la pestaña llama la atención y el chat queda brillando;
• Renderizar en un lugar fijo de la página: muestra el chat dentro de un área específica de tu sitio, en lugar de flotante.

Estas opciones valen para el modo script; la pantalla de login siempre usa los colores y el avatar configurados en el chatbot.

7. Preguntas frecuentes