Configurar MagicAI Chat

En este artículo aprenderás a crear una configuración de chat en el Backoffice, a recorrer las secciones del diálogo de configuración, a guardarla como borrador o publicarla directamente, y a desplegarla en tus estudios.

Contenido

• Requisitos previos
• Vista general de las configuraciones
• Crear una nueva configuración
• Guardar la configuración
• Vista de detalle y estado
• Configuración del autoservicio del cliente
• Fast Finance Link
• Activar y autorizar (whitelist)
• Insertar el widget de chat
• Datos de terceros y licencias
• Dónde encuentran los miembros el chat

Requisitos previos

• Permiso: Configurar los ajustes del chat MagicAI, disponible en Ajustes / Permisos dentro de la subcategoría Inteligencia artificial . Un permiso aparte, Conversaciones de chat de MagicAI, controla la visibilidad de la bandeja de entrada del agente y se encuentra en la subcategoría Comunicación .
• Licencia: MagicAI Chat no forma parte de los paquetes de precios habituales; se ofrece bajo su propio modelo de licencia. Ponte en contacto con tu gestor de cuenta de Sport Alliance para activarlo en un estudio.
• Imágenes de avatar: un avatar principal del chatbot para el widget de chat abierto y un avatar de llamada a la acción para el botón de chat flotante, cada uno de hasta 3 MB.
• Al menos una fuente de información: archivo (máx. 10 MB), URL o Zendesk Help Center.
• Para un traspaso humano vía Zendesk: subdominio de Zendesk, nombre de usuario del agente y token de API.
• Para ofertas de contratos: un canal de ofertas mantenido (Sales tool, Studio pages and Connect API, MySports u Open API).
• Estudio de facturación por defecto válido: el estudio de facturación por defecto de la configuración debe ser un estudio donde el chatbot esté disponible contractualmente y que forme parte de los estudios autorizados de la configuración. Si no se cumple alguna de estas condiciones, la configuración no se puede guardar.

Vista general de las configuraciones

Abre el punto de entrada de la configuración en Ajustes / MagicAI / Chat. La barra lateral muestra la nueva sección MagicAI con una entrada Chat y lleva una etiqueta Nuevo al lanzamiento.

La página de vista general lista todas las configuraciones de chat de tu ubicación.

Columnas de la lista:

• Nombre: el identificador interno, solo visible para los usuarios del Backoffice. Aparece un chip Borrador junto al nombre mientras la configuración aún se está creando.
• Marca: el nombre de marca de tu estudio. Por sí solo no es visible para los socios, pero resulta útil para distinguir configuraciones entre marcas.
• Nombre del chatbot: el nombre público que ven los socios en el widget de chat.
• Última actualización: la marca de tiempo del último cambio en la configuración.
• Publicado para: una etiqueta con el número de estudios en los que la configuración está activa actualmente. Aparece aquí un chip Activo una vez que la configuración se activa en al menos un estudio.
• Ubicaciones: una etiqueta con el número de estudios para los que la configuración está autorizada; pasa el ratón o haz clic para ver la lista de estudios.

Desde la lista puedes filtrar por estado, buscar por nombre o marca, ordenar y mostrar u ocultar columnas. Usa el selector de ubicación en la parte superior derecha para ver configuraciones de otras ubicaciones. Inicia el diálogo de configuración con Crear configuración de chat en la parte superior derecha.

La activación y la desactivación se realizan siempre desde esta página de vista general. La vista de detalle solo gestiona el contenido y la autorización (whitelist). Consulta Activar y autorizar (whitelist) para conocer todas las reglas de activación.

Crear una nueva configuración

Crear configuración de chat abre un único diálogo que te guía por cinco secciones, cada una con un botón Siguiente al final. La cabecera del diálogo ofrece una acción Guardar borrador que puedes usar en cualquier momento para conservar tu trabajo en curso. No se muestran números de paso; el título de la sección y el progreso dentro del diálogo indican dónde estás.

Información básica

La primera sección recoge los datos básicos de la configuración.

Nombres

• Nombre: nombre interno de la configuración (máx. 30 caracteres). Solo visible para los usuarios del Backoffice.
• Marca: tu nombre de marca (máx. 30 caracteres). Se muestra en la vista general del Backoffice.
• Nombre del chatbot: el nombre que ven los socios en el widget de chat (máx. 30 caracteres).

Mensaje de bienvenida

• Mensaje de bienvenida: el saludo que se muestra cuando un socio abre el chat (máx. 400 caracteres).

Nota: Los socios deben poder reconocer claramente que están interactuando con un sistema de IA (conforme al Reglamento de IA de la UE, artículo 50). Redacta el mensaje de bienvenida en consecuencia. Ejemplo: «¡Hola! Soy tu asistente digital de IA. Estaré encantado de ayudarte con preguntas sobre tu membresía, nuestras clases o información general sobre el estudio. ¿En qué puedo ayudarte hoy?»

