Ir al contenido principal

Usar plantillas de conectores de datos

Plantillas de conectores de datos disponibles para Fin AI Agent usando aplicaciones de terceros.

Escrito por Beth-Ann Sher

Las plantillas de conectores de datos te permiten instalar un conector de datos preconstruido y listo para usar desde un catálogo de plantillas agrupadas por aplicación. Las plantillas se configuran automáticamente para ti usando tus integraciones instaladas, por lo que están listas para probar y activar al instante; y a medida que Intercom las mejora con el tiempo, se te notifica y puedes revisar cualquier cambio antes de aplicarlo.

Para usar estas plantillas, ve a Configuración > Integraciones > Conectores de datos, haz clic en Nuevo y elige Comenzar desde una plantilla. Verás plantillas agrupadas por aplicación; selecciona la plantilla que deseas instalar.


Cómo funcionan las plantillas

Instalación desde el catálogo

El catálogo de plantillas muestra todas las plantillas preconstruidas disponibles agrupadas por aplicación (por ejemplo, Stripe, Shopify y Statuspage). La navegación e instalación están integradas en el nuevo flujo de conectores: selecciona Comenzar desde una plantilla al crear un conector, elige tu aplicación y selecciona la plantilla que deseas.

Instalar una plantilla crea una copia independiente en tu espacio de trabajo. Puedes personalizarla libremente sin afectar la plantilla original ni otros espacios de trabajo.

Actualizaciones seguras con revisión opcional

Cuando Intercom publica una versión mejorada de una plantilla que ya has instalado, tu conector no se cambia automáticamente. En su lugar, se te notifica que hay una versión más reciente disponible. Puedes revisar exactamente qué cambió antes de decidir si aplicas la actualización, y cualquier personalización que hayas hecho en tu conector se conserva.

Cada conector instalado registra de qué versión de plantilla proviene, por lo que siempre está claro si tu conector está actualizado o si hay una versión más reciente disponible.


Plantillas de conectores de datos para Shopify Storefront

Cuando configuras estos conectores de datos, Fin puede resolver completamente las solicitudes de los clientes que quieren obtener información de tu Shopify Storefront. Esto usa tu integración existente de Shopify, por lo que no necesitas hacer conexiones adicionales con otra herramienta.

Simplemente activa estos conectores de datos usando las condiciones preestablecidas, o establece tus propias condiciones para indicarle a Fin qué requisitos deben cumplirse antes de obtener información de Shopify.

Nota:

  • Debes instalar la aplicación Shopify en tu espacio de trabajo para usar estas plantillas de conectores de datos para Shopify.

  • Los conectores de datos no admiten parámetros de objetos anidados o matrices, lo que impide búsquedas dinámicas de productos usando la herramienta Shopify search_catalog a través de conectores MCP. Para habilitar la búsqueda y recomendaciones de productos, sincroniza los datos de tu catálogo Shopify en la knowledge base de Fin y usa la integración nativa de Shopify en su lugar.

Casos de uso comunes

Usa estos conectores de datos para:

Buscar en el catálogo

Úsalo para buscar en el catálogo de la tienda con las propias palabras del cliente. Devuelve los productos que coinciden con su rango de precios, disponibilidad, imagen y enlace a la tienda.

Obtener carrito

Úsalo para leer el contenido del carrito de Shopify de un cliente. Devuelve cada línea del carrito con su cantidad, el producto y variante a los que se refiere, totales por línea y del carrito, y el enlace para pagar.

Actualizar carrito

Úsalo para cambiar la cantidad de un artículo que ya está en el carrito de Shopify del cliente. Devuelve el carrito actualizado con cada línea, los nuevos totales y el enlace para pagar. Ejemplos de consultas de clientes incluyen:

  • ¿Puedes cambiar mi pedido a 3 de esos?

  • Solo quiero una de las camisas azules, no dos

  • Quita las sandalias de mi carrito

  • Actualiza la cantidad en mi carrito

Esta acción requiere el cart_id, el line_id del artículo a cambiar y la nueva cantidad. El line_id es el ID de línea del carrito devuelto por la acción Obtener carrito de Shopify, no el ID del producto o variante, así que primero lee el carrito para resolver a qué línea se refiere el cliente. Establecer la cantidad en 0 elimina la línea por completo, por lo que esta acción cubre tanto cambiar una cantidad como eliminar un artículo. Reemplaza esas partes de la herramienta update_cart obsoleta en el endpoint MCP de Shopify Storefront; agregar un nuevo artículo es una mutación separada de Storefront.

Obtener detalles del producto

Úsalo para buscar un producto en el catálogo de la tienda: su descripción, rango de precios, disponibilidad, imagen y cada variante comprable con su propio precio, SKU, opciones y stock. Úsalo cuando el cliente pregunte sobre un producto en lugar de su carrito o un pedido.


Plantillas de conectores de datos para Shopify

Obtener información del pedido

Úsalo para obtener detalles sobre los pedidos del cliente y ayudar a resolver cualquier problema relacionado con pedidos. Esta acción proporcionará todos los detalles del pedido para el cliente, como estado del pedido, artículos comprados, dirección de envío, información de seguimiento u otros detalles relevantes del pedido.


Plantillas de conectores de datos para Statuspage

