Skip to main content

Documentation Index

Fetch the complete documentation index at: https://semantiks.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

El Chat Externo te da una URL compartible que abre un chat a página completa con tu agente de IA. Es la forma más rápida de poner a tu agente frente a los usuarios: solo copia el enlace y envíalo.

Características Principales

  • Compartir al instante: Copia la URL y compártela por correo electrónico, redes sociales, códigos QR o cualquier plataforma de mensajería.
  • Sin necesidad de embeber: El chat funciona en su propia página, sin cambios en tu sitio web.
  • Experiencia de conversación completa: Soporta texto, imágenes, adjuntos, píldoras de escalación y toma de control por agente humano.
  • Dominio personalizado: Sirve el Chat Externo desde tu propio dominio (ej. chat.ejemplo.com/ai-agent) para una experiencia de marca.

Agrupación de Mensajes

Los mensajes consecutivos del mismo remitente se agrupan visualmente para una vista de conversación más limpia:
  • Solo el último mensaje del grupo muestra la marca de tiempo.
  • Las formas de las burbujas se adaptan con diferentes bordes para el primer y último mensaje del grupo, creando una apariencia moderna de hilo.
  • Los grupos de diferentes remitentes se separan con un espacio mayor, mientras que los mensajes dentro del mismo grupo están más juntos.

Identidad del Agente Humano

Cuando una conversación se escala a un agente humano, los usuarios finales ven una identificación más rica del agente:
  • El nombre del agente se muestra sobre el primer mensaje de cada grupo de respuestas del agente humano.
  • Un círculo avatar con las iniciales del agente aparece junto al último mensaje del grupo (ej. “AB” para Ana Bermúdez).
  • Si no hay nombre disponible, se muestra la etiqueta por defecto “HA”.
Esta transparencia ayuda a los usuarios a sentirse seguros de que están hablando con una persona real después de una escalación.
Los nombres de los agentes humanos se obtienen automáticamente del perfil del miembro del equipo en Semantiks. Asegúrate de que tu equipo tenga sus nombres configurados en la plataforma.

Cómo Configurar

1

Ve a Conecta > Canales

Abre tu agente y entra a la página Conecta.
2

Abre el Chat Externo

Selecciona la tarjeta del canal de Chat Externo.
3

Copia la URL pública

Usa la opción para compartir y copia el enlace generado.
4

Prueba como usuario final

Abre el enlace en una ventana privada y valida casos de uso reales.

Pestaña de Configuración de dominio

La página de configuración del Chat Externo tiene dos pestañas: Apariencia (para personalizar el aspecto visual) y Configuración de dominio / Domain setup (para gestionar URLs y dominios personalizados). Al abrir la pestaña Domain setup verás dos secciones:

URL por defecto

Todo Chat Externo es siempre accesible en una URL alojada por Semantiks con el formato:
https://<origen-de-tu-consola>/external-chat?agent_id=<agent_id>
Esta URL se muestra en una tarjeta en la parte superior de la pestaña. Puedes:
  • Copiar la URL al portapapeles usando el botón de copiar.
  • Abrirla en una nueva pestaña del navegador usando el botón de enlace externo.
Agregar un dominio personalizado crea un alias—no reemplaza la URL por defecto. Tu Chat Externo sigue siendo accesible en ambas direcciones.

Dominio personalizado

Si quieres que los usuarios lleguen a tu Chat Externo desde tu propio dominio de marca (ej. chat.ejemplo.com), puedes conectar un dominio personalizado. Una vez activo, el chat se sirve en:
https://tu-dominio/ai-agent

Conectar un dominio personalizado

1

Ingresa tu dominio

En el campo Domain, escribe un subdominio completamente cualificado que poseas (ej. chat.ejemplo.com).
2

Haz clic en Connect domain

Se iniciará automáticamente un flujo de Cloudflare Domain Connect. Si tu registrador no soporta Domain Connect, Semantiks mostrará el registro CNAME que necesitas agregar manualmente en tu proveedor de DNS.
3

Agrega registros DNS (si es necesario)

Si se requiere configuración manual, ve a tu registrador de dominio y agrega el registro DNS que se muestra en la consola (tipo, nombre y valor proporcionados).
4

Verifica el estado

De vuelta en la consola, haz clic en el botón Check status junto a tu dominio. Semantiks verificará la propagación DNS y el aprovisionamiento del certificado SSL.

Estados del dominio

EstadoSignificado
Pending DNSEsperando que agregues los registros DNS requeridos
VerifyingRegistros DNS detectados; el certificado SSL se está aprovisionando
ActiveDominio completamente conectado y sirviendo tu Chat Externo
FailedAlgo salió mal—revisa el mensaje de error y reintenta
DisabledEl dominio ha sido deshabilitado
Los cambios de DNS pueden tardar unos minutos en propagarse. Si tu dominio se queda en Pending DNS, espera un momento y haz clic en Check status de nuevo.

Eliminar un dominio personalizado

Haz clic en el ícono de papelera junto a un dominio para eliminarlo. Aparecerá un diálogo de confirmación—una vez confirmado, el Chat Externo dejará de servirse en ese dominio.
La eliminación de un dominio personalizado es inmediata. Los usuarios que accedan al chat a través de ese dominio ya no podrán acceder.

Notas Clave

  • El Chat Externo es ideal para demos, pilotos rápidos y compartir con usuarios que no visitan tu sitio web.
  • Las conversaciones iniciadas a través del Chat Externo aparecen en el panel de Conversaciones para supervisión.
  • Todas las funciones de escalación, seguimiento y memorias funcionan igual que en otros canales.
  • Puedes tener uno o más dominios personalizados conectados al mismo agente.