> For the complete documentation index, see [llms.txt](https://boundaryai.gitbook.io/boundaryai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://boundaryai.gitbook.io/boundaryai-docs/boundaryai-docs-es/incorporacion-de-sus-comentarios/connect-to-your-existing-systems.md). # Conectar tus herramientas Los conectores te permiten extraer comentarios en BAI Analytics directamente desde las herramientas que tu equipo ya usa y analizarlos junto con encuestas, cargas y reseñas rastreadas. Una vez conectado, una plataforma sigue alimentando automáticamente nuevos tickets, respuestas de encuestas o filas en tus Grupos de feedback, sin exportaciones, sin copiar y pegar, y sin scripts programados. Hay dos tipos de conexión, y ambas se gestionan desde el mismo lugar: * **Herramientas de soporte y trabajo** (Zendesk, Intercom, Linear, GitHub Issues, y así sucesivamente). Inicias sesión en la plataforma desde BAI Analytics y luego importas tickets en un Grupo de feedback con filtros y un intervalo de tiempo. * **Plataformas de encuestas y CX, almacenes de datos y almacenamiento de archivos** (Qualtrics, SurveyMonkey, Medallia, InMoment, Snowflake, BigQuery, Amazon S3, SFTP, y así sucesivamente). Te conectas con credenciales o una clave, y luego añades una **sincronización** que asigna los campos de la plataforma a un Grupo de feedback y se ejecuta según un calendario. Esta página cubre cómo funcionan los conectores de principio a fin: qué plataformas son compatibles, cómo está organizada la página de Integraciones, cómo conectar y configurar cada tipo, y cómo se comportan los datos importados una vez que llegan a BAI Analytics. Para el contenedor que almacena los datos del conector, consulta [Grupos de feedback](/boundaryai-docs/boundaryai-docs-es/grupos-de-feedback/feedback-groups.md). Para otros métodos de ingesta, consulta [Subir un conjunto de datos existente](/boundaryai-docs/boundaryai-docs-es/incorporacion-de-sus-comentarios/uploading-an-existing-dataset.md), [Escucha social](/boundaryai-docs/boundaryai-docs-es/incorporacion-de-sus-comentarios/social-listening.md), y [Crear una encuesta](/boundaryai-docs/boundaryai-docs-es/incorporacion-de-sus-comentarios/surveys/editor.md). *** ### Cuándo usar un conector Usa un conector cuando: * Tu equipo de soporte usa **Zendesk, Freshdesk, Intercom, Front, ServiceNow, Salesforce Service Cloud, Zoho Desk**o una mesa de ayuda similar y quieres que todos los tickets de clientes (pasados y actuales) se analicen para detectar temas, sentimiento y problemas supervisados. * Tu equipo de producto o ingeniería registra errores y solicitudes en **Linear, GitHub Issues, GitLab, Azure DevOps, Asana, ClickUp, Trello, Shortcut, Wrike**o una herramienta similar y quieres analizarlos en busca de patrones recurrentes. * Tu programa de encuestas se ejecuta en **Qualtrics, SurveyMonkey, Medallia**, o **InMoment** y quieres que las respuestas abiertas se analicen continuamente, encuesta por encuesta, sin exportar. * Tus comentarios ya están en un **almacén de datos** (Amazon Redshift, Snowflake, Google BigQuery, Databricks) o llegan como **archivos** en un bucket de Amazon S3 o en un servidor SFTP, y quieres que BAI Analytics lea nuevas filas o archivos según un calendario. * Tu herramienta no está en el catálogo, pero es una de las miles de apps de **Zapier**y un Zap puede enviar sus comentarios a BAI Analytics (consulta Importar a través de Zapier más abajo). * Quieres **siempre activa** ingesta: los nuevos registros llegan a BAI Analytics con una cadencia fija sin que nadie exporte un CSV. Si tus datos ya están exportados como una hoja de cálculo, [Subir un conjunto de datos existente](/boundaryai-docs/boundaryai-docs-es/incorporacion-de-sus-comentarios/uploading-an-existing-dataset.md) es más rápido. Si necesitas respuestas fuera de cualquier plataforma que controles (reseñas públicas, publicaciones en redes sociales), consulta [Escucha social](/boundaryai-docs/boundaryai-docs-es/incorporacion-de-sus-comentarios/social-listening.md). *** ### Plataformas compatibles La **Añadir una conexión** El catálogo de la página de Integraciones se puede buscar y está agrupado por categoría. Esto es lo que contiene hoy: | Categoría | Plataformas | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Atención al cliente** | Dixa, Freshdesk, Freshservice, Front, Help Scout, Intercom, Kustomer, Re:amaze, Salesforce Service Cloud, ServiceNow, Zendesk, Zoho Desk | | **Encuestas y CX** | InMoment, Medallia, Qualtrics, SurveyMonkey | | **Gestión del trabajo** | Asana, Basecamp, ClickUp, Hive, Teamwork, Trello, Wrike | | **Desarrollo** | Azure DevOps, Bitbucket, GitHub Issues, GitLab, Linear, Pivotal Tracker, Shortcut, Zoho BugTracker | | **Legal y contratos** | Ironclad, SpotDraft | | **Almacenes de datos** | Amazon Redshift, Databricks, Google BigQuery, Snowflake | | **Almacenamiento de archivos** | Amazon S3, SFTP | Cada herramienta de soporte o trabajo expone un conjunto de funciones ligeramente distinto en el lado de origen: por ejemplo, *prioridad* y *fecha de vencimiento* existen en Linear pero no en Trello, *tipo de ticket* en Zendesk pero no en GitHub Issues. BAI Analytics sabe qué admite cada plataforma y solo muestra opciones de importación que realmente se aplican, así que nunca ves un filtro que no haga nada. {% hint style="info" %} **¿No ves tu herramienta?** Zapier cubre miles de otras apps a través del endpoint de la API descrito al final de esta página. Si necesitas un conector nativo que no aparece en la lista, contacta con tu gestor de cuenta. {% endhint %} *** ### Disponibilidad Los conectores se habilitan por organización por parte del equipo de BAI Analytics. Cuando la función no está habilitada para tu organización, la **Conectores** tarjeta en un Grupo de feedback dice *No habilitado para tu organización* y la página de Integraciones queda bloqueada en la barra lateral. Contacta con tu gestor de cuenta para que la active. Una vez habilitada, todas las plataformas del catálogo están disponibles; no hay restricciones por plataforma. *** ### La página de Integraciones Abrir **Integraciones** desde la navegación principal. La página tiene tres secciones: * **Conexiones**: las herramientas y plataformas que tu organización ha vinculado. Todo lo que hay en esta página está aquí. * **Asistentes de IA**: conecta Claude u otro cliente MCP a tus datos (solo lectura). * **Herramientas para desarrolladores**: **API** claves y **Webhooks**, para enviar datos y recibir notificaciones de eventos. Consulta la [documentación de la API](/boundaryai-docs/boundaryai-docs-es/api-y-webhooks/getting-started.md) y [webhooks](/boundaryai-docs/boundaryai-docs-es/api-y-webhooks/webhooks.md). #### La sección de Conexiones El principio es simple: conecta una plataforma una vez y luego vincúlala a los Grupos de feedback que necesiten sus datos. * **Tus conexiones** enumera todas las cuentas vinculadas, agrupadas por categoría (Atención al cliente, Encuestas y CX, Almacenes de datos, Almacenamiento de archivos, y así sucesivamente). Cada fila muestra el logotipo de la plataforma, el nombre de la conexión, una etiqueta de estado, a cuántos Grupos de feedback alimenta (*Usado por 2 grupo(s)*), y cuándo estuvo activa por última vez. * **Añadir conexión** abre el catálogo: busca apps, filtra por categoría y elige una tarjeta. Las tarjetas que ya has conectado muestran un contador de *1 conectado* conexiones. * Al expandir una fila se muestran los Grupos de feedback que alimenta, una línea por sincronización, cada una con una etiqueta de estado (*Sincronizando*, *En pausa*, *Fallando*), la última hora de sincronización, un **Sincronizar ahora** botón, **Pausar** / **Reanudar**y un control para eliminarla. Debajo de eso están las acciones a nivel de conexión: **Probar conexión** (conexiones de encuestas, CX, almacén y almacenamiento), **Alimentar un grupo…** (para añadir una sincronización), **Reconectar** (herramientas de soporte y trabajo), y **Desconectar**. Las etiquetas de estado en una fila de conexión significan: | Etiqueta | Significado | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **Conectado** | La plataforma acepta nuestras credenciales y al menos una sincronización está sana, o todavía no se ha configurado ninguna sincronización. | | **Sincronización en pausa** | Una o más sincronizaciones de esta conexión están en pausa. | | **Se requiere acción** | La plataforma rechazó nuestras credenciales, o una sincronización está fallando. Expande la fila para ver el mensaje de error. | | **Configuración incompleta** | La conexión se creó pero todavía no se ha verificado (por ejemplo, una clave SFTP que aún no se ha registrado). | | **Desconectado** | La plataforma cortó la conexión. Vuelve a conectarte para reanudarla. | Cuando alguna conexión necesita atención, aparece una pequeña insignia junto a **Integraciones** en la barra lateral. *** ### Conectar una herramienta de soporte o trabajo El proceso tarda aproximadamente un minuto y se ejecuta completamente dentro de BAI Analytics; no hay nada que instalar en la plataforma de origen. {% stepper %} {% step %} ### Elige una plataforma En la página de Integraciones, haz clic en **Añadir conexión** y elige una tarjeta del catálogo (o empieza desde un Grupo de feedback; consulta la siguiente sección). {% endstep %} {% step %} ### Ponle nombre a la conexión Dale un nombre que tu equipo reconozca, como el nombre de la cuenta o del espacio de trabajo. Si ya tienes una conexión a la misma plataforma, BAI Analytics sugiere un nombre numerado (*Zendesk 2*). Haz clic en **Continuar a Zendesk** (o la plataforma que hayas elegido). {% endstep %} {% step %} ### Iniciar sesión Se abre una ventana segura de inicio de sesión. Inicia sesión en tu plataforma y concede acceso de lectura. BAI Analytics te guía por los pasos específicos de cada plataforma (como tu subdominio de Zendesk). Si la ventana no es visible, usa **Abrir inicio de sesión** para volver a mostrarla. {% endstep %} {% step %} ### Confirmar Una vez conectado, la plataforma aparece debajo de **Tus conexiones** con un punto verde. Tus credenciales permanecen en la plataforma de origen. BAI Analytics nunca ve tu contraseña. {% endstep %} {% endstepper %} Puedes conectar **varias cuentas de la misma plataforma** (por ejemplo, un Zendesk por región). Cada conexión es independiente: añadir una nunca desconecta otra, y cada una conserva sus propias importaciones. Si una conexión fue configurada por alguien que ya ha dejado el equipo, usa **Reconectar** en su fila; la conexión conserva su nombre y sus importaciones programadas. *** ### Importar tickets en un Grupo de feedback Conectar la cuenta es el primer paso. El segundo es decirle a BAI Analytics qué importar, y eso siempre ocurre dentro de un Grupo de feedback. #### Por dónde empezar Dentro de un Grupo de feedback, usa el **Añadir fuente** botón y elige **Añadir conector** (aparece **Importar datos** una vez que una cuenta está vinculada), o abre **Conectar fuente de datos** y elige la **Conectores** tarjeta. El asistente de importación te guía por **Conectar → Configurar → Preparar** (etiquetada **Revisar** en grupos con recopilación continua). #### Conectar Si ya tienes una cuenta conectada, el asistente te la muestra, con un desplegable para elegir entre cuentas cuando tienes más de una. Haz clic en **Importar tickets** para continuar. Si todavía no tienes ninguna cuenta, **Conecta tu plataforma** se abre el mismo inicio de sesión seguro descrito arriba. Justo después de conectar una plataforma por primera vez, puede mostrar *Sincronización inicial en curso* durante unos minutos mientras la plataforma prepara sus datos; el asistente te avisa cuando está lista. Este paso también ofrece una alternativa: **Endpoint de la API**, para recibir datos desde Zapier, Make, n8n o tu propio código (consulta Importar a través de Zapier más abajo). #### Configurar **Intervalo de tiempo.** Elige hasta dónde retroceder para importar: | Opción | Importa tickets creados en… | | --------------------------------------------------------------------------------- | ------------------------------------------ | | Últimos 7 días / Últimos 30 días / Últimos 90 días / Últimos 6 meses / Último año | …la ventana elegida. | | Todo el tiempo | …todo el historial de la cuenta de origen. | | Fechas personalizadas | …una ventana específica de inicio y fin. | Las plataformas que no admiten filtrado por fecha muestran **Número de tickets** en su lugar, para que importes los N tickets más recientes. En un grupo con recopilación continua, este paso se etiqueta **Relleno histórico** (*¿Hasta dónde debemos sincronizar los tickets existentes?*porque la conexión sigue sincronizándose hacia adelante después de la carga inicial. **Filtros avanzados.** Los filtros reducen lo que se importa. Los filtros disponibles dependen de la plataforma de origen: * **Estado**: abierto, cerrado, en curso, en espera (o *all*). * **Prioridad**: urgente, alta, normal, baja (o *all*). * **Tipo**: error, función, pregunta, tarea, incidente, y así sucesivamente. * **Asignado**: asignado, sin asignar, o *all*. * **Fecha de vencimiento**: vencido, vence hoy, vence esta semana, sin fecha de vencimiento, o *all*. * **Colecciones**: un selector múltiple para los contenedores nativos de la plataforma (Trello *Tableros*, Zendesk *Grupos*, Freshdesk *Grupos*, GitHub *Repositorios*, y así sucesivamente). Déjalo vacío para importar de todos. Los filtros se aplican tanto a la importación inicial como a cada sincronización continua posterior, así que un conector de "tickets de soporte, cerrados, últimos 30 días" seguirá importando tickets de soporte recién cerrados en ciclos posteriores, no tickets nuevos aleatorios. **Campos a importar.** Elige cuáles **Campos estándar** (estado, prioridad, asignados, etiquetas, y así sucesivamente) y cuáles **Campos personalizados de la plataforma** traer, hasta 15 campos de metadatos. Los campos estándar se convierten en metadatos por los que puedes segmentar en la vista de análisis; los campos personalizados son útiles cuando tu equipo depende de etiquetas personalizadas de Zendesk o similares. Si no quieres pensar en esto, deja los valores predeterminados. **Incluir historial de la conversación.** Activado de forma predeterminada: los comentarios del ticket se añaden al cuerpo del ticket para que el análisis vea todo el intercambio. **Importación continua.** Un interruptor controla si la conexión es de una sola vez o siempre activa: * **Importación única**: importa los tickets que coinciden una vez y luego se detiene. Los tickets nuevos creados más tarde en la plataforma de origen no aparecerán a menos que ejecutes otra importación. * **Importación continua**: importa el lote inicial *y* y sigue trayendo automáticamente tickets nuevos y actualizados. La importación continua está activada de forma predeterminada en grupos con recopilación continua. El asistente también muestra un **Nombre de la conexión**, generado a partir de la plataforma y del intervalo de tiempo; puedes cambiarle el nombre. #### Configurar e iniciar El último paso resume tus opciones. Haz clic en **Iniciar sincronización** (o **Conectar e iniciar sincronización** en un grupo con recopilación continua) para una conexión continua, o **Ejecutar importación** para una importación única. Si solo necesitas una instantánea, *¿Solo necesitas una importación única?* **Importar sin sincronizar** cambia de modo sin volver atrás. {% hint style="info" %} **La supervisión no forma parte de la configuración de la importación.** Los monitores del grupo con **Cubrir automáticamente nuevas fuentes** activados vigilan automáticamente una nueva fuente del conector. Gestiónalos desde la **Administrar monitoreo** del grupo; consulta [Supervisión personalizada](/boundaryai-docs/boundaryai-docs-es/analizando-sus-comentarios/custom-monitoring.md). {% endhint %} #### La importación inicial Cuando inicias la importación, BAI Analytics comienza a extraer tus tickets en segundo plano, procesándolos página por página, y muestra una notificación de progreso en la esquina de la pantalla. Puedes alejarte y seguir trabajando; la notificación te acompaña. Cuando el trabajo termina, los datos del conector aparecen como una fuente en su Grupo de feedback con una *Conector* insignia, y el enlace de análisis se activa. En un grupo con recopilación continua, la pantalla final del asistente confirma que la plataforma está *Activa, sincronizando continuamente* y que los tickets existentes se están importando ahora. Las importaciones históricas muy grandes se procesan automáticamente por lotes, así que incluso un historial largo se importa de forma fiable. #### Importación continua Para las conexiones con importación continua activada, BAI Analytics ejecuta una sincronización incremental **cada 30 minutos** en segundo plano. Cada sincronización: 1. Comprueba en la plataforma de origen los tickets creados o actualizados desde la última sincronización correcta, con los filtros configurados aplicados. 2. Elimina duplicados frente a los tickets ya importados en BAI Analytics. 3. Analiza los tickets nuevos igual que todo lo demás. ¿Necesitas datos más recientes? Usa **Obtener nuevos datos** en la tarjeta de fuente de datos del origen (consulta más abajo) o **Sincronizar ahora** en la página de Integraciones. Ambos solicitan a la plataforma sus datos más recientes *ahora* en lugar de esperar al siguiente ciclo. *** ### Conectar una plataforma de encuestas, un almacén de datos o un almacenamiento de archivos Estos conectores funcionan al revés: primero creas la conexión en la página de Integraciones, la pruebas y luego añades una o más **sincronizaciones**, cada una alimentando un Grupo de feedback. #### Lo que necesitarás para cada plataforma | Plataforma | Lo que solicita el formulario de conexión | | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Qualtrics** | Tu **ID del centro de datos** y un **token de API**, ambos desde Configuración de la cuenta, y luego los IDs de Qualtrics. Volver a generar el token en Qualtrics revoca nuestro acceso. | | **SurveyMonkey** | **Conectar con SurveyMonkey** abre SurveyMonkey para que puedas aprobar el acceso de lectura, sin tener que copiar nada. Cuando ese inicio de sesión no está disponible, **usa en su lugar un token de aplicación privada**: elige el **Centro de datos** (Estados Unidos, Europa o Canadá), pega el **Token de acceso**, y opcionalmente su **ID de cliente** y **secreto de cliente** para habilitar la entrega en tiempo real. | | **InMoment** | La **Host regional de la API**, tu **ID de organización**, y los **ID de cliente** / **secreto de cliente** aprovisionado por tu contacto de InMoment. | | **Medallia** | Primero, *¿Cómo llegan tus datos de Medallia a BAI?* Elige **API de consulta** (la **URL del gateway de la API**, **URL del token OAuth**, **ID de cliente** y **secreto de cliente** de tu instancia de Medallia; el rol del cliente necesita la capacidad de API de consulta) o **Entrega de archivos (SFTP)** (Medallia exporta archivos a una carpeta SFTP según un calendario y BAI Analytics los recoge; no se necesita licencia de API). | | **Amazon Redshift** y **Amazon S3** | Implementa el rol lector de BAI en tu cuenta de AWS con la plantilla de CloudFormation que proporcionamos (solo lectura, vinculado a tu External ID, revocable eliminando la pila), y luego pega la **ARN del rol** más los detalles del clúster o del grupo de trabajo, o el **nombre del bucket** y el prefijo opcional y la clave KMS para S3. | | **Snowflake** | La **Identificador de cuenta**, un **Usuario de servicio**, y los **Almacén virtual**. BAI Analytics genera un par de claves; registras la parte pública en el usuario de servicio con la instrucción mostrada y luego pruebas. Ninguna contraseña sale nunca de Snowflake. | | **Google BigQuery** | La **ID de proyecto** y **ID del conjunto de datos**. Concede el **rol de visor de datos de BigQuery** a la cuenta de servicio de BAI mostrada, añade la etiqueta de propiedad con el comando mostrado y luego prueba. No se intercambia ninguna clave ni secreto. Cada consulta de sincronización se ejecuta primero en prueba en seco y se detiene si escanearía más que el presupuesto configurado (1 GB por defecto). | | **Databricks** | La **host del espacio de trabajo**, **ID del almacén SQL**, **Catálogo**, y el ID de cliente y secreto de un principal de servicio OAuth **ID de cliente** y **secreto**. Se requiere un espacio de trabajo con Unity Catalog habilitado. Registra la fecha de caducidad del secreto y te avisamos antes de que caduque. | | **SFTP** | **Host**, **Puerto**, **Nombre de usuario**, el **Carpeta** carpeta en la que se entregan los archivos, y un campo opcional **Patrón de nombre de archivo** (por ejemplo `feedback_*.csv`). La autenticación se realiza mediante **clave SSH** (recomendado) o **contraseña**. Pega la huella digital del servidor del proveedor **Huella digital del servidor** si tienes una. | Para las fuentes basadas en archivos (S3 y SFTP), BAI Analytics lee archivos CSV, TSV, JSON, NDJSON o Parquet, opcionalmente comprimidos con gzip, y detecta las columnas del archivo más reciente. #### Conectando {% stepper %} {% step %} ### Añade la conexión Haz clic en **Añadir conexión**, selecciona el recuadro y completa el formulario de arriba. La mayoría de las plataformas usan **Conectar y probar**: la conexión se crea y verifica de una sola vez. {% endstep %} {% step %} ### Entrega una clave, si la plataforma necesita una Snowflake y SFTP terminan con un paso de entrega. BAI Analytics genera su propio par de claves y muestra la clave pública con un botón de copiar y su huella digital. Regístrala en el usuario del servicio (Snowflake) o envíala a quien gestione la cuenta de SFTP, luego haz clic en **La clave está registrada. Probar conexión**. **Terminar más tarde** siempre está disponible: la conexión permanece como *Configuración incompleta* y la clave pública permanece en su fila hasta que la otra parte lo confirme. Para SFTP, la identidad del servidor se verifica en el primer contacto y queda fijada a partir de entonces. {% endstep %} {% step %} ### Alimentar un grupo Expande la fila de la conexión y haz clic en **Alimentar un grupo…** para añadir una sincronización (ver más abajo). Puedes añadir varias sincronizaciones a una conexión, cada una alimentando un Feedback Group diferente. {% endstep %} {% endstepper %} #### Añadir una sincronización Una sincronización asigna los datos de la plataforma a un Feedback Group. El formulario pide: * **Grupo de feedback**: dónde aterrizan los registros. * **Qué leer**: la **Encuesta** (Qualtrics, SurveyMonkey, InMoment), el **Esquema** y **Tabla** (almacenes de datos), o la **Ubicación de los archivos** (S3 y SFTP). * **Campo de texto de feedback** (o **Columna de texto de feedback**): la respuesta abierta que analiza la IA. SurveyMonkey y Medallia te permiten elegir varias **preguntas de texto de feedback**; cada pregunta respondida se convierte entonces en su propia pieza de feedback, con una *Pregunta* columna que indica cuál. * **Campo de marca de tiempo** (o columna): cuándo se creó cada registro. Los almacenes de datos y los archivos también necesitan una **columna de ID único** para que las relecturas nunca dupliquen. * **Campos de metadatos (opcional)**: otros campos que incluir para la segmentación. * **Frecuencia de sincronización**: **Cada hora**, **Cada 4 horas**, o **Diario**. Haz clic en **Iniciar sincronización**. La primera importación comienza en unos minutos, y luego la sincronización se ejecuta con la frecuencia que elegiste. Cada ejecución lee solo lo nuevo desde la última ejecución, elimina duplicados frente a los registros ya importados y analiza los nuevos registros como cualquier otra fuente. **Entrega en tiempo real de SurveyMonkey.** Cuando la conexión tiene un ID de cliente y secreto (o se creó con **Conectar con SurveyMonkey**), BAI Analytics registra un webhook en cada encuesta sincronizada, de modo que una respuesta completada desencadena una extracción en minutos en lugar de esperar a la siguiente ejecución programada. La fila de la sincronización en la página de Integraciones muestra un **En tiempo real** distintivo; *Tiempo real no disponible* significa que no se pudo registrar el webhook y que la sincronización consulta según su programación en su lugar. #### Medallia: ensaya antes de activarlo Medallia es la única plataforma en la que un resultado vacío y un permiso faltante se ven idénticos desde fuera, por lo que sus sincronizaciones tienen salvaguardas adicionales: * El formulario de sincronización está organizado en pasos: de dónde proviene el feedback (el **Programa de experiencia**, y opcionalmente **Limita esta fuente a** reglas), qué cuenta como feedback (los **campos de texto de feedback**), el **campo de fecha que sigue esta sincronización** (elige un campo que registre cuándo el feedback estuvo disponible en Medallia, no cuándo respondió el cliente; BAI Analytics marca el recomendado), y dónde aterriza (el **Grupo de feedback** y una **Nombre de la fuente**). * **Una conexión puede alimentar varias fuentes.** Añade una **Limita esta fuente a** regla (por ejemplo, tipo de feedback *es uno de* encuesta) para enrutar las respuestas de encuestas a un Feedback Group y las reseñas de Google a otro, desde la misma conexión de Medallia. * **Las nuevas sincronizaciones de Medallia se guardan en pausa.** Usa **Comprobar configuración** en la conexión para ejecutar comprobaciones de preparación (credenciales, capacidad de Query API, Experience Programs, descubrimiento de campos, etc.), luego **Vista previa** en la sincronización para ejecutarla de verdad contra Medallia y ver qué *sería* traería: registros leídos, excluidos por tus reglas, ya importados, se importarían, con registros de muestra. Nada se importa en una vista previa. Cuando estés satisfecho, haz clic en **Activar esta sincronización**. Puedes omitir la vista previa, pero solo deliberadamente (**Activar sin vista previa**). * **Editar** en la conexión te permite rotar un secreto o cambiar el nombre sin volver a crear las sincronizaciones. *** ### Cómo se ven los datos del conector en un Feedback Group Una vez importados, los registros aparecen como una sola fuente dentro del Feedback Group de destino, con una *Conector* insignia para que puedas ver de un vistazo qué fuentes están activas. Cada sincronización en una conexión de encuesta, almacén o almacenamiento crea su propia fuente. Asignación por registro para herramientas de soporte y trabajo: * El ticket **asunto y cuerpo** se convierten en una respuesta de respuesta larga, el campo que la IA analiza para temas y sentimiento. * **Comentarios** en el ticket se añaden como contexto adicional (cuando mantuviste *Incluir historial de la conversación* activado). * **Estado, prioridad, asignados, tipo de ticket, etiquetas, fecha de vencimiento** se convierten en campos de metadatos, disponibles para la segmentación en la vista de análisis. * Cualquier **campos personalizados** que seleccionaste aparecen como metadatos adicionales. Para sincronizaciones de encuesta, almacén y almacenamiento, el **Campo de texto de feedback** se convierte en la respuesta de respuesta larga, el **Campo de marca de tiempo** la fecha, y los **Campos de metadatos** que seleccionaste aparecen para la segmentación. Esto significa que una fuente de conector participa plenamente en el análisis entre fuentes dentro de su Feedback Group: Grouped Themes agrupará los registros del conector junto con las respuestas de encuesta relevantes o las reseñas extraídas, y los informes del grupo los incluyen automáticamente. #### La tarjeta de la fuente de datos En la vista general cualitativa de una fuente del conector, un **Importación de conector** tarjeta muestra: * La plataforma conectada (logo, nombre, estado: *Conectado*, *Sincronizando*, *Fallido*, o *Desconectado*) y cuántos elementos se han importado. * **Última importación** con precisión completa de fecha y hora. * **Próxima importación automática**, con una cuenta regresiva relativa, o *Importación automática en pausa*. * La **Filtros de importación activos** como chips de solo lectura (Estado, Prioridad, Tipo, Colecciones, Asignados, Fecha de vencimiento) para que puedas ver exactamente por qué algunos tickets pueden excluirse. * Una **Obtener nuevos datos** botón para activar una sincronización ahora. El resultado se muestra en línea, y el **Último error de sincronización** aparece aquí si la última ejecución falló. * Una **Gestionar conector** enlace a la página de Integraciones para pausar, editar o desconectar. Para una sincronización de Medallia que sigue en pausa y nunca se ha ejecutado, **Obtener nuevos datos** te devuelve a **Vista previa** en lugar de iniciar una sincronización silenciosamente. *** ### Pausar, editar y desconectar Desde la página de Integraciones (o mediante **Gestionar conector** en la tarjeta de la fuente de datos), puedes: * **Pausar** una sincronización: deja de ejecutarse pero conserva sus filtros y su asignación de campos, así que **Reanudar** es un solo clic. * **Sincronizar ahora**: ejecuta la sincronización de inmediato en lugar de esperar al siguiente ciclo. * **Probar conexión**: comprueba que la plataforma todavía acepta nuestras credenciales (conexiones de encuesta, CX, almacén y almacenamiento). * **Eliminar una sincronización**: el Feedback Group deja de recibir actualizaciones de esta conexión. Los datos importados permanecen en el grupo. * **Desconectar** la cuenta: detiene todas las sincronizaciones en ella y elimina el vínculo con la plataforma de origen. Los registros ya importados permanecen en tus Feedback Groups; solo se corta el vínculo en vivo. #### Gestión de fallos Si una sincronización falla (por ejemplo, caducaron las credenciales de tu plataforma), la fila de la sincronización muestra *Fallando* con el mensaje de error de la plataforma, y la conexión muestra *Se requiere acción*. Tras cinco fallos consecutivos, BAI Analytics deja de reintentar automáticamente, y la sincronización sigue mostrando *Fallando* hasta que actúes. Una vez que hayas solucionado el problema (**Reconectar** para herramientas de soporte y trabajo, o **Editar** / **Probar conexión** para las demás), haz clic en **Reanudar** en la sincronización, o **Sincronizar ahora** si no se muestra como en pausa. *** ### Importar a través de Zapier Si una herramienta no está en el catálogo, **Zapier** puede servir de puente: un Zap vigila tu aplicación de origen e impulsa cada nueva pieza de feedback a BAI Analytics a través de la API. {% stepper %} {% step %} ### Crear una fuente de extremo de API En un Feedback Group, abre el asistente del conector (**Añadir fuente**, luego **Añadir conector**) y elige **Endpoint de la API** (*Recibir datos de Zapier, Make, n8n o código personalizado*). Nombra el endpoint y define los campos que recibirán datos. BAI Analytics muestra el ID del grupo, el ID de la fuente y los ID de los campos del endpoint, y una solicitud de ejemplo. {% endstep %} {% step %} ### Crear una clave de API En **Integraciones**, **Herramientas para desarrolladores**, **API**, crea una clave de API. Cópiala enseguida; solo se muestra una vez. {% endstep %} {% step %} ### Crear el Zap El panel de detalles del endpoint muestra una **Conectar con Zapier** guía paso a paso con un **Añadir BAI Analytics a Zapier** botón. En Zapier, crea un Zap, elige la aplicación de la que provienen tus datos como desencadenante, añade **BAI Analytics → Enviar feedback** como acción y conéctalo con tu clave de API. Elige este grupo y esta fuente en los menús desplegables, luego asigna tus campos a las preguntas. {% endstep %} {% step %} ### Probar y activar Pon un ID de registro único en **ID externo** para que los reintentos nunca dupliquen, luego activa tu Zap. Cada elemento llega a la fuente del endpoint como cualquier otro feedback y se analiza automáticamente. {% endstep %} {% endstepper %} Los datos importados a través de Zapier se comportan exactamente como los datos nativos del conector: participan en Grouped Themes, están cubiertos por monitores de cobertura automática y se incorporan a los informes. ¿Estás creando algo más personalizado que un Zap? El mismo endpoint ofrece una API completa [API](/boundaryai-docs/boundaryai-docs-es/api-y-webhooks/getting-started.md) con envíos masivos, lectura de retorno del análisis y [webhooks](/boundaryai-docs/boundaryai-docs-es/api-y-webhooks/webhooks.md). *** ### Buenas prácticas * **Un Feedback Group por fuente por audiencia.** Un solo grupo mixto está bien para operaciones pequeñas; para las más grandes, dividir *"Soporte: UE"*, *"Soporte: EE. UU."*, y *"Errores de ingeniería"* mantiene Grouped Themes significativos. Con varias cuentas de la misma plataforma, nombra cada conexión según la cuenta para que la correcta sea obvia en el importador. * **Sé específico con los filtros.** *"Todos los tickets, todo el tiempo"* rara vez es lo que quieres. Filtra a tickets de soporte cerrados si te importan los problemas resueltos; filtra a un solo tablero o repositorio si solo analizas un equipo. * **Elige los campos personalizados que realmente usas.** Los campos estándar cubren la mayoría de los análisis; solo añade campos personalizados si tu equipo los usa para enrutamiento, etiquetado o escalado. * **Prueba la conexión justo después de la configuración.** **Probar conexión** (o **Obtener nuevos datos** en la fuente) saca a la luz los problemas de credenciales de inmediato en lugar de en la siguiente ejecución programada. * **Previsualiza las sincronizaciones de Medallia antes de activarlas.** Una asignación que se ejecuta bien e importa los registros incorrectos es el fallo que nada más detecta; la vista previa muestra exactamente qué llegaría. * **Vigila la programación en los almacenes medidos.** Snowflake factura un mínimo por cada reanudación del almacén y los escaneos de BigQuery se presupuestan por consulta, así que **Frecuencia de sincronización** es tu principal palanca de costes. * **Vuelve a autenticar de forma proactiva cuando cambien los puestos.** Si el miembro del equipo que conectó originalmente una herramienta de soporte o trabajo se va, usa **Reconectar** para que el token de larga duración no caduque inesperadamente. * **Desconecta, no elimines.** Desconectar una conexión o eliminar una sincronización mantiene disponibles los registros y análisis importados; eliminar la fuente los pierde.