Estudio de facturación

• Estudio de facturación por defecto: el estudio de reserva utilizado para las conversaciones de chat que aún no pueden asignarse a un estudio concreto (por ejemplo, un posible cliente no autenticado). El estudio debe estar en la lista de autorizados de la configuración y ser un estudio donde el chatbot esté disponible contractualmente; de lo contrario, la configuración no se puede guardar.

Consentimiento legal

Si rellenas ambos campos, la vista previa muestra un diálogo de consentimiento con las acciones Rechazar y Aceptar que los socios ven antes de su primer mensaje. Ambos campos son opcionales: si los dejas vacíos, no se muestra ningún diálogo de consentimiento.

• Título de consentimiento legal: título del diálogo de consentimiento (máx. 30 caracteres).
• Descripción del consentimiento legal: el texto del cuerpo que explica a qué consiente el socio, con opciones de texto enriquecido (negrita, cursiva, subrayado, color de texto, enlace).

Texto de consentimiento sugerido

El siguiente texto es un borrador de trabajo para el diálogo de consentimiento. Adapta los enlaces de marcador de posición a tu propia política de privacidad y condiciones de uso antes de publicarlo.

• Título: Aviso sobre el tratamiento de datos
• Descripción: Tu entrada, incluidos los datos personales, se procesa automáticamente para responder a tu solicitud. Puedes retirar este consentimiento en cualquier momento con efecto para el futuro. Por favor, no introduzcas datos de salud ni otra información sensible. Encontrarás más información sobre el tratamiento de datos y tus derechos en nuestra [política de privacidad] y nuestras [condiciones de uso].

Estilo

Personaliza la apariencia visual del widget de chat para que coincida con tu marca. Configuras tres colores base más una forma de burbuja; todos los demás colores de la interfaz (texto, bordes, estados de error) se derivan automáticamente.

Colores y aspecto

• Principal: color de acento principal como valor hexadecimal, utilizado para elementos principales de la interfaz como botones y resaltados, p. ej. #166cb8.
• Fondo del chat: color de la superficie del widget de chat como valor hexadecimal, p. ej. #6d2929.
• Color de degradado de la cabecera: segundo color opcional utilizado para el degradado de la cabecera. Si está vacío, la cabecera usa el color principal. Valor hexadecimal.
• Utilizar una forma redondeada para las burbujas de chat: interruptor sí/no.

Avatar

Se admiten dos espacios de avatar. Solo se permite una imagen por espacio.

• Avatar de chatbot abierto: el logotipo principal que se muestra en la cabecera del widget de chat (máx. 3 MB).
• Avatar de chatbot cerrado: el logotipo o icono que se muestra en el botón de chat flotante que abre el widget (máx. 3 MB).

Funciones

Activa las funciones que el bot debe gestionar. Cada función desbloquea una funcionalidad específica para los usuarios finales. Después de guardar, puedes ajustar cada flujo de trabajo en su tarjeta en la vista de detalle.

Configurar el Traspaso humano

Si activas Traspaso humano, elige el Tipo. de transferencia. Solo se permite una configuración de Traspaso humano por chatbot.

Tipo Email

• Correo electrónico: dirección de destino para las conversaciones transferidas. Debe ser una dirección de correo electrónico válida.

Tipo Zendesk

• URL: URL de tu instancia de Zendesk.
• Nombre de usuario: el nombre de usuario del agente utilizado para crear tickets.
• Token: token de API para la autenticación.

Configurar las ofertas de contratos

Si activas Ofertas de contratos, también debes seleccionar el Tipo de grupo de tarifas del que se extraen las ofertas. Sin una selección, la configuración no se puede guardar. Las cuatro opciones se corresponden con los valores de RateBundleGroupTypeEnum:

• Sales tool: ofertas del grupo de tarifas Sales tool.
• Studio pages and Connect API: ofertas del grupo de tarifas Studio pages and Connect API.
• MySports: ofertas del grupo de tarifas MySports.
• Open API: ofertas del grupo de tarifas Open API.

Tu selección determina de dónde extrae el bot las ofertas y dónde se realiza el registro.

Fuentes de conocimiento

Se requiere al menos una fuente de información. Usa + Añadir fuente de conocimiento para añadir más. Para cada fuente eliges el Tipo de fuente: File, URL o Zendesk.

Añadir una fuente es solo la mitad del trabajo. La forma en que estructuras el contenido dentro de tus fuentes afecta directamente a la calidad de las respuestas, y algunos temas deberían omitirse por completo porque el software ya los proporciona. Para saber qué incluir, qué dejar fuera y cómo dar formato a tu contenido, consulta Crear la base de conocimiento de MagicAI Chat.

Tipo File

