Saltar al contenido principal

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.

Antes de conectar tu agente, asegúrate de tener listas Identidad, Conocimiento y Habilidades.
Un agente bien configurado da mejores respuestas desde la primera conversación.

Conecta tu agente con usuarios reales

La página Conecta se organiza en dos pestañas:
  • Canales — conecta y administra los canales donde tu agente habla con los usuarios.
  • Comportamiento de Mensajería — configura cómo tu agente maneja los mensajes en cada canal conectado.
Este paso convierte tu agente de «configurado» a «en producción».

Pestaña de Canales

La pestaña de Canales se organiza en tres bloques:
  • Canales — publica tu agente en canales propios y externos (burbuja web, chat externo, WhatsApp y otros; en la interfaz algunos nombres pueden aparecer en inglés).
  • Integraciones — conecta herramientas o servicios externos de tu operación.
  • API — envía y recibe mensajes desde tus propios sistemas.

Chat externo (salida más rápida)

El chat externo te da una URL compartible para lanzar en minutos (en consola puede mostrarse como External chat).
1

Ve a Conecta > Canales

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

Abre el chat externo

Selecciona la tarjeta de chat externo / External chat.
3

Copia la URL pública

En la pestaña Domain setup, busca la tarjeta Default URL y haz clic en el botón de copiar para copiar el enlace generado.
4

Prueba como usuario final

Abre el enlace en una ventana privada y valida casos de uso reales.
También puedes conectar un dominio personalizado para que los usuarios accedan a tu Chat Externo desde una URL de marca como chat.ejemplo.com/ai-agent. Consulta la página de Chat Externo para ver todos los detalles de la pestaña de configuración de dominio.

Burbuja web (embebido en tu sitio)

Usa la burbuja web cuando quieras el agente dentro de tu propia web (en consola puede aparecer como Web bubble / Bubble).
1

Abre el canal de burbuja

En Conecta > Canales, abre la tarjeta de burbuja web.
2

Genera credenciales y fragmentos de código

La consola muestra el fragmento (snippet) y las claves para la integración.
3

Añade el fragmento al sitio

Pega el script donde tu equipo implementa el código web.
4

Personaliza la experiencia

Ajusta marca, botón de apertura y mensaje de bienvenida.

Canales de Meta (WhatsApp, Messenger, Instagram)

La página de Conecta siempre muestra una sección de Meta con tres tarjetas de canal:
CanalDescripción
WhatsAppCanal de WhatsApp Business vía Meta
MessengerCanal de Facebook Messenger vía Meta
InstagramCanal de mensajería de Instagram vía Meta
Cada tarjeta muestra un botón Conectar que abre el flujo de configuración para ese canal específico. No necesitas configurar primero la integración de Meta — las tarjetas siempre están visibles para que puedas iniciar la conexión en cualquier momento.

Pestaña de Comportamiento de Mensajería

La pestaña Comportamiento de Mensajería te permite ajustar cómo tu agente procesa los mensajes entrantes en cada canal conectado. Selecciona un canal del menú desplegable en la parte superior de la pestaña para configurar sus ajustes. La pestaña se organiza en dos secciones de configuración principales que se muestran una al lado de la otra en pantallas grandes (y apiladas en pantallas más pequeñas). Ambas secciones son colapsables — haz clic en el encabezado de la sección para expandirla o contraerla, para que puedas enfocarte en los ajustes que necesitas.

Importar configuración desde otro canal

Cuando tienes más de un canal conectado, puedes replicar ajustes rápidamente importando la configuración de otro canal. Usa el desplegable “Importar configuración desde” para seleccionar un canal de origen. Aparece un banner de confirmación mostrando desde qué canal se importará la configuración y hacia cuál canal destino. Revisa los valores importados y haz clic en Guardar importación para aplicar, o Descartar para revertir.
Importar es útil cuando quieres un comportamiento consistente entre canales — configura un canal primero y luego importa su configuración a los demás.

Debounce de mensajes

La sección Debounce de mensajes (marcada con un ícono ⚡) controla cuánto tiempo espera el agente antes de procesar una ráfaga de mensajes consecutivos del usuario como una sola entrada. Esto es especialmente útil en plataformas de mensajería donde los usuarios tienden a enviar varios mensajes cortos seguidos.
  • Usa el deslizador o los botones preestablecidos (0s, 1s, 3s, 5s, 8s, 10s, 15s) para ajustar la ventana de debounce.
  • Una vista previa en vivo muestra cómo se agrupan varios mensajes y cuándo responde el agente.
  • Cuando el debounce está por encima de 0 segundos, una advertencia te recuerda que el agente esperará antes de responder.
La sección de debounce está oculta para canales internos como el Playground y el API Agent, donde la agrupación de mensajes no aplica.

Preferencias de archivos (Multimodal)

La sección Preferencias de archivos (marcada con un ícono de 📄 archivos apilados) te permite controlar qué tipos de archivo puede recibir y procesar tu agente en el canal seleccionado. Los tipos de archivo soportados incluyen:
Tipo de archivoDescripción
DocumentosPDFs, archivos Word y otros documentos de texto
ImágenesFotos y archivos de imagen
AudioNotas de voz y grabaciones de audio
VideoArchivos y clips de video
Para cada tipo de archivo puedes:
  • Activar o desactivar la recepción con un interruptor.
  • Configurar escenarios — definir instrucciones específicas de cómo el agente debe manejar archivos de ese tipo.
Las preferencias de archivos configuradas aquí afectan el comportamiento del agente en el canal seleccionado. Recuerda configurarlas para cada canal donde desees soporte multimodal.