Los conectores de datos permiten a Fin acceder a datos en vivo de tus sistemas externos durante la conversación, como detalles de pedidos, estado de cuenta e información de suscripciones, sin que un humano tenga que buscar. Este artículo es tu índice para el proceso completo de configuración. Sigue las secciones en orden si comienzas desde cero, o salta a un tema específico si necesitas un repaso.
Antes de comenzar
Lee primero la visión conceptual. Explica qué son los conectores de datos y los objetos personalizados, cómo se relacionan y cuándo necesitas uno u otro:
Data connectors and Custom Objects explained — cubre los conceptos básicos, la relación entre conectores y objetos personalizados, y la diferencia entre Fin connectors y Workflow connectors.
Paso 1: Diseña APIs y configura tu conector
Comienza diseñando tus APIs y luego crea el Data connector definiendo cómo llama a tu API.
Designing and using your APIs with Data connectors — explica cómo estructurar tus endpoints API para que funcionen bien con Fin data connectors, antes de comenzar la configuración del conector.
How to set up Data connectors — cubre las cuatro fases de configuración en detalle, incluyendo la API (entradas de datos y endpoints API), datos (formateo de la respuesta API), Fin (cómo Fin activa el conector) y seguridad (control de acceso y puesta en producción).
Use Data connector templates — comienza rápido con una plantilla de data connector usando apps de terceros instaladas en tu workspace.
Paso 2: Autenticación y seguridad
Antes de poner en producción, configura cómo tu conector se autentica con tu API externa y si los clientes deben ser verificados antes de exponerles datos.
Setting up Data connectors authentication — cubre tipos de tokens de autenticación (texto, OAuth, JWT), la página de Credenciales y cómo habilitar la autenticación de clientes en conectores individuales.
Secure Data connectors with One-Time Passcode — aplica verificación OTP antes de que Fin exponga datos de clientes.
Best practices when using Data connectors with Fin — cubre las verificaciones de seguridad integradas en la pestaña Security, riesgos comunes y recomendaciones antes de poner en producción.
Importante: Si no aplicas autenticación de clientes, actores maliciosos podrían suplantar a tus users y acceder a sus datos. Como mínimo, revisa las verificaciones integradas en la pestaña Security antes de activar cualquier conector.
Paso 3: Esquemas de respuesta, objetos y arrays
La forma de la respuesta de tu API determina cómo Fin lee y usa los datos devueltos. Esta sección explica cómo manejar diferentes estructuras de respuesta.
JSON objects and arrays supported for Data connectors response mapping — cubre objetos planos, objetos anidados, arrays y respuestas XML (convertidas automáticamente a JSON). Lee esto si tu API devuelve datos complejos o anidados.
Paso 4: Objetos personalizados y propiedades
Los objetos personalizados te permiten almacenar datos estructurados con múltiples propiedades en Intercom, como pedidos, suscripciones o citas, que no se capturan con atributos estándar de contacto o conversación. Normalmente los llenas mapeando la respuesta de un conector al objeto.
Setting up a Custom Object — cubre la creación de tipos de objetos, definición de propiedades, llenado del objeto vía un data connector y configuración de referencias a objetos People y Conversation.
Paso 5: Mapeo de objetos
El mapeo de objetos indica al conector dónde almacenar en Intercom los datos de respuesta de la API. Puedes mapear a objetos estándar (atributos de contacto y conversación) o a objetos personalizados.
Setting up references with Custom Objects — explica cómo mapear campos de respuesta API directamente a atributos de contacto o empresa en Intercom, sincronizando automáticamente datos de tu sistema externo a tu workspace de Intercom.
How to set up Data connectors for Workflows and Inbox — contiene detalles adicionales sobre el mapeo a objetos personalizados, incluyendo el requisito external_id.
Paso 6: Pruebas
Cada conector tiene una herramienta de prueba integrada que te permite validar la llamada API y la forma de la respuesta antes de ponerlo en producción. Usa el botón Test connection en la pestaña Data del conector para confirmar la solicitud y respuesta completas. Para pruebas end-to-end de cómo Fin usa el conector en una conversación, usa reglas de audiencia para dirigir el conector al email de tu propio user.
How to roll out Data connectors safely — explica cómo monitorear y gestionar tus data connectors, y ver la actividad de data connectors en el inbox.
Paso 7: Uso de data connectors en procedimientos Fin
Fin puede llamar a un Data connector directamente para responder una pregunta del cliente, pero los conectores también son un bloque fundamental para procedimientos más complejos y de múltiples pasos — por ejemplo, buscar un pedido, luego ofrecer actualizarlo y confirmar el cambio.
How to use Data connectors in Fin Procedures — te enseña cómo Fin puede leer y actuar sobre datos API externos y realizar acciones automáticas durante conversaciones con clientes.
Solución de problemas y preguntas frecuentes
Si tu conector no funciona como esperas, comienza con el artículo de solución de problemas. Para preguntas de seguridad y privacidad, el artículo de FAQs cubre las dudas más comunes.
Understanding Data connector errors — te enseña a leer e interpretar los registros de data connectors, identificar causas de errores y tomar las medidas correctas para resolverlos.
Troubleshooting Fin Procedures and Data connectors — cubre los fallos más comunes, incluyendo conectores que pasan pruebas pero fallan en procedimientos en vivo, errores de entrada y problemas de análisis de respuesta.
Data connectors FAQs — cubre privacidad de datos, seguridad, riesgos de suplantación y otras preguntas frecuentes.
Referencia rápida: todos los artículos de Data connector
Usa esta tabla para ir directamente a cualquier artículo en la documentación de Data connectors.
Artículo | Qué cubre |
Conceptos básicos y cuándo usar cada uno | |
Estructura de tus endpoints API para funcionar bien con Fin | |
Guía principal de configuración del conector, cubre las cuatro fases en detalle | |
Plantillas de inicio rápido usando apps de terceros | |
Tokens de autenticación, credenciales, autenticación de clientes | |
Verificaciones de seguridad, mejores prácticas antes de poner en producción | |
Esquemas de respuesta, objetos anidados, arrays, XML | |
Tipos de objetos personalizados, propiedades, llenado vía conector | |
Mapeo de respuesta API a atributos de Intercom | |
Uso y indicadores de salud de Fin | |
Casos de uso y ejemplos de Data connector | |
Permitiendo que Fin lea y actúe sobre datos API externos | |
Caso de uso Workflow/Inbox, detalle de mapeo de objetos | |
Registros y errores de data connector | |
Fallos comunes y soluciones | |
Privacidad, seguridad y preguntas comunes |