En este artículo aprenderás a crear una configuración de chat, a ajustarla en las cinco pestañas de su página de detalle, a activarla en tus estudios y a insertar el chat en tu sitio web.
Contenido
- Requisitos previos
- Vista general de las configuraciones
- Crear una nueva configuración
- Guardar la configuración
- Vista de detalle y estado
- Pestaña Ajustes
- Configuración del autoservicio del cliente
- Pestaña Fuentes
- Pestaña Directrices
- Pestaña Información sobre el estudio
- Fast Finance Link
- Activar y autorizar
- Insertar el widget de chat
- Dónde encuentran los socios el chat
- Conversaciones por chat
- Datos de terceros y licencias
- Artículos relacionados
Requisitos previos
- Permiso: Ajustes / Inteligencia artificial / Configurar los ajustes del chatbot. Para leer las conversaciones del chat necesitas además Comunicación / Inteligencia artificial / MagicAI conversaciones de chat. Ambos permisos se asignan en la configuración de roles.
- Licencia: MagicAI Chat es una extensión con licencia propia. Si no está activa para tu estudio, Ajustes / MagicAI / Chatbot abre una página informativa con el botón Empieza ya en lugar de la configuración.
- 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 conocimiento: archivo (máx. 10 MB), URL o Zendesk Help Center.
- Para un traspaso a Zendesk: la URL de tu instancia de Zendesk, un nombre de usuario de agente y un token de API.
- Para un traspaso a HubSpot: un token de acceso a HubSpot, el ID de la pipeline y el ID de la etapa de la pipeline.
- Para ofertas de contratos: un canal de ofertas mantenido (Herramienta de ventas, Conectar API, Contratos en línea de MySports o API abierta).
- Estudio de facturación por defecto válido: el estudio de facturación por defecto de la configuración debe ser un estudio en el que el chatbot esté disponible por contrato y con el que la configuración esté compartida. Si no se cumple alguna de estas condiciones, la configuración no se puede guardar.
Vista general de las configuraciones
Abre la configuración en Ajustes / MagicAI / Chatbot. La página de vista general muestra todas las configuraciones de chat de tu ubicación.
Columnas de la lista:
- Nombre: el nombre interno de la configuración, visible solo para los usuarios del Backoffice. Junto al nombre, una etiqueta de estado muestra la situación en el estudio actual, por ejemplo Activado en este estudio o Borrador.
- Marca: el nombre de marca de tu estudio. Sirve para distinguir configuraciones entre marcas.
- Nombre del chatbot: el nombre público que los socios ven en el widget de chat.
- Última actualización: la fecha del último cambio en la configuración.
- Activado para: el número de estudios en los que la configuración está activa en este momento.
- Ubicaciones: el número de estudios con los que se comparte la configuración.
Puedes filtrar y ordenar la lista, así como mostrar u ocultar columnas. Con el selector de ubicación de la parte superior derecha ves las configuraciones de otras ubicaciones. Para crear una nueva configuración, usa Crear chatbot.
La activación y la desactivación se realizan siempre desde esta página de vista general. Las reglas de activación se describen en Activar y autorizar.
Crear una nueva configuración
Crear chatbot abre un diálogo de cinco pasos. El pie del diálogo ofrece Cancelar, Guardar borrador y Siguiente.
- Información básica: nombres, saludo y estudio de facturación por defecto.
- Consentimiento legal: diálogo de consentimiento opcional.
- Comparecencias: colores y avatares.
- Alcance: lo que el chatbot puede hacer.
- Fuentes: al menos una fuente de la que el chatbot obtiene sus respuestas.
El paso 1, Información básica, contiene estos campos:
- Nombre, Marca y Nombre del chatbot (máx. 30 caracteres cada uno).
- Título de bienvenida (máx. 100 caracteres), Mensaje e Información adicional.
- Estudio de facturación por defecto.
- Editar los permisos: elige con qué estudios se comparte la configuración.
Los campos de todos los pasos son los mismos que editas después en la página de detalle. Se describen en las secciones Pestaña Ajustes y Pestaña Fuentes.
Guardar la configuración
El diálogo ofrece dos formas de salir del proceso de creación:
- Guardar borrador (botón en el pie del diálogo): guarda la configuración en estado Borrador. En este modo los campos obligatorios pueden quedar vacíos. Un borrador no se puede activar.
- Siguiente en el último paso: guarda la configuración en estado Publicado. Todos los campos obligatorios deben estar completos. Publicado solo significa que la configuración está guardada y completa; todavía no pone el chat a disposición de los socios. La activación en los estudios es un paso aparte (consulta Activar y autorizar).
En ambos casos llegas a la página de detalle de la configuración.
Vista de detalle y estado
La cabecera de la página de detalle muestra el nombre de la configuración, el número de ubicaciones, la etiqueta de estado, la Marca y el Estudio de facturación por defecto.
Etiqueta de estado junto al nombre de la configuración:
- Borrador: la configuración aún está incompleta y no se puede activar.
- Activo: publicada y activada en al menos un estudio.
- Inactivo: publicada, pero sin activar en ningún estudio por el momento.
Los borradores muestran además el aviso "Esta configuración aún no está completa y actualmente se encuentra en estado "Borrador". Para activarla, primero debe rellenar todos los campos obligatorios."
El menú de la cabecera ofrece Editar ajustes cuando la configuración está publicada; en un borrador aparece Editar borrador en su lugar. Editar ajustes contiene el Nombre, la Marca, el Estudio de facturación por defecto y Editar los permisos, donde eliges con qué estudios se comparte la configuración.
La página de detalle tiene cinco pestañas:
| Pestaña | Qué configuras en ella |
|---|---|
| Ajustes | Información básica, consentimiento legal, aspecto visual, funciones y el fragmento de código. |
| Area de socio | Qué datos de su cuenta pueden consultar y modificar los socios a través del chat. |
| Fuentes | Los archivos, sitios web y Help Centers de los que el chatbot obtiene sus respuestas. |
| Directrices | Reglas de comportamiento que el chatbot debe cumplir. |
| Información sobre el estudio | Datos temporales o que dependen de la situación para estudios concretos. |
Pestaña Ajustes
La pestaña Ajustes muestra una tarjeta por área. Cada tarjeta se edita desde su menú: Editar información básica, Editar el consentimiento legal, Editar colores y aspecto, Editar logotipo, Editar capacidades y Copiar Fragmento de código.
Información básica
La información básica controla los nombres y el contenido que ven los socios al abrir el chat.
- Nombre del chatbot: el nombre que ven los socios en el widget de chat (máx. 30 caracteres).
- Título de bienvenida (máx. 100 caracteres) y Mensaje: el saludo que ven los socios al abrir el chat.
- Información adicional: texto adicional opcional.
- Noticia de avance (máx. 500 caracteres) con el interruptor Activar el avance: un breve texto de avance para el widget de chat.
- Mostrar avances en dispositivos móviles: determina si el avance y las sugerencias aparecen también en dispositivos móviles.
- Activar sugerencias de noticias y Mostrar sugerencias en la pantalla de inicio: ofrecen a los socios preguntas preparadas. Cada sugerencia consta de un Texto del botón y del Mensaje correspondiente (máx. 500 caracteres). Con Añadir sugerencia añades más sugerencias.
Nota: Los socios deben poder reconocer claramente que están interactuando con un sistema de IA (tal como exige el Reglamento de IA de la UE, artículo 50). Formula el saludo en consecuencia. Ejemplo: «¡Hola! Soy tu asistente digital de IA. Te ayudo con gusto con preguntas sobre tu membresía, nuestras clases o información general del estudio. ¿En qué puedo ayudarte hoy?»
El Nombre interno, la Marca (máx. 30 caracteres cada uno) y el Estudio de facturación por defecto se editan en el menú de la cabecera, en Editar ajustes. El estudio de facturación por defecto es el estudio de respaldo para las conversaciones de chat que todavía no se pueden asignar a un estudio concreto, por ejemplo con un cliente potencial no autenticado.
Consentimiento legal
Si rellenas ambos campos, los socios ven antes de su primer mensaje un diálogo de consentimiento con las acciones Disminución (rechazar) y Aceptar. 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 que explica a qué da su consentimiento 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. Antes de ponerlo en marcha, sustituye los enlaces de marcador de posición por tu propio aviso de privacidad y tus condiciones de uso.
- Título: Aviso sobre el tratamiento de datos
- Descripción: Tus entradas, incluidos los datos personales, se procesan automáticamente para responder a tu consulta. Puedes retirar este consentimiento en cualquier momento con efecto para el futuro. 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 nuestro [aviso de privacidad] y en nuestras [condiciones de uso].
Estilo
Adapta el aspecto visual del widget de chat a tu marca. En el diálogo de creación, este paso se llama Comparecencias; en la pestaña Ajustes lo encuentras en las tarjetas Colores y aspecto y Logotipos. Configuras tres colores base y la forma de las burbujas; todos los demás colores del widget se derivan automáticamente.
Colores y aspecto
-
Principal: color de acento principal como valor hexadecimal, usado para botones y elementos destacados, por ejemplo
#166cb8. -
Fondo del chat: color de superficie del widget de chat como valor hexadecimal, por ejemplo
#6d2929. - Color de degradado de la cabecera: segundo color opcional para el degradado de la cabecera. Si se deja vacío, la cabecera usa el color Principal. Valor hexadecimal. En la tarjeta y en el diálogo de edición de la pestaña Ajustes, este campo aparece como Secundaria.
- Utilice una forma redondeada para las burbujas de chat: interruptor sí/no.
Logotipos
Hay dos espacios para avatares, con una imagen por espacio.
- Avatar de chatbot abierto: la imagen que aparece en la cabecera del widget de chat (máx. 3 MB).
- Avatar de chatbot cerrado: la imagen del botón de chat flotante que abre el widget (máx. 3 MB).
Alcance
Activa las funciones que debe asumir el chatbot. El chatbot solo realiza las acciones que hayas activado aquí.
| Función | Qué hace |
|---|---|
| Información del estudio | El chatbot informa sobre la ubicación del estudio, los datos de contacto y el horario de apertura. Para datos temporales, usa la Pestaña Información sobre el estudio. |
| Reserva de una sesión de prueba | El chatbot reserva una sesión de prueba según los huecos disponibles. |
| Anulación del contrato | Tras una autenticación suficiente, el socio puede solicitar la baja de su contrato a través del chatbot. |
| Fast Finance Link | El chatbot envía a los socios un Fast Finance Link para saldar reclamaciones pendientes o actualizar sus datos de pago. Requiere una plantilla de comunicación en los ajustes de Fast Finance Link (consulta Fast Finance Link). |
| Traspaso humano | El chatbot transfiere la conversación a un empleado. Requiere un Tipo de traspaso (ver más abajo). |
| Autoservicio del cliente | Según la configuración, los socios pueden cambiar su dirección, solicitar periodos de suspensión u obtener información sobre su contrato. Se configura en la pestaña Area de socio (consulta Configuración del autoservicio del cliente). |
| Búsqueda de citas | El chatbot busca citas disponibles y se las muestra a los socios. Es necesaria para Reserva de cita. |
| Reserva de cita | El chatbot permite reservar citas. Solo funciona junto con Búsqueda de citas. |
| Reserva de cursos | El chatbot reserva clases para socios y clientes potenciales. |
| Horario del curso | El chatbot muestra las clases y cursos disponibles en un estudio concreto dentro del intervalo de fechas elegido. |
| Ofertas de contratos | El chatbot informa sobre las ofertas de contratos configuradas. Requiere un Tipo de grupo de tarifas (ver más abajo). |
Configurar el Traspaso humano
Si activas Traspaso humano, elige el Tipo: Zendesk, Correo electrónico o HubSpot. Solo se permite una configuración de traspaso por chatbot.
- Zendesk: URL de tu instancia de Zendesk, Nombre de usuario del agente con el que se crean los tickets y Ficha (el token) para la autenticación.
- Correo electrónico: Correo electrónico, la dirección de destino de las conversaciones transferidas. Debe ser una dirección de correo electrónico válida.
- HubSpot: Token de acceso a HubSpot (se introduce como secreto), ID de canalización de HubSpot e ID de etapa del pipeline de HubSpot de la etapa de la pipeline que se usa para el traspaso.
Configurar las ofertas de contratos
Si activas Ofertas de contratos, también debes seleccionar el Tipo de grupo de tarifas del que se toman las ofertas. Sin una selección, la configuración no se puede guardar. Las opciones son Herramienta de ventas, Conectar API, Contratos en línea de MySports y API abierta. Tu selección determina de dónde obtiene el chatbot las ofertas y dónde se realiza el alta.
Fragmento de código
La tarjeta Fragmento de código contiene el campo Seleccione el gimnasio y el código de inserción para tu sitio web. Cómo usarlo se explica en Insertar el widget de chat.
Configuración del autoservicio del cliente
Si activas Autoservicio del cliente en Alcance, en la pestaña Area de socio determinas qué datos de su cuenta pueden consultar y modificar los socios a través del chat.
Datos personales
- datos maestros
- Dirección
- Datos de contacto
Datos del contrato
- Datos del contrato: qué contratos muestra el chat, por ejemplo Mostrar sólo los contratos activos.
- Suspensiones temporales: si los socios pueden solicitar un periodo de suspensión.
Cada fila muestra su estado actual, por ejemplo Activado, y cómo se tratan los cambios, por ejemplo Comprobar modificaciones. Los ajustes se cambian desde el menú de la tarjeta correspondiente.
La baja no se configura en esta pestaña. Los socios solo pueden solicitar la baja a través del chat si la función Anulación del contrato está activada en la pestaña Ajustes.
Pestaña Fuentes
La pestaña Fuentes muestra todas las fuentes con las columnas Fuente, Tipo y Modo de rastreo. Encima de la lista ves cuándo se procesaron las fuentes por última vez (Última ejecución del resumen).
La forma en que estructuras el contenido de tus fuentes influye directamente en la calidad de las respuestas, y algunos temas conviene dejarlos fuera porque el software ya los proporciona. Qué incluir y cómo darle formato se explica en Crear la base de conocimiento de MagicAI Chat.
Añadir una fuente
- Haz clic en Añadir fuente de conocimiento.
- Elige el Tipo de fuente: Archivo, URL o Zendesk.
- Rellena los campos del tipo (ver más abajo) y haz clic en Crear.
- Archivo: sube un archivo por fuente, de máx. 10 MB, en formato PDF, TXT, DOCX o MD. Para varios archivos, crea varias fuentes.
- URL: introduce la URL y elige el Modo de rastreo. Rastrear todo el sitio web parte de esta URL y obtiene automáticamente hasta 50 subpáginas, hasta una profundidad máxima de 5 niveles. Cargar solo esta página procesa únicamente esta URL exacta, sin subpáginas.
-
Zendesk: introduce la URL de tu Zendesk Help Center, por ejemplo
https://yourstudio.zendesk.com.
Actualizar las fuentes de conocimiento
Si has añadido fuentes o ha cambiado el contenido de una fuente, haz clic en Actualizar las fuentes de conocimiento en la cabecera de la pestaña para que el chatbot trabaje con el contenido actual. Si no haces una actualización manual, todas las fuentes de conocimiento se vuelven a indexar automáticamente cada noche.
Pestaña Directrices
Las directrices son reglas de comportamiento que el chatbot debe cumplir. La pestaña las muestra con las columnas Contenido y Activado para.
- Haz clic en Crear Directrices. Se abre el diálogo Crear una directriz.
- En Gestionar la activación, elige los estudios a los que se aplica la directriz. Todos los estudios se aplica a todos los estudios que estén activados ahora o en el futuro para esta configuración de chat.
- Introduce la regla en Contenido (máx. 500 caracteres) y haz clic en Guardar.
Los cambios se publican de inmediato y pueden influir en las respuestas del chatbot.
Pestaña Información sobre el estudio
La información sobre el estudio está pensada para datos temporales o que dependen de la situación. Los datos estándar, como la dirección, el horario de apertura y las instalaciones, se proporcionan automáticamente y no hace falta introducirlos aquí. La pestaña muestra las entradas con las columnas Contenido y Activado para.
- Haz clic en Crear Información sobre el estudio. Se abre el diálogo Añadir información sobre el estudio.
- En Gestionar la activación, asigna la información a uno o varios estudios.
- Introduce la información en Contenido (máx. 500 caracteres) y haz clic en Guardar.
Los cambios se publican de inmediato y pueden influir en las respuestas del chatbot.
Fast Finance Link
Si activas Fast Finance Link en Alcance, el chatbot puede enviar por correo electrónico un Fast Finance Link a un socio autenticado, después de comprobar su estado de pago, para que pueda saldar reclamaciones pendientes o actualizar su método de pago. El correo se envía de la misma forma que un envío manual desde la cuenta del socio, con 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. Encontrarás los detalles en Configurar el Fast-Finance Link.
- El enlace en sí 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 destino (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 hace su propia selección.
- El chatbot nunca promete que una restricción de acceso se levante inmediatamente después del pago. Le indica al socio que la restricción puede resolverse como consecuencia y le recomienda ponerse en contacto con el estudio si el problema persiste.
Activar y autorizar
Dos ajustes distintos controlan dónde está disponible una configuración y dónde se ejecuta:
- Uso compartido: los estudios que tienen acceso a una configuración. Se define en la página de detalle, en Editar ajustes / Editar los permisos.
- Activación: los estudios en los que esta configuración es la activa. Se define desde la vista general con Gestionar la activación.
Para activar una configuración:
- Abre la vista general en Ajustes / MagicAI / Chatbot.
- Abre el menú de la fila (tres puntos) de la configuración y elige Gestionar la activación. El mismo menú contiene también Borrar Chatbot.
- En el diálogo, selecciona en el selector de ubicaciones los estudios en los que debe ejecutarse la configuración.
- Confirma con el botón que muestra el número de estudios seleccionados, por ejemplo Activar 2.
Reglas importantes:
- Solo puede haber una configuración activa por estudio. Al activar una configuración en un estudio, se desactiva automáticamente la configuración que estaba activa allí.
- Si activas una configuración en un estudio con el que todavía no está compartida, el estudio se añade automáticamente al uso compartido.
- Un borrador no se puede activar. Complétalo y publícalo primero; de lo contrario, la activación falla con No se puede activar un borrador de configuración.
- No puedes borrar una configuración mientras esté activa en algún estudio. Desactívala primero en todos.
En tu propio sitio web, el chat solo aparece cuando además el código de inserción está colocado (consulta Insertar el widget de chat). En la Member Platform y en Branded Web no hace falta ningún código de inserción (consulta Dónde encuentran los socios el chat).
Insertar el widget de chat
La tarjeta Fragmento de código de la pestaña Ajustes contiene el código de inserción para el sitio web de tu estudio. Cópialo con Copiar Fragmento de código en el menú de la tarjeta y pégalo en la sección <head> de tu sitio web. El fragmento solo es necesario para tu propio sitio web.
Se aplican dos requisitos técnicos:
- La política de seguridad de contenidos (CSP) de tu sitio web debe permitir conexiones a
magicline.com. - Si el chat se inserta en una página de un estudio concreto, selecciona el estudio en el campo Seleccione el gimnasio. El fragmento incluye entonces los parámetros
studioIdystudioName, de modo que el chatbot sabe a qué estudio pertenece la página.
La tarjeta se comporta de forma distinta 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." No se puede copiar ningún fragmento.
- Publicado: el fragmento se muestra y se puede copiar.
Dónde encuentran los socios el chat
Los socios acceden al chat en tres lugares. En tu propio sitio web aparece una vez que has pegado el código de inserción. En la Member Platform y en Branded Web aparece por sí solo, como botón de chat flotante, sin más configuración.
Un socio ve el chat en la Member Platform y en Branded Web cuando su propio estudio tiene una configuración publicada y activada a la vez. Lo que cuenta es el estudio del socio, no el estudio que esté visitando en ese momento, así que en una configuración con varios estudios decides por estudio si sus socios tienen el chat.
Esto tiene dos consecuencias:
- Un borrador no llega a los socios en ningún lugar, ni en tu sitio web ni en la Member Platform.
- Al desactivar una configuración en un estudio, el chat desaparece para los socios de ese estudio también en la Member Platform y en Branded Web, no solo en tu sitio web.
Conversaciones por chat
Las conversaciones que los socios han mantenido con el chatbot se encuentran en Más / Comunicación / MagicAI / Conversaciones por chat. Para ello necesitas el permiso MagicAI conversaciones de chat (consulta Requisitos previos).
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 indicar este uso de forma transparente; deja este aviso si reutilizas el artículo.
Artículos relacionados
- Directrices e información del estudio para MagicAI Chat
- Mensaje teaser y sugerencias de mensajes en MagicAI Chat
Aviso: Este artículo se ha creado con ayuda de inteligencia artificial y traducido automáticamente sin revisión editorial. Disculpa los posibles errores.