Sube directamente un archivo de texto o PDF (máx. 10 MB por archivo). Para varios archivos, crea varias fuentes.

Tipo URL

Introduce la URL inicial de una página web. El sistema rastrea hasta 5 niveles de profundidad y sigue un máximo de 50 enlaces desde la URL inicial. Ambos límites son fijos y no se pueden cambiar.

Tipo Zendesk

Introduce la URL base de tu Zendesk Help Center, por ejemplo https://yourstudio.zendesk.com. Los artículos se obtienen en todos los idiomas disponibles en tu Zendesk Help Center, según la configuración por tenant.

Actualizar las fuentes de información

Cuando guardas una nueva fuente de información, se publica e indexa automáticamente para que el bot pueda usarla.

Si el contenido detrás de una fuente de información existente cambia (por ejemplo, se actualizó tu sitio web o subiste un archivo nuevo), activa una actualización inmediata con el botón Actualizar las fuentes de conocimiento en la parte inferior de la tarjeta de fuentes de información en la página de detalle. Esto reindexa todas las fuentes de inmediato, de modo que los cambios aparecen al instante en las respuestas del bot. Si no ejecutas una actualización manual, todas las fuentes de información se reindexan automáticamente cada noche.

Contenido y formato recomendados

Que el chatbot pueda responder bien depende mucho más de la estructura y el lenguaje de tus fuentes que del tipo de fuente. Sigue estas recomendaciones al preparar el contenido.

• Formatos preferidos: Markdown o texto plano. Ambos están claramente estructurados y se dividen en fragmentos de forma limpia. Los PDF funcionan siempre que el texto sea extraíble; evita los PDF escaneados, los archivos de solo imagen y las hojas de Excel.
• Usa una estructura de preguntas frecuentes: el título es la pregunta, el cuerpo es una respuesta autónoma. Cada sección debe tener sentido por sí sola; cierta repetición entre secciones está bien si mantiene cada bloque autosuficiente.
• Terminología coherente: usa las mismas palabras para el mismo concepto en todo el contenido. Evita el lenguaje de marketing, las afirmaciones contradictorias entre fuentes y el contenido obsoleto.

Guardar la configuración

El diálogo ofrece dos formas de salir del flujo de creación:

• Guardar borrador (acción en la cabecera del diálogo): conserva la configuración en estado Borrador . En este modo, los campos obligatorios pueden estar vacíos. Úsalo para mantener configuraciones en curso sin hacerlas activables.
• Siguiente (el botón principal en la parte inferior de cada sección): avanza por las secciones. En la última sección se convierte en la acción de envío y guarda la configuración en estado Publicado . Los campos obligatorios deben estar completos; de lo contrario, el diálogo bloquea el envío. Publicado solo significa que la configuración está almacenada y completa; todavía no hace que el chat esté activo para los socios. La activación en los estudios es un paso aparte (consulta Activar y autorizar (whitelist)).

En ambos casos llegas a la página de detalle, donde cada sección aparece como una tarjeta y puede editarse individualmente.

Vista de detalle y estado

La página de detalle tiene dos pestañas:

• Ajustes: tarjetas para Información básica, Consentimiento legal, Estilo (con subtarjetas Colores y aspecto y Avatar), Funciones, Fuentes de conocimiento y Fragmento de código.
• Autoservicio: tarjetas para Datos personales y Datos del contrato. Consulta Configuración del autoservicio del cliente.

La página de detalle muestra el estado actual en dos lugares.

Chip de estado junto al título de la configuración:

• Borrador: la configuración aún se está creando y no se puede activar.
• Activo: publicada y activada en al menos un estudio.
• Inactivo: publicada pero no activada actualmente en ningún sitio.

Banner de alerta en la parte superior de la página:

• Los borradores muestran: Esta configuración aún no está completa y actualmente se encuentra en estado "Borrador". Para activarla, primero debe rellenar todos los campos obligatorios.
• Las configuraciones publicadas muestran un banner de confirmación (severidad informativa).

La acción Editar ajustes en la cabecera de la página de detalle solo está disponible cuando la configuración está en estado Publicado .

Configuración del autoservicio del cliente

Cuando activas Autoservicio del cliente en la sección Funciones, la pestaña Autoservicio de la página de detalle se convierte en el lugar para controlar qué áreas de la cuenta pueden leer y editar los socios a través del chat. La pestaña contiene dos tarjetas.

Datos personales

• Datos maestros: si los socios pueden ver o cambiar sus datos maestros.
• Dirección: acceso a la información de dirección.
• Datos de contacto: acceso al teléfono, correo electrónico y datos de contacto similares.

Datos del contrato

• Datos del contrato: qué contratos son visibles (Todos los contratos o Contratos activos).
• Rescisión del contrato principal: si los socios pueden rescindir su contrato principal a través del chat.
• Sugerir un período de descanso antes de la terminación: si el chat sugiere proactivamente un período de descanso cuando un socio intenta rescindir.
• Periodos de inactividad: si los socios pueden solicitar un período de inactividad.

