Use este artículo para configurar, ajustar y gestionar los conectores de datos: la función que permite a Fin recuperar datos en vivo de sus sistemas externos y ofrecer a los clientes respuestas personalizadas sin esperar a un compañero. Aprenderá cómo crear un conector a partir de una plantilla o desde cero, configurar su endpoint API, dar forma a la respuesta, controlar quién puede activarlo, gestionar la seguridad, desplegarlo de forma segura y supervisar su rendimiento.
Nota: Necesita el permiso "Can access developer hub" permission 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 (application programming interface) que usted configura. Fin determina automáticamente cuándo usarlo para ofrecer respuestas específicas al cliente. Puede 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 desde el Inbox. Obtenga más información sobre cómo diseñar y usar sus APIs con los conectores de datos.
Cómo crear un conector de datos
Vaya a Settings > Integrations > Data connectors y haga clic en New.
Si tiene instalada una de las aplicaciones compatibles, verá una plantilla para esta aplicación listada bajo Create Data connector. Actualmente hay plantillas disponibles para Shopify, Stripe y Statuspage — vea From a 3rd party template abajo para más detalles.
Desde una plantilla de terceros
Las plantillas de conectores de datos están disponibles cuando las siguientes aplicaciones están instaladas en su espacio de trabajo:
Si la aplicación no está instalada, vaya al App Store para instalarla. Una vez instalada la aplicación, las plantillas de Data connector templates para cada aplicación aparecerán como un Data connector listo para activar.
Cuando haga clic en una plantilla, verá información sobre lo que hace el conector de datos y podrá probarlo en la vista previa del Messenger. Si está satisfecho con el comportamiento del conector, simplemente seleccione Set live for AI Agent.
La vista previa del Messenger aquí usa datos de ejemplo. Al activar el conector de datos, Fin utilizará sus datos reales de clientes.
Si desea configurar el conector de datos, puede hacer clic en Customize, lo que le llevará al generador de conectores de datos para una configuración avanzada.
Si no tiene instaladas nuestras aplicaciones compatibles, las aplicaciones aparecerán aquí para que las instale en su espacio de trabajo. Después de la instalación, las plantillas de conectores de datos relevantes aparecerán en la sección anterior.
Obtenga más información sobre los Data connector templates disponibles y los casos de uso para Fin.
Desde una recomendación de IA
Para ver los conectores de datos recomendados por IA, vaya a Settings > Integrations > Data connectors y haga clic en New Data connector.
Verá sus conectores de datos recomendados por IA únicos bajo "Create Data connector from template". Estos se generan basándose en su historial de conversaciones para ayudarle a identificar posibles conectores de datos, ver qué porcentaje del volumen de conversaciones podrían resolver y previsualizarlos en el Messenger, antes de configurar nada.
Para que aparezcan recomendaciones de IA, Fin debe estar activo en su espacio de trabajo y debe tener un volumen de conversaciones suficiente.
Cuando haga clic en un conector de datos recomendado por IA, encontrará información sobre lo que hace el conector y podrá previsualizarlo en el Messenger (usando datos de ejemplo). Los conectores de datos recomendados por IA son meras sugerencias basadas en su volumen de conversaciones, pero requieren que se conecte manualmente una API para que funcionen.
Para activar el conector de datos, haga clic en Set up para configurar los detalles de la API.
Ahora lo único que necesita hacer es conectar el conector de datos a su API añadiendo la HTTPS URL.
Para personalizar más este conector de datos, consulte la sección From a custom Data connector.
Crear un conector de datos personalizado desde cero
Para configurar su propio conector de datos personalizado para Fin, vaya a Settings > Integrations > Data connectors y haga clic en + New > + Create from scratch.
Fase 1: API
La pestaña API define cómo Intercom se comunica con su sistema externo.
Déle a su conector un nombre corto y descriptivo — por ejemplo, "Get unpaid account balance." Esto ayuda a Fin a entender cuándo usarlo. Añada una descripción interna para referencia de su equipo.
Vea las mejores prácticas para redactar descripciones de conectores de datos.
Nota: Los emojis no son compatibles en los nombres de los conectores de datos y provocarán un error si se incluyen.
Entradas de datos
Las entradas de datos le permiten especificar qué información necesita Fin recopilar antes de ejecutar el conector — por ejemplo, el número de cuenta de un cliente si no está ya almacenado en Intercom. Cuando Fin necesita pasar una consulta de búsqueda u otro valor a la API según lo que pregunte un cliente, añada una entrada de datos y establezca la fuente en Let Fin collect — Fin recopilará el valor automáticamente de la conversación.
Haga clic en + Data input y elija 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 reserva para los 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 define
Después de seleccionar una fuente, use el interruptor Obligatorio para establecer si la entrada es obligatoria u opcional. Esto debe configurarse manualmente para cada entrada (el estado no se establece automáticamente).
La etiqueta del interruptor cambia según la fuente seleccionada:
Let Fin collect: el interruptor muestra Fin must collect this parameter. Cuando está habilitado, Fin debe recopilar este valor del cliente antes de que el conector pueda ejecutarse.
People attribute o Custom value: el interruptor muestra This parameter must have a value. Cuando está habilitado, el conector no se ejecutará si falta el valor.
El estado de obligatorio u opcional de cada entrada se muestra en la lista de entradas de datos.
API endpoint
Agregue la URL HTTPS (web segura) de su endpoint de API y seleccione el método de solicitud HTTP: GET (recuperar datos), POST (enviar datos), PUT (reemplazar datos), DELETE (eliminar datos) o PATCH (actualizar parcialmente datos).
Use el Attribute Inserter para pasar valores dinámicos — como el user ID de un cliente — directamente en la ruta de la URL o en el cuerpo de la solicitud. Seleccione siempre los atributos usando el selector — nunca escriba tokens manualmente.
Nota: Si su conector llama a la Intercom Contacts API y necesita identificar un contacto, seleccione Contact ID (user.id) del selector — no User ID (user_id). La Contacts API espera el ID de contacto generado por Intercom (user.id). Usar user_id (el ID establecido externamente) hará que la búsqueda falle.
Importante: el editor convierte cualquier texto {{...}} en una píldora, por lo que un token escrito manualmente se ve idéntico a un atributo válido. Si el identificador no coincide con un atributo real — como user.id o user_id — se resolverá como un valor vacío en tiempo de ejecución. Esto hace que la URL de su solicitud sea incorrecta y provoque errores como 404 sin indicación visible en el editor. Siempre use el selector Attribute Inserter para insertar atributos.
Autenticación y cabeceras
Seleccione un token de autenticación y agregue las cabeceras clave-valor personalizadas que su API requiera (por ejemplo, Content-Type: application/json).
Nota: Si envía un cuerpo de solicitud JSON (POST, PUT o PATCH), debe agregar explícitamente una cabecera Content-Type: application/json. Sin ella, la API receptora no analizará el cuerpo de la solicitud y rechazará todos los campos como inválidos — incluso si el JSON está correctamente formateado.
Nota: Puede adjuntar múltiples tokens a un solo conector. Cada token debe usar una clave de cabecera 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 bruta de la API. Una prueba fallida muestra el código de error HTTP y una descripción — resuelva cualquier error antes de continuar a la Fase 2: Datos.
Fase 2: Datos — dar forma a la respuesta de la API
La pestaña Datos 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 dar forma
Por defecto, Fin tiene acceso a la respuesta completa de la API. Para limitar lo que Fin puede leer, cambie a Manually restrict access y seleccione solo los campos que desea exponer.
Nota: Al usar Manually restrict access, los campos cuyos nombres contienen caracteres especiales — como paréntesis (), signos más + o barras / — pueden excluirse silenciosamente de los datos que Fin recibe, debido a un error de coincidencia de ruta. Para evitar esto, cambie el nombre de los campos afectados para eliminar caracteres especiales antes de restringir el acceso. Alternativamente, use acceso completo a los datos si la respuesta no contiene datos sensibles.
Elija cómo le gustaría transformar la respuesta:
Vista de tabla — filtre campos, cámbieles el nombre 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 la respuesta de la API directamente a atributos de contacto o empresa de Intercom, sincronizando automáticamente datos desde su sistema externo a su espacio de trabajo de Intercom.
Haga clic en Test code para validar su lógica de transformación en Python, y Test connection para confirmar la llamada completa a la API y la forma de la respuesta. Resuelva cualquier error antes de pasar a la Fase 3: Fin.
Nota: Cuando selecciona el mapeo de objetos, verá solo los objetos mapeados en Workflows y Procedures; mientras que sin mapeo, todas las opciones seleccionadas en la tabla Restrict and shape the data se mostrarán. Para Python, solo se verán los valores devueltos
Fase 3: Fin — cómo Fin activa el conector
La pestaña Fin controla si Fin activa el conector automáticamente o solo cuando se invoca explícitamente desde un workflow, procedure, o macro. Elija el modo de activación que coincida con la sensibilidad o la actividad de escritura del conector.
Consejo: Antes de que Fin pueda usar un conector, asegúrese de que cada uno de los siguientes esté en su lugar:
Data inputs: Para cualquier valor que Fin necesite pasar a la API — como una consulta de búsqueda, nombre de producto o ID de pedido — agregue una entrada de datos con la fuente configurada en Let Fin collect. Esto le indica a Fin que recopile los términos relevantes de la conversación y los pase a la API automáticamente.
Test connection: Ejecute una prueba exitosa usando datos reales (Fase 1). La respuesta de la prueba moldea lo que Fin verá y devolverá a los clientes — los datos de ejemplo no reflejarán resultados reales.
Fin trigger: En esta pestaña Fin, establezca How should Fin use this connector? en Enabled (direct trigger).
Connector description: Escriba una descripción clara y concisa de lo que hace el conector y cuándo utilizarlo. Así es como Fin decide cuándo invocarlo.
Set live: Complete las verificaciones de seguridad en la Fase 4, luego haga clic en Save y Set live.
How should Fin use this connector?
Enabled (direct trigger)
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.
Puedes controlar quién puede usar este conector de datos con audiencias reutilizables Fin, o creando una audiencia personalizada específicamente para este conector. Por ejemplo, podrías hacerlo disponible para clientes en tu audiencia "Enterprise plan", o restringirlo a una audiencia personalizada como usuarios con sesión iniciada y correo verificado que pregunten por su saldo.
Nota: Ahora puedes usar audiencias Fin con conectores de datos. Las audiencias Fin son grupos de clientes reutilizables que creas una vez y luego aplicas en varios conectores, lo que facilita mantener la coherencia.
Puedes elegir Todos, una audiencia Fin reutilizable o una audiencia Personalizada para reglas puntuales.
Puedes seleccionar múltiples audiencias Fin, pero no puedes combinar reglas Personalizadas con una audiencia Fin.
Cualquier regla de audiencia de conectores de datos existente que hayas configurado se convertirá en una audiencia Personalizada para preservar la funcionalidad.
Consejo: Si quieres probar el conector de datos antes de habilitarlo para los clientes, usa las reglas de audiencia para habilitar el conector de datos solo para ti o tus compañeros inicialmente.
Deshabilitado (disparador manual)
El conector no se ejecutará automáticamente. Necesitarás agregarlo manualmente a un Workflow, Procedure o Macro. Es mejor para conectores sensibles o que escriben activamente, como "Delete account", donde quieres supervisión humana o de workflow antes de que se ejecute cualquier acción.
Usa la vista previa de Fin para ver exactamente cómo responderá Fin usando este conector antes de ponerlo en producción.
Nota: Los cambios en la configuración del disparador de Fin se guardan en modo borrador y no entrarán en efecto hasta que los publiques. La versión en vivo del conector continúa usando su configuración existente hasta que hagas clic en Set live. Después de realizar cambios, confirma siempre que la configuración esté reflejada en la versión en vivo, no solo en el borrador.
Fase 4: Seguridad — control de acceso y puesta en marcha
La pestaña Seguridad es el paso final antes de ponerlo en producción. Controla si los clientes deben estar autenticados antes de que el conector de datos pueda acceder o mostrar sus datos.
Autenticación del cliente
Activa esto para hacer cumplir las reglas de autenticación de tu espacio de trabajo antes de que el conector pueda acceder o mostrar información sensible. Las reglas de autenticación se configuran en Settings > Workspace > Security > Customer authentication.
Verificación de seguridad
Ejecuta un diagnóstico para evaluar la salud y seguridad de tu configuración de API. Cualquier riesgo se mostrará con recomendaciones accionables: resuélvelos antes de poner el conector en producción.
Una vez que todas las verificaciones de seguridad pasen, haz clic en Save y luego en Set live. El estado del conector de datos cambia a Live en Settings > Integrations > Data connectors. Fin comenzará a usarlo de inmediato para conversaciones que coincidan con la audiencia configurada.
Importante: Hay algunas formas en las que Fin podría compartir información de otro usuario accidentalmente al pasar parámetros. Consulta nuestras configuraciones recomendadas para mitigar mejor los riesgos.
Cómo implementar conectores de datos de forma segura
Nota: La vista previa de Messenger aquí usa datos de ejemplo. Al poner el conector de datos en producción, Fin usará los datos reales de tus clientes.
Los conectores de datos requieren que AI Answers esté habilitado en el paso del workflow para que Fin los use. AI Answers no se puede habilitar en espacios de prueba, por lo que los conectores de datos solo se pueden probar completamente en entornos de producción. Usa perfiles de usuarios de prueba en producción para pruebas seguras.
Recomendamos usar reglas de audiencia para implementar conectores de datos por fases a tu base de clientes. Esto te permite validar el rendimiento del conector de datos y hacer ajustes cuando sea necesario.
Cómo supervisar y administrar conectores de datos
Para encontrar los conectores de datos existentes, navega a Settings > Integrations > Data connectors. La lista de conectores de datos muestra los siguientes detalles para cada conector:
Nombre y estado (en vivo o borrador)
Uso general (ejecuciones totales)
Uso de Fin — tasa de resolución y la audiencia a la que está disponible
Estado de salud — tasa de éxito de API y un indicador general de salud
Estado de seguridad
Detalles de configuración
Haz clic en una fila del conector para abrir su panel de estado, donde puedes revisar 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 conector de datos en el Inbox
Para ver la actividad del conector de datos en una conversación específica, abre la conversación en el Inbox y selecciona Mostrar eventos de la conversación. El panel de eventos muestra si Fin tuvo acceso al conector de datos y si se activó correctamente.
Nota:
Si hay un error al activar el conector de datos, selecciona Logs para averiguar por qué.
Fin puede no siempre elegir usar el conector de datos a pesar de hacer una solicitud de API si se determina que otro contenido es más relevante.
Fin no puede consultar atributos personalizados o datos de eventos para respuestas. Para permitir que Fin responda con datos de activos en tiempo real, configura Data Connectors para que Fin pueda acceder a fuentes de datos externas vía API.
Inbox views se pueden crear con el atributo “Fin AI Agent: Action used in reply”. Este atributo se establece si Fin llama a un Data connector y usa parte o la totalidad de la respuesta en una respuesta.
Versionado de conectores de datos
Los conectores de datos usan un sistema de versiones borrador/en vivo para que puedas editar de forma segura sin interrumpir el conector en ejecución.
Cada conector de datos tiene una versión en vivo y una versión borrador. Las ediciones se realizan en el borrador sin afectar la versión en vivo en ejecución.
Cuando publicas un borrador, se crea una nueva instantánea de versión y se convierte en la versión en vivo. Puedes añadir notas al publicar. La versión en vivo anterior se archiva.
Cada versión registra un número de versión, quién la creó, notas de cambio (si se añadieron) y una marca de tiempo.
Todo el historial de cambios es rastreable y puedes volver a cualquier versión anterior.
Nota: Esto se aplica a todas las configuraciones de conector, incluido el interruptor de activación de Fin. Si cambias ¿Cómo debería Fin usar este conector? y no publicas, la versión activa seguirá disparándose exactamente como antes. Un banner en el editor indica que tienes cambios sin guardar; siempre haz clic en Set live para activar tus cambios.
Public APIs for Data connectors
Dos public APIs (application programming interfaces) te dan acceso programático a las configuraciones y resultados de ejecución de los Data connectors. Ambos usan OAuth (Open Authorization) para la autenticación. La documentación de referencia completa está disponible en el Intercom Developer Hub.
Cómo usar la Configuration API
La Configuration API es un conjunto de endpoints CRUD (create, read, update, delete) para gestionar programáticamente los Data connectors. Úsala para crear nuevos conectores, mantenerlos sincronizados con tus sistemas internos y automatizar la gestión de conectores a escala. La tabla a continuación enumera 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, ordenada por los más recientemente actualizados primero. |
GET | /data_connectors/:id | Recupera el detalle completo de un solo Data connector por ID, incluida la configuración, entradas de datos, campos de respuesta y mapeos de objetos. |
POST | /data_connectors | Crea un nuevo Data connector en estado borrador. Configura su URL, encabezados, entradas de datos y otras configuraciones, luego publícalo cuando esté listo. |
PATCH | /data_connectors/:id | Actualiza un Data connector existente. Solo se cambian los campos proporcionados. Establece el estado en live o draft para cambiar el estado del conector. |
DELETE | /data_connectors/:id | Elimina un Data connector existente. El conector debe estar en estado borrador y no debe estar siendo utilizado por ningún workflows o AI agents. |
La autenticación usa OAuth (Open Authorization). El acceso de lectura y escritura requiere el scope read_write_data_connectors. El acceso solo lectura requiere el scope 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 Data connector. Úsala para construir paneles personalizados, alimentar sistemas de alertas o realizar análisis más profundos de los que ofrece el panel de estado del producto.
GET /data_connectors/:id/execution_results — recupera registros de ejecución paginados. Por defecto se devuelven los resultados de la última hora. Usa
start_tsyend_tspara personalizar el rango de tiempo. Los cuerpos de petición/respuesta están excluidos por defecto; usainclude_bodies=truepara incluirlos.GET /data_connectors/:id/execution_results/:result_id — recupera un único resultado de ejecución, siempre incluyendo los cuerpos completos de petición/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 timestamps 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 usa OAuth con el scope read_workflow_connector_execution_result.
Limitaciones conocidas
Las siguientes limitaciones se aplican a los Data connectors. Cuando existe una solución alternativa, se indica a continuación.
Fin may not always use a Data connector even if it successfully runs an API request — if other content is judged more relevant to the customer's question, Fin will use that instead. No workaround; review connector naming and description to improve relevance matching.
Fin cannot query Intercom custom attributes or event data directly to answer questions. Use a Data connector to expose this data via an external API endpoint instead.
Los Data connectors requieren que AI Answers esté habilitado en el paso del workflow para que Fin pueda usarlos. AI Answers no puede habilitarse en workspaces de prueba, por lo que los Data connectors solo se pueden probar completamente en un entorno de producción. Usa perfiles de usuario de prueba en producción para pruebas seguras.
The Data connector execution webhook is not fired when the connector is triggered as part of a preview conversation.
Un Data connector solo puede eliminarse vía API cuando está en estado borrador y no es referenciado por ningún workflows o AI agents.
No se admiten emojis en los nombres de Data connector; incluir uno provocará un error al guardar.
Nota: No existe un campo de tiempo de espera configurable por el cliente. El tiempo de espera predeterminado es de 15 segundos. Para los Data connectors usados dentro de Fin Procedures en workspaces elegibles, el tiempo de espera se amplía a 30 segundos.
Solución de problemas de los Data connectors
Cómo usar los registros de Data connector
Todos los datos de respuesta de los Data connectors activados por Fin se registran y almacenan hasta por 14 días. Si tu política de seguridad o cumplimiento requiere un periodo más corto, contacta a nuestro equipo de Support para solicitar una retención de 7 días en su lugar.
Para acceder a los registros, navega a Settings > Integrations > Data connectors, haz clic en el conector que quieres investigar y selecciona Logs.
Cómo usar el webhook de ejecución del Data connector
Para señales en tiempo real sobre tasas de éxito y fallo de los Data connectors, usa el Data connector execution webhook. Esto te permite recibir eventos de ejecución desde Intercom y usarlos para construir paneles en tiempo real, alertas y monitoreo de SLA (service level agreement) en tus servicios externos.
Notas:
Necesitarás crear una app, configurar Webhooks y suscribirte al Data connector execution webhook antes de poder recibir notificaciones de Data connector.
The Data connector execution webhook will be skipped if the Data connector is triggered as part of a preview conversation.