Los Data connectors 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 buena forma de empezar es pensar en las preguntas comunes que tus compañeros dedican mucho tiempo a responder, usando información que actualmente no está disponible en Intercom.
Pueden ser preguntas en las que 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 sepas qué preguntas quieres resolver, es sorprendentemente sencillo y rápido configurar un Data connector con poca o ninguna experiencia técnica.
Crear un Data connector
Primero, navega a Settings > Integrations > Data connectors.
Aquí es donde configurarás todas las conexiones diferentes que tengas con datos externos (p. ej., Shopify, Salesforce, etc.) según tu caso de uso. Haz clic en + New.
Tip: También es posible usar Data connectors for Fin.
Nombre y descripción
Asigna a tu Data connector un nombre único que explique exactamente qué Data connector será (p. ej., “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 que recupere (p. ej., “Obtener pedido para un ID dado. El ID del pedido debe almacenarse en Conversation CDA”).
Para permitir que Fin use este conector directamente, navega a la pestaña Fin y establece How should Fin use this connector? en Enabled (direct trigger). Si solo quieres que se use dentro de un Workflow, Task, Procedure o Macro, configúralo en Disabled (manual trigger).
Conexión API
A continuación, rellena los detalles de la solicitud. Aquí deberás ingresar la URL HTTPS al sistema de terceros al que te conectas (p. ej., Shopify, Salesforce, etc.).
Solicitud API
Puedes especificar qué Data connector quieres que realice esta solicitud seleccionando el método:
GET - Leer y almacenar información del sistema de terceros.
POST - Crear o añadir información al sistema de terceros.
PUT - Actualizar información en el sistema de terceros.
DELETE - Eliminar información del sistema de terceros.
PATCH - Actualizar información en el sistema de terceros.
En este ejemplo, pediremos a la solicitud que HAGA UN GET del ID de pedido desde la API e introduciremos la URL.
Para hacer una solicitud, la URL debe ser una dirección HTTPS.
Tips:
Puedes insertar atributos de User, Conversation, Company y eventos como valores plantillados en la URL y en el cuerpo de la solicitud de los métodos POST y PUT. Use custom data attributes que ya hayas configurado en tu espacio de trabajo. O, para una mayor flexibilidad de datos, prueba a usar custom objects.
Los Data connectors convierten automáticamente las respuestas XML a JSON. Si tu API devuelve XML, simplemente introduce el endpoint como de costumbre: Intercom se encargará de la conversión y mostrará el JSON resultante en el paso Test response. Luego podrás mapear y usar los datos como lo harías con una API JSON nativa.
Encabezados HTTP
Puedes optar por añadir parámetros adicionales a esta solicitud haciendo clic en Add key value pair y luego seleccionando Key value pair bajo HTTP Headers:
Autenticación
Los Data connectors admiten tokens fijos y dinámicos para autenticación. Bajo los HTTP Headers, puedes seleccionar el authentication token que quieras usar en la solicitud, que luego se añadirá al encabezado.
Nota: Puedes adjuntar varios tokens a un solo Data connector. Asegúrate de configurar cada token con una clave de encabezado diferente. Todos los tokens adjuntos se enviarán con la solicitud.
Cuerpo de la solicitud
Si estás realizando 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:
Asegúrate de incluir los encabezados HTTP apropiados que requiera la API a la que estás haciendo la solicitud (por ejemplo, accept: application/json y Content-Type: application/json). Si envías un cuerpo JSON, Content-Type: application/json debe añadirse explícitamente; sin él, la API no analizará el cuerpo de la solicitud y rechazará todos los campos como inválidos, incluso si el JSON está correctamente formateado.
Probar respuesta
A continuación, deberá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.
Important: Probar esta solicitud establece una conexión con la API, por lo que completará el Data connector que has creado. Por ejemplo, si le has pedido que elimine datos de la API, esta información se eliminará. Intenta probar con una solicitud GET para asegurarte de que solo estás leyendo información y no cambiándola.
Haz clic en Test request para comprobar que el Data connector se ha configurado correctamente. Deberías obtener una marca verde y ver los detalles de esa solicitud si la conexión se valida con la API.
Toda esta información ahora puede usarse para potenciar tus Workflows y proporcionar a los clientes respuestas rápidas, como el estado de un pedido.
Tip: Los Data connectors convierten automáticamente las respuestas XML a JSON. Si tu API devuelve XML, simplemente introduce el endpoint como de costumbre: Intercom se encargará de la conversión y mostrará el JSON resultante en el paso Test response. Luego podrás mapear y usar los datos como lo harías con una API JSON nativa.
Transformación de datos
Por defecto, Fin puede acceder a los datos completos de la respuesta para generar respuestas. Selecciona Manually restrict access 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 icono de edit para darle a tus datos de respuesta un nombre para el cliente y 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 indique que el saldo pendiente es 0, puede responder indicando que actualmente no hay saldo pendiente.
Usa código para filtrar o transformar la respuesta
Con los bloques de código para Data connectors, te permitimos transformar y manipular directamente las respuestas de la API usando Python, dentro de la configuración de tu conector.
Asignación de objetos
Este paso es opcional. Indica al Data connector dónde almacenar esta información en Intercom para que pueda proporcionarse a los clientes en tus Workflows como respuestas a sus preguntas.
Los escenarios comunes en los que puede que no necesites almacenar datos son los tipos de solicitud de Data connector PUT, POST, DELETE. Para todas las solicitudes GET, si deseas 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 consultas. La respuesta se genera en función de la sección «Test response». Cada elemento de línea corresponde a un punto de datos en la respuesta JSON.
Los datos de la respuesta JSON pueden almacenarse en:
Objetos estándar: atributos de Usuario y Conversación.
Custom Objects: atributos de objeto que has creado en Intercom.
Selecciona el objeto de Intercom y luego mapealo con el objeto API externo.
Todos los custom attributes y custom objects deben crearse antes de poder usarlos para el almacenamiento de respuestas aquí.
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»:
Los datos externos solo pueden almacenarse en atributos de datos personalizados y no en los atributos de datos estándar de Intercom.
Mapeando datos de respuesta a Custom Objects
Al mapear con Custom Objects, debes mapear el ID al campo external_id; de lo contrario, se crearán duplicados con cada solicitud GET. Más información sobre cómo configurar las referencias correctas con Custom Objects
Actualizando referencias desde Personas o Conversaciones
El siguiente paso es seleccionar qué referencias de Personas o Conversación se relacionan con el objeto personalizado que deseas actualizar.
Poner en vivo
Una vez que hayas probado correctamente tu Data connector, estás listo para ponerlo en vivo.
Nota: Los Data connectors usan un sistema de versiones borrador/en vivo. Cualquier cambio que realices —incluida la configuración del trigger de Fin bajo la pestaña Fin— se guarda como borrador y no afectará al conector en vivo hasta que hagas clic en Set live. Si el conector parece comportarse de forma inesperada tras un cambio, verifica si la versión actualizada se ha puesto en vivo. La lista de conectores en Settings muestra el estado actual de cada conector (live o draft).
El límite de tiempo de espera para los Data connectors es de 15 segundos y no es configurable por el cliente. Para los Data connectors utilizados dentro de Fin Procedures en espacios de trabajo elegibles, el tiempo de espera se amplía a 30 segundos.
Consejo: Si quieres mayor visibilidad en tiempo real sobre las tasas de éxito y fallo de tus Data Connectors, puedes usar el Data Connector Execution Webhook. Esto puede ser útil para recibir eventos de ejecución y crear paneles en tiempo real, alertas y monitorización de SLA en tus servicios externos.
Ver dependencias del Data connector
Para gestionar o editar de forma segura tus Data connectors a escala, puedes auditar proactivamente dónde se usa cada Data Connector o acción MCP en Intercom.
Cómo activar la vista «Used by»:
La columna Used by puede estar oculta por defecto. Para mostrarla:
Haz clic en el menú (tres líneas horizontales) en la parte superior derecha de la tabla.
Marca la casilla junto a Used by.
Esta columna proporciona una lista activa y clicable de referencias. Hacer clic en cualquier elemento te llevará directamente a esa fuente.
Realiza un seguimiento del uso del Data connector en:
Workflows
Procedures & Tasks
Custom Answers
Macros
Monitorización del estado de salud del Data connector
Una vez que tu Data connector esté en vivo, puedes supervisar su rendimiento directamente desde Settings > Integrations > Data connectors.
Indicadores de estado de salud
Una columna Health muestra el estado operativo de cada conector basándose en sus tasas de éxito recientes y latencia.
Status | Criteria | Implication |
Healthy | Tasa de éxito > 95% y latencia normal.
| Funcionando de manera óptima.
|
Degraded | Tasa de éxito entre 80-95% O la latencia es 2x la línea base histórica.
| Experimentando problemas pero aún parcialmente funcional.
|
Unhealthy | La tasa de éxito es del 80% o menos.
| Problemas críticos que requieren atención inmediata. |
Pasa el cursor sobre cualquier insignia de estado de salud para ver un desglose detallado de su rendimiento reciente:
Field Name | Descripción |
Tasa de éxito | Porcentaje de ejecuciones exitosas sobre el total analizado. |
Latencia externa | Tiempo de respuesta del API/servicio externo (p90, p50, avg, min, max en ms).
Nota: Solo se incluyen ejecuciones exitosas.
|
Latencia interna | Sobrecarga de procesamiento interno (tiempo transcurrido en el sistema de Intercom para ejecutar el conector de datos) (p90, p50, avg, min, max en ms). |
Latencia de Intercom | Tiempo total de ejecución, calculado como Latencia externa + Latencia interna (p90, p50, avg, min, max en ms). |
Distribución de estados HTTP | Distribución de códigos de estado HTTP devueltos por el servicio externo (p. ej., 200, 500, timeout) con recuento y porcentaje. Devuelve null si no existen ejecuciones. |
Distribución de tipos de fallo | Desglose de los tipos de fallo (p. ej., "Connection Timeout", "Authentication Failed"), ordenado por frecuencia, con recuento y porcentaje. Devuelve null si no ocurrieron fallos. |
Recuento de ejecuciones | Número real de ejecuciones analizadas en el periodo actual. |
Filtros de tiempo
Use el filtro de tiempo en la parte superior del panel para ajustar la ventana de informe. Opciones disponibles: 1h, 6h, 24h, 7d o 14d.
Registros
Haga clic en cualquier conector para abrir su panel de estado dedicado, luego seleccione la pestaña Logs para ver un registro con marcas de tiempo de cada ejecución. Cada entrada muestra el canal en el que se ejecutó y si tuvo éxito o falló: haga clic en cualquier entrada para ampliar los detalles completos de la ejecución.
Puede filtrar los registros por:
ID de ejecución
Conversación
Estado (éxito o fallo)
Tipo de fallo
Nota: Los registros se retienen hasta 14 días. Para solicitar una ventana más corta de 7 días, contacte a nuestro equipo de Soporte. Para acceso programático a los datos de ejecución más allá del panel, consulte API access to execution results.
Mover un conector de datos a borrador
Si desea desaprobar conectores de datos antiguos que ya no se requieren, puede moverlos a estado de borrador.
Vaya a Settings > Integrations > Data connectors y haga clic en el conector de datos que desea mover a borrador y seleccione Set to draft.
Aunque Intercom le bloqueará mover a borrador un conector con dependencias activas, ahora puede gestionarlas de forma proactiva usando la columna 'Used by'. Esta columna ofrece una lista indexada en vivo de cada Workflow, Procedure, Task, Macro, and Custom Answer que hace referencia a 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.
Nota: Un Procedure en estado pausado aún cuenta como dependencia activa. Mover un conector a borrador será bloqueado incluso si todos los Procedure que lo referencian están pausados en lugar de activos. Resuelva todas las referencias al conector, incluidas las de Procedure pausados, antes de intentar establecer el conector en borrador.