Los conectores de datos son integraciones sin código y profundamente integradas que pueden conectar tus datos externos en vivo con Intercom. Estos datos en vivo pueden usarse para potenciar Fin, Workflows y el Inbox, permitiendo que tus clientes resuelvan sus consultas automáticamente.

Una excelente forma de comenzar es pensar en preguntas comunes que tus compañeros de equipo pasan mucho tiempo respondiendo, usando información que actualmente no está disponible en Intercom.

Estas pueden ser preguntas donde tus clientes simplemente quieren obtener información que almacenas en un sistema externo, como “¿Cuál es el estado de mi pedido?”, o realizar una acción con Data connector como, "Reprogramar una entrega" o "Procesar un reembolso" en tu sistema externo.

Cuando sabes qué preguntas quieres resolver, es sorprendentemente simple y rápido configurar un Data connector con poca o ninguna experiencia técnica.

Primero, navega a Configuración > Integraciones > Data connectors.

Aquí es donde configurarás todas las diferentes conexiones que tienes a datos externos (por ejemplo, Shopify, Salesforce, etc.) según tu caso de uso. Haz clic en + Nuevo.

Dale a tu Data connector un nombre único que explique exactamente qué Data connector tomará (por ejemplo, “Obtener ID de pedido”). Usa el campo de descripción para decir a tus compañeros cuándo usar este Data connector y qué información pueden esperar obtener (por ejemplo, “Obtener pedido para un ID dado. El ID de pedido debe almacenarse en Conversation CDA”).

Para permitir que Fin use este conector directamente, navega a la pestaña Fin y configura ¿Cómo debería Fin usar este conector? a Habilitado (activación directa). Si solo quieres que se use dentro de un Workflow, Tarea, Procedimiento o Macro, configúralo en Deshabilitado (activación manual).

Luego, completa los detalles de la solicitud. Aquí es donde deberás ingresar la URL HTTPS del sistema de terceros al que te estás conectando (por ejemplo, Shopify, Salesforce, etc.).

Puedes especificar qué Data connector quieres que tome esta solicitud seleccionando el método:

En este ejemplo, pediremos que la solicitud haga un GET del ID de pedido desde la API e ingrese la URL.

Puedes elegir agregar cualquier parámetro adicional a esta solicitud haciendo clic en Agregar par clave-valor y luego selecciona Par clave-valor bajo Encabezados HTTP:

Los conectores de datos soportan tanto tokens fijos como dinámicos para autenticación. Bajo los Encabezados HTTP, puedes seleccionar el token de autenticación que quieres usar en la solicitud, que luego se añadirá al encabezado.

Si estás haciendo una solicitud POST o PUT, tendrás la opción de proporcionar un cuerpo de solicitud para incluir cualquier dato que quieras enviar en la solicitud:

Luego, necesitarás probar la respuesta de este Data connector para asegurarte de que está obteniendo los datos correctos del sistema de terceros al que te conectas.

Haz clic en Probar solicitud para verificar que el Data connector se haya configurado correctamente. Deberías ver una marca verde y los detalles de esa solicitud si la conexión se valida con la API.

Esta es toda la información que ahora puedes usar para potenciar tus Workflows y proporcionar respuestas rápidas a los clientes, como el estado del pedido.

Por defecto, Fin puede acceder a todos los datos de la respuesta para generar respuestas. Selecciona Restringir acceso manualmente si deseas limitar los datos que Fin puede leer. Luego marca los campos de datos a los que quieres dar acceso a Fin.

También puedes editar los elementos de datos individuales haciendo clic en el ícono de editar para darle a tus datos de respuesta un nombre visible para el cliente, así como especificar cualquier transformación de los datos.

Por ejemplo, si la respuesta de la API devuelve un saldo de 0, en lugar de que Fin diga que el saldo pendiente es 0, puede responder diciendo que actualmente no hay saldo pendiente.

Con bloques de código para Data connectors, te damos el poder de transformar y manipular directamente las respuestas de la API usando Python, justo dentro de la configuración de tu conector.

Este paso es opcional. Indica al Data connector dónde almacenar esta información en Intercom para que pueda ser entregada a los clientes en tus Workflows como respuestas a sus preguntas.

Escenarios comunes donde puede que no necesites almacenar datos son los tipos de solicitud de Data connector PUT, POST, DELETE. Para todas las solicitudes GET, si quieres usar los datos en bots, necesitarás almacenar estos datos en Intercom.

Al crear conectores de datos para Fin, no es necesario mapear los datos de respuesta a atributos u objetos de Intercom. En su lugar, Fin interpreta directamente la respuesta JSON y puede usarla para resolver preguntas. La respuesta se genera según la sección ‘Test response’. Cada línea corresponde a un punto de datos en la respuesta JSON.

Aprende sobre el manejo del almacenamiento, autorización y ejecución de Data connector.

Los datos de respuesta JSON pueden almacenarse en:

Selecciona el objeto de Intercom y luego mapea con el objeto API externo.

Ahora selecciona los atributos de datos en Intercom donde quieres almacenar esta información. Por ejemplo, seleccionamos "Order" como el objeto de Intercom y luego seleccionamos "root" como el objeto API en el sistema externo y lo mapeamos con el atributo API "currency":

Al mapear con Objetos personalizados, debes mapear el ID al campo external_id, de lo contrario se crearán duplicados con cada solicitud GET. Aprende más sobre cómo configurar referencias correctas con Objetos personalizados

El siguiente paso es seleccionar qué referencias de Personas o Conversación se relacionan con tu objeto personalizado que deseas actualizar.

Una vez que hayas probado tu Data connector con éxito, estás listo para ponerlo en vivo.

Para gestionar o editar tus Data connectors a gran escala de forma segura, puedes auditar proactivamente dónde se usa cada Data Connector o acción MCP en Intercom.

La columna Usado por puede estar oculta por defecto. Para mostrarla:

Esta columna proporciona una lista en vivo y clicable de referencias. Hacer clic en cualquier elemento te llevará directamente a esa fuente.

Rastrea el uso de Data connector en:

Una vez que tu Data connector esté en vivo, puedes monitorear su rendimiento directamente desde Configuración > Integraciones > Data connectors.

Una columna Salud muestra el estado operativo de cada conector basado en sus tasas recientes de éxito en ejecución y latencia.

Pasa el cursor sobre cualquier insignia de estado de salud para ver un desglose detallado de su rendimiento reciente:

Use el filtro de tiempo en la parte superior del panel para ajustar la ventana de reporte. Opciones disponibles: 1h, 6h, 24h, 7d o 14d.

Haga clic en cualquier conector para abrir su panel de salud dedicado, luego seleccione la pestaña Logs para ver un registro con marca de tiempo de cada ejecución. Cada entrada muestra el canal en que se ejecutó y si tuvo éxito o falló — haga clic en cualquier entrada para expandir los detalles completos de la ejecución.

Puede filtrar los registros por:

Si desea desaprobar Data connectors antiguos que ya no se requieren, puede moverlos al estado de borrador.

Vaya a Settings > Integrations > Data connectors y haga clic en el Data connector que desea mover a borrador, luego seleccione Set to draft.

Aunque Intercom bloqueará que ponga en borrador un conector con dependencias activas, ahora puede gestionarlas proactivamente usando la columna 'Used by'. Esta columna proporciona una lista en vivo e indexada de cada Workflow, Procedure, Task, Macro, and Custom Answer que referencia la acción. Puede hacer clic directamente en cualquier elemento de esta lista para ir a esa automatización específica y resolver la dependencia.