Utiliza este artículo para configurar, gestionar y administrar conectores de datos, la función que permite a Fin obtener datos en vivo de tus sistemas externos y ofrecer respuestas personalizadas a los clientes sin esperar a un compañero. Aprenderás a crear un conector desde una plantilla o desde cero, configurar su endpoint API, dar forma a la respuesta, controlar quién puede activarlo, manejar la seguridad, implementarlo de forma segura y monitorear su rendimiento.
Nota: Necesitas el permiso "Can access developer hub" permiso para crear, editar o activar un conector de datos.
¿Cómo funcionan los conectores de datos?
Cada conector de datos consiste en una llamada API (interfaz de programación de aplicaciones) que configuras. Fin determina automáticamente cuándo usarla para ofrecer respuestas específicas al cliente. Puedes conectar cualquier sistema con una API, incluyendo:
Herramientas internas personalizadas de backend
Plataformas de terceros (Shopify, Salesforce, Stripe, Jira, etc.)
Consejo: Los conectores de datos pueden ser usados por Fin en Procedures y otras automatizaciones, incluyendo Workflows y macros del Inbox. Aprende más sobre cómo diseñar y usar tus APIs con conectores de datos.
Cómo crear un conector de datos
Navega a Settings > Integrations > Data connectors y haz clic en Nuevo.
Si tienes instalada una de las apps soportadas, verás una plantilla para esta app listada bajo Crear conector de datos. Actualmente hay plantillas disponibles para Shopify, Stripe y Statuspage — consulta Desde una plantilla de terceros abajo para más detalles.
Desde una plantilla de terceros
Las plantillas de conectores de datos están disponibles cuando las siguientes apps están instaladas en tu espacio de trabajo:
Si la app no está instalada, ve a la App Store para instalarla. Una vez instalada, las plantillas de conectores de datos para cada app aparecerán como un conector de datos listo para activar.
Cuando haces clic en una plantilla, verás información sobre lo que hace el conector de datos y puedes probarlo en la vista previa del Messenger. Si estás satisfecho con el comportamiento del conector de datos, solo selecciona Activar para AI Agent.
La vista previa del Messenger aquí usa datos de ejemplo. Al activar el conector de datos, Fin usará los datos reales de tus clientes.
Si quieres configurar el conector de datos, puedes hacer clic en Personalizar, lo que te llevará al constructor de conectores de datos para una configuración avanzada.
Si no tienes instalada una de nuestras apps soportadas, las apps aparecerán aquí para que las instales en tu espacio de trabajo. Después de la instalación, las plantillas relevantes de conectores de datos aparecerán en la sección anterior.
Aprende más sobre las plantillas de conectores de datos disponibles y casos de uso para Fin.
Desde una recomendación de AI
Para ver los conectores de datos recomendados por AI, ve a Settings > Integrations > Data connectors y haz clic en Nuevo conector de datos.
Verás tus conectores de datos recomendados por AI únicos bajo "Crear conector de datos desde plantilla". Estos se generan basándose en tu historial de conversaciones para ayudarte a identificar posibles conectores de datos, ver qué porcentaje del volumen de conversaciones podrían resolver y previsualizarlos en el Messenger antes de configurar algo.
Para que aparezcan las recomendaciones de AI, Fin debe estar activo en tu espacio de trabajo y debes tener un volumen suficiente de conversaciones.
Cuando haces clic en un conector de datos recomendado por AI, encontrarás información sobre lo que hace el conector de datos y puedes previsualizarlo en el Messenger (usando datos de ejemplo). Los conectores de datos recomendados por AI son solo sugerencias basadas en tu volumen de conversaciones, pero requieren que una API se conecte manualmente para funcionar.
Para activar el conector de datos, haz clic en Configurar para configurar los detalles de la API.
Ahora solo necesitas conectar el conector de datos a tu API añadiendo la URL HTTPS.
Para personalizar aún más este conector de datos, consulta la sección Desde un conector de datos personalizado.
Crear un conector de datos personalizado desde cero
Para configurar tu propio conector de datos personalizado para Fin, navega a Settings > Integrations > Data connectors y haz clic en + Nuevo > + Crear desde cero.
Fase 1: API
La pestaña API define cómo Intercom se comunica con tu sistema externo.
Dale a tu conector un nombre corto y descriptivo — por ejemplo, "Obtener saldo de cuenta impago." Esto ayuda a Fin a entender cuándo usarlo. Añade una descripción interna para referencia de tu equipo.
Consulta las mejores prácticas para redactar descripciones de conectores de datos.
Nota: Los emojis no son compatibles en los nombres de conectores de datos y causarán un error si se incluyen.
Entradas de datos
Las entradas de datos te permiten especificar qué información Fin necesita recopilar antes de que el conector se ejecute — por ejemplo, el número de cuenta de un cliente si no está almacenado ya en Intercom.
Haz clic en + Entrada de datos y elige un formato:
Texto
Número
Número decimal
Verdadero/Falso
Asigne a cada entrada un nombre y una descripción para que Fin sepa cómo recopilarla. También puede establecer un valor de respaldo para casos en que la API devuelva una respuesta nula o faltante.
Para cada entrada, elija de dónde provienen los datos:
Let Fin collect — Fin lo recopila automáticamente de la conversación
People attribute — extraído de un atributo existente de Intercom
Custom value — un valor fijo que usted define
API endpoint
Agregue la URL HTTPS (web segura) para su API endpoint y seleccione el método de solicitud HTTP: GET (recuperar datos), POST (enviar datos), PUT (reemplazar datos), DELETE (eliminar datos) o PATCH (actualizar datos parcialmente).
Use el Attribute Inserter para pasar valores dinámicos — como el ID de usuario de un cliente — directamente en la ruta de la URL o en el cuerpo de la solicitud.
Autenticación y encabezados
Seleccione un token de autenticación y agregue cualquier encabezado personalizado de clave-valor que su API requiera (por ejemplo, Content-Type: application/json).
Nota: Puede adjuntar múltiples tokens a un solo conector. Cada token debe usar una clave de encabezado diferente; todos los tokens adjuntos se envían con cada solicitud.
Una vez que la URL del endpoint y los detalles de autenticación estén completos, haga clic en Test connection para validar su configuración. Una prueba exitosa devuelve una confirmación verde y la respuesta API sin procesar. Una prueba fallida muestra el código de error HTTP y una descripción; resuelva cualquier error antes de continuar a la Fase 2: Data.
Fase 2: Data — moldeando la respuesta de la API
La pestaña Data controla cómo se filtra y transforma la respuesta de la API antes de que Fin la use para responder a los clientes. Puede restringir qué campos ve Fin y remodelar los datos usando un editor visual o código Python.
Restringir y moldear
Por defecto, Fin tiene acceso a la respuesta completa de la API. Para limitar lo que Fin puede leer, cambie a Restringir acceso manualmente y seleccione solo los campos que desea exponer.
Elija cómo desea transformar la respuesta:
Vista de tabla — filtre campos, renómbrelos y establezca transformaciones a nivel de campo usando un editor visual
Python — escriba código Python para limpiar, remodelar o reformatear la respuesta antes de que llegue a Fin
Mapeo de objetos
El mapeo de objetos le permite asignar campos de respuesta de la API directamente a atributos de contacto o empresa de Intercom, sincronizando automáticamente los datos de su sistema externo con su espacio de trabajo de Intercom.
Haga clic en Test code para validar su lógica de transformación en Python, y en Test connection para confirmar la llamada completa a la API y la forma de la respuesta. Resuelva cualquier error antes de continuar a la Fase 3: Fin.
Fase 3: Fin — cómo Fin activa el conector
La pestaña Fin controla si Fin activa el conector Data automáticamente o solo cuando se llama explícitamente desde un workflow, procedure o macro. Elija el modo de activación que coincida con la sensibilidad o actividad de escritura del conector.
¿Cómo debería usar Fin este conector?
Habilitado (activación directa)
Fin activa el conector automáticamente según la pregunta del cliente — no se requiere workflow. Ideal para conectores solo de lectura como "Check order status" y consultas repetitivas de alto volumen.
Puede controlar quién tiene acceso a este conector Data con audiencias Fin reutilizables, o creando una audiencia personalizada específicamente para este conector. Por ejemplo, podría estar disponible para clientes en su audiencia "Enterprise plan", o restringirlo a una audiencia personalizada como usuarios logged-in con un correo electrónico verificado que pregunten sobre su saldo de cuenta.
Nota: Ahora puede usar audiencias Fin con conectores Data. Las audiencias Fin son grupos de clientes reutilizables que crea una vez y luego aplica en múltiples conectores, facilitando mantener la coherencia.
Puede elegir Everyone, una audiencia Fin reutilizable o una audiencia Custom para reglas puntuales.
Puede seleccionar múltiples audiencias Fin, pero no puede combinar reglas Custom con una audiencia Fin.
Cualquier regla de audiencia de conector Data existente que haya configurado se convertirá en una audiencia Custom para preservar la funcionalidad.
Consejo: Si desea probar el conector Data antes de habilitarlo para los clientes, use las reglas de audiencia para habilitar el conector Data solo para usted o sus compañeros inicialmente.
Deshabilitado (activación manual)
El conector no se ejecutará automáticamente. Deberá agregarlo manualmente a un Workflow, Procedure o Macro. Ideal para conectores sensibles o con actividad de escritura, como "Delete account", donde desea supervisión humana o de workflow antes de que se ejecute algo.
Use la vista previa de Fin para ver exactamente cómo Fin responderá usando este conector antes de ponerlo en vivo.
Fase 4: Seguridad — control de acceso y puesta en vivo
La pestaña Seguridad es el paso final antes de la puesta en vivo. Controla si los clientes deben estar autenticados antes de que el conector Data pueda acceder o mostrar sus datos.
Autenticación del cliente
Active esto para hacer cumplir las reglas de autenticación de su espacio de trabajo antes de que el conector pueda acceder o mostrar información sensible. Las reglas de autenticación se configuran en Configuración > Espacio de trabajo > Seguridad > Autenticación del cliente.
Verificación de seguridad
Ejecute un diagnóstico para evaluar la salud y seguridad de su configuración de API. Se detectan riesgos con recomendaciones accionables: resuélvalos antes de activar el conector.
Una vez que todas las verificaciones de seguridad pasen, haga clic en Guardar y luego en Activar. El estado del Data connector cambia a Activo en Configuración > Integraciones > Data connectors. Fin comenzará a usarlo inmediatamente para conversaciones que coincidan con la audiencia configurada.
Importante: Existen algunas formas en que Fin podría compartir accidentalmente información de otro usuario al pasar parámetros. Consulte nuestras configuraciones recomendadas para mitigar mejor los riesgos.
Cómo implementar Data connectors de forma segura
Nota: La vista previa del Messenger aquí usa datos de ejemplo. Al activar el Data connector, Fin usará los datos reales de sus clientes.
Los Data connectors requieren que AI Answers esté habilitado en el paso del workflow para que Fin los use. AI Answers no puede habilitarse en espacios de prueba, por lo que los Data connectors solo pueden probarse completamente en entornos de producción. Use perfiles de usuarios de prueba en producción para pruebas seguras.
Recomendamos usar reglas de audiencia para implementar Data connectors en fases a su base de clientes. Esto le permite validar el rendimiento del Data connector y hacer ajustes o cambios cuando sea necesario.
Cómo monitorear y gestionar Data connectors
Para encontrar Data connectors existentes, navegue a Configuración > Integraciones > Data connectors. La lista de Data connectors muestra los siguientes detalles para cada conector:
Nombre y estado (activo o borrador)
Uso general (total de ejecuciones)
Uso de Fin — tasa de resolución y la audiencia a la que está disponible
Salud — tasa de éxito de API e indicador general de salud
Estado de seguridad
Detalles de configuración
Haga clic en una fila del conector para abrir su panel de salud, donde puede revisar el uso, métricas de rendimiento y registros de ejecución, o abrir el editor de configuración para hacer cambios.
Cómo ver la actividad del Data connector en el Inbox
Para ver la actividad del Data connector en una conversación específica, abra la conversación en el Inbox y seleccione Mostrar eventos de conversación. El panel de eventos muestra si Fin tuvo acceso al Data connector y si se activó con éxito.
Nota:
Si hay un error al activar el Data connector, seleccione Registros para saber por qué.
Fin puede no elegir siempre usar el Data connector a pesar de hacer una solicitud API si se determina que otro contenido es más relevante.
Fin no puede consultar atributos personalizados ni datos de eventos para respuestas. Para que Fin responda con datos de activos en tiempo real, configure Data Connectors para que Fin pueda acceder a fuentes de datos externas vía API.
Las vistas de Inbox pueden crearse con el atributo “Fin AI Agent: Acción usada en la respuesta”. Este atributo se establece si Fin llama a un Data connector y usa parte o toda la respuesta en una respuesta.
Versionado de Data connector
Los Data connectors usan un sistema de versionado borrador/activo para que pueda hacer ediciones de forma segura sin interrumpir el conector en ejecución.
Cada Data connector tiene una versión activa y una versión borrador. Las ediciones se hacen en el borrador sin afectar la versión activa en ejecución.
Cuando publica un borrador, se crea una nueva instantánea de versión que se convierte en la versión activa. Puede agregar notas al publicar. La versión activa anterior se archiva.
Cada versión registra un número de versión, quién la creó, notas de cambio (si se agregaron) y una marca de tiempo.
El historial completo de cambios es rastreable y puede revertir a cualquier versión anterior.
APIs públicas para Data connectors
Dos APIs públicas (interfaces de programación de aplicaciones) le brindan acceso programático a configuraciones y resultados de ejecución de Data connectors. Ambas usan OAuth (Open Authorization) para autenticación. La documentación completa está disponible en el Intercom Developer Hub.
Cómo usar la Configuration API
La Configuration API es un conjunto de endpoints CRUD (crear, leer, actualizar, eliminar) para gestionar programáticamente Data connectors. Úsela para crear nuevos conectores, mantenerlos sincronizados con sus sistemas internos y automatizar la gestión de conectores a escala. La tabla a continuación lista los endpoints disponibles y su propósito.
Método | Endpoint | Propósito |
GET | /data_connectors | Devuelve una lista paginada de todos los Data connectors del espacio de trabajo, ordenados por los más recientemente actualizados primero. |
GET | /data_connectors/:id | Recupera el detalle completo de un solo Data connector por ID, incluyendo configuración, entradas de datos, campos de respuesta y mapeos de objetos. |
POST | /data_connectors | Crea un nuevo Data connector en estado borrador. Configure su URL, encabezados, entradas de datos y otras configuraciones, luego actívelo cuando esté listo. |
PATCH | /data_connectors/:id | Actualiza un conector de datos existente. Solo se cambian los campos proporcionados. Establezca el estado en live o draft para cambiar el estado del conector. |
ELIMINAR | /data_connectors/:id | Elimina un conector de datos existente. El conector debe estar en estado draft y no debe estar en uso por ningún workflows o agentes AI. |
La autenticación utiliza OAuth (Open Authorization). El acceso de lectura y escritura requiere el ámbito read_write_data_connectors. El acceso solo de lectura requiere el ámbito read_workflow_connector_execution_result.
Cómo usar la Results API
La Results API te da acceso programático a los datos de ejecución de cada conector de datos. Úsala para crear paneles personalizados, alimentar sistemas de alertas o realizar análisis más profundos que el panel de salud del producto.
GET /data_connectors/:id/execution_results — recupera registros de ejecución paginados. Por defecto, se devuelven resultados de la última hora. Usa
start_tsyend_tspara personalizar el rango de tiempo. Los cuerpos de solicitud/respuesta se excluyen por defecto — usainclude_bodies=truepara incluirlos.GET /data_connectors/:id/execution_results/:result_id — recupera un único resultado de ejecución, siempre incluyendo cuerpos completos de solicitud/respuesta para una depuración profunda.
Las opciones de filtrado incluyen estado de éxito, tipos específicos de error y rangos de tiempo especificados como marcas de tiempo Unix (segundos transcurridos desde el 1 de enero de 1970 UTC). La paginación usa un modelo basado en cursor, devolviendo hasta 30 resultados por página. La autenticación utiliza OAuth con el ámbito read_workflow_connector_execution_result.
Limitaciones conocidas
Las siguientes limitaciones se aplican a los conectores de datos. Cuando hay una solución alternativa disponible, se indica a continuación.
Fin puede no usar siempre un conector de datos incluso si ejecuta correctamente una solicitud API — si otro contenido se considera más relevante para la pregunta del cliente, Fin usará ese en su lugar. No hay solución alternativa; revise el nombre y la descripción del conector para mejorar la coincidencia de relevancia.
Fin no puede consultar directamente atributos personalizados de Intercom o datos de eventos para responder preguntas. Use un conector de datos para exponer estos datos a través de un endpoint API externo.
Los conectores de datos requieren que AI Answers esté habilitado en el paso del workflow para que Fin los use. AI Answers no puede habilitarse en espacios de prueba, por lo que los conectores de datos solo pueden probarse completamente en un entorno de producción. Use perfiles de usuario de prueba en producción para pruebas seguras.
El webhook de ejecución del conector de datos no se activa cuando el conector se activa como parte de una conversación de vista previa.
Un conector de datos solo puede eliminarse vía API cuando está en estado draft y no está referenciado por ningún workflows o agentes AI.
Los emojis no son compatibles en los nombres de conectores de datos — incluir uno causará un error al guardar.
Solución de problemas de conectores de datos
Cómo usar los registros de conectores de datos
Todos los datos de respuesta de los conectores de datos activados por Fin se registran y almacenan hasta por 14 días. Para acceder a los registros, navegue a Configuración > Integraciones > Data connectors, haga clic en el conector que desea investigar y seleccione Logs.
Cómo usar el webhook de ejecución del conector de datos
Para señales en tiempo real sobre tasas de éxito y fallo del conector de datos, use el webhook de ejecución del conector de datos. Esto le permite recibir eventos de ejecución de Intercom y usarlos para crear paneles en tiempo real, alertas y monitoreo SLA (acuerdo de nivel de servicio) en sus servicios externos.
Notas:
Necesitará crear una app, configurar Webhooks y suscribirse al webhook de ejecución del conector de datos antes de poder recibir notificaciones de conectores de datos.
El webhook de ejecución del conector de datos se omitirá si el conector de datos se activa como parte de una conversación de vista previa.