Cuando configuras este conector de datos, Fin puede resolver completamente las solicitudes de clientes que reportan o preguntan sobre un incidente que has registrado en Statuspage. Esto usa tu integración existente de Statuspage, por lo que no necesitas hacer conexiones adicionales con otra herramienta.

Simplemente activa el conector de datos usando las condiciones preestablecidas, o establece tus propias condiciones para indicarle a Fin qué requisitos deben cumplirse antes de obtener información de Statuspage.

Incidentes no resueltos

Úsalo cuando un cliente esté experimentando un problema para verificar si hay interrupciones del sistema, fallos de servicio o incidentes no resueltos que puedan explicar la interrupción que enfrenta el cliente. Esta acción proporcionará todos los incidentes activos, su estado y la última actualización.

Nota: Debes instalar la aplicación Statuspage en tu espacio de trabajo para usar esta plantilla de conector de datos.


Plantillas de conectores de datos para Stripe

Cuando configuras estos conectores de datos, Fin puede resolver completamente las solicitudes de clientes que necesitan información almacenada en Stripe. Esto usa tu integración existente de Stripe, por lo que no necesitas hacer conexiones adicionales con otra herramienta.

Simplemente activa estos conectores de datos usando las condiciones preestablecidas, o establece tus propias condiciones para indicarle a Fin qué requisitos deben cumplirse antes de obtener información de Stripe.

Nota: Debes instalar la aplicación Stripe en tu espacio de trabajo para usar estas plantillas de conectores de datos.

Casos de uso comunes

Usa estos conectores de datos para:

Obtener cliente de Stripe por ID

Recupera un solo cliente de Stripe por su id de cliente de Stripe (cus_...). Muestra los detalles almacenados del cliente: id, correo electrónico, nombre, saldo, moneda, morosidad y fecha de creación. Solo lectura.

Listar clientes de Stripe

Devuelve una lista de tus clientes de Stripe, opcionalmente filtrada por coincidencia exacta de correo electrónico. Muestra los detalles almacenados de cada cliente: id, correo electrónico, nombre, saldo, moneda, morosidad y fecha de creación. Solo lectura.

Listar facturas de Stripe para un cliente

Lista las facturas de un cliente de Stripe (las más recientes primero, hasta 10): id de factura, estado, monto adeudado, monto pagado, moneda, período de facturación y URL de factura alojada. Pasa el id de Stripe del cliente (cus_...). Solo lectura.

Buscar cargos de Stripe para un cliente

Busca los cargos de un cliente de Stripe (hasta 10): id de cargo (ch_...), monto, moneda, estado, indicadores de pagado y reembolsado, descripción y fecha de creación. Pasa el id de Stripe del cliente (cus_...). Se usa comúnmente para encontrar el charge_id necesario antes de emitir un reembolso. Solo lectura.

Buscar clientes de Stripe por correo electrónico

Busca tus clientes de Stripe por dirección de correo electrónico exacta y devuelve los clientes que coinciden: id, correo electrónico, nombre, saldo, moneda, morosidad y fecha de creación. Este es el punto de partida más común para una búsqueda en Stripe cuando solo tienes el correo electrónico del cliente. Solo lectura. Fin usa este conector para mostrar los registros de Stripe de alguien por correo electrónico. Si el campo de correo electrónico no está protegido contra actualizaciones no verificadas, un cliente podría cambiarlo en el Messenger y mostrar los registros de otra persona. Revisa la pestaña de seguridad en el borrador de tu conector de datos y asegúrate de que el correo electrónico sea un campo protegido.

Obtener información de suscripción

Úsalo para obtener detalles sobre las suscripciones del cliente y ayudar a resolver cualquier problema relacionado con suscripciones. Esta acción proporcionará toda la información de suscripción para el cliente, como estado de suscripción, frecuencia de facturación, próxima fecha de facturación o detalles del plan.

Ejemplos de consultas de clientes incluyen:

  • ¿Cuál es el estado de mi suscripción?

  • ¿Cuándo me cobrarán la próxima vez?

  • ¿Puedes decirme a qué plan estoy suscrito?

  • ¿Con qué frecuencia me facturan la suscripción?

  • ¿Cuándo se renueva mi suscripción?

Limitaciones y configuraciones personalizadas de Stripe

Nota: La automatización nativa de correo electrónico de Stripe puede enviar facturas y recibos automáticamente, pero este es un comportamiento del lado de Stripe, no controlado a través de Fin o esta integración. Si quieres que Fin envíe facturas o recibos bajo demanda, eso requiere un conector de datos personalizado con capacidad de escritura/acción; las plantillas estándar de Stripe arriba cubren solo consultas de suscripción y pago de solo lectura.

Nota: Si configuras un conector de cancelación, restrínjalo a solicitudes de cancelación voluntarias y sencillas. Usa un Procedimiento de Fin para verificaciones de elegibilidad, confirmaciones o cualquier lógica ramificada, y define criterios de transferencia en la Guía de Escalación de Fin. Para el tiempo, ten en cuenta que los conectores de datos estándar tienen un tiempo de espera de 15 segundos; los conectores usados dentro de Procedimientos en espacios de trabajo elegibles tienen un tiempo de espera de 30 segundos.

¿Ha quedado contestada tu pregunta?