Cada campo editable muestra su estado actual (por ejemplo, Activado) y un enlace Comprobar modificaciones que abre los ajustes de verificación del campo.

Fast Finance Link

Si activas Fast Finance Link en la sección Funciones, el chatbot puede enviar a un socio autenticado un Fast Finance Link por correo electrónico, tras comprobar su estado de pago, para que pueda liquidar reclamaciones pendientes o actualizar su método de pago. El envío utiliza la misma vía que el envío manual desde la cuenta del socio, incluida la plantilla de comunicación configurada allí.

• Requisito: en los ajustes de Fast-Finance Link del estudio debe haber una plantilla de comunicación configurada para el envío manual. Sin plantilla, el chatbot no puede enviar el correo. Más información en el artículo Configurar el Fast-Finance Link.
• El enlace nunca aparece en la conversación del chat. Tras el envío, el chatbot solo muestra al socio una confirmación enmascarada de la dirección de destinatario (por ejemplo, d***n@example.com).
• Qué elementos (pago, método de pago) incluye el correo depende de la configuración de Fast-Finance Link del estudio; el chatbot no realiza su propia selección.
• El chatbot nunca promete que una restricción de acceso se levantará inmediatamente tras el pago. Indica al socio que la restricción puede resolverse como consecuencia, y recomienda contactar con el estudio si el problema persiste.

Activar y autorizar (whitelist)

Dos conceptos distintos controlan dónde está disponible una configuración y dónde está activada:

• Autorización (whitelist): los estudios que tienen acceso a una configuración. Se establece en la vista de detalle de la configuración.
• Activación: los estudios donde esta configuración es la activa. Se establece desde la vista general de configuraciones. El chat solo se hace visible para los socios una vez que el código de inserción también está presente en el sitio web del estudio (consulta Insertar el widget de chat).

Esto se aplica a la web propia del estudio. En la Member Platform y en Branded Web no se necesita ningún código de inserción. Dónde encuentran los miembros el chat.

Para activar una configuración:

1. Abre la vista general en Ajustes / MagicAI / Chat.
2. Selecciona la configuración que quieres activar.
3. Elige los estudios donde debe ejecutarse.

Reglas importantes:

• Solo una configuración puede estar activa por estudio. Activar una configuración en un estudio desactiva automáticamente cualquier configuración que estuviera activa allí previamente.
• Si activas una configuración en un estudio que aún no está autorizado, el estudio se añade automáticamente a la lista de autorizados.
• No puedes activar una configuración que aún está en estado de borrador. Guárdala primero como una configuración completa y publicada; de lo contrario, la activación falla con No se puede activar un borrador de configuración.
• No puedes eliminar una configuración mientras esté activa en algún estudio. Desactívala en todas partes primero.

Insertar el widget de chat

La página de detalle contiene una tarjeta Fragmento de código con el código de inserción para el sitio web de tu estudio. Copia el fragmento y pégalo en el código fuente de tu sitio web para mostrar el widget de chat. El fragmento de código solo es necesario para tu propia web. En la Member Platform y en Branded Web el chat aparece sin él.

La tarjeta se comporta de forma diferente según el estado de la configuración:

• Borrador: la tarjeta muestra el mensaje La configuración actual está en modo borrador. Para obtener un fragmento de código, complete la configuración del chatbot. La acción de copiar está desactivada.
• Publicado: el fragmento se muestra junto con una acción Copiar que coloca el código en el portapapeles.

Dónde encuentran los miembros el chat

Los miembros llegan al chat en tres lugares. En tu propia web aparece en cuanto has insertado el código. En la Member Platform y en Branded Web aparece por sí solo, como un botón de chat flotante, sin configuración adicional.

Un miembro ve el chat en la Member Platform y en Branded Web cuando su propio estudio tiene una configuración publicada y activada. Lo determinante es el estudio del miembro, no el estudio que esté visitando. En un grupo con varios estudios decides por estudio si sus miembros reciben el chat.

Dos consecuencias que conviene conocer:

• Una configuración en estado de borrador no llega a los miembros en ningún sitio, ni en la web ni en la Member Platform.
• Si desactivas una configuración en un estudio, el chat desaparece para los miembros de ese estudio también en la Member Platform y en Branded Web, no solo en la web.

Datos de terceros y licencias

Para los datos de ubicación de los estudios utilizamos datos geográficos de GeoNames.org, con licencia CC BY 4.0. La licencia nos obliga a divulgar el uso de forma transparente; por favor, deja este aviso en su sitio cuando reutilices el artículo.

Aviso: Este artículo se ha traducido con ayuda de inteligencia artificial. Disculpa los posibles errores.