Usa este artículo para configurar las plantillas de conector de datos de Pendo, para que Fin pueda ver qué estaba haciendo un cliente en tu producto antes de pedir ayuda. También cubre lo que ven los clientes, las limitaciones y cómo solucionar problemas comunes de configuración. Este artículo es para compañeros que configuran conectores de datos para Fin. También necesitarás acceso al Agent Toolkit de Pendo.
¿Qué son las plantillas de conector de datos de Pendo?
Las plantillas de conector de datos de Pendo son 5 conectores de datos listos que conectan Fin con el Agent Toolkit de Pendo. Pendo registra cómo los clientes usan tu producto, incluyendo las páginas que visitan, las funciones que usan y dónde encuentran errores o dificultades. Con las plantillas de conector de datos de Pendo, Fin puede usar ese contexto para personalizar sus respuestas y saltarse pasos que el cliente ya intentó.
¿Por qué usar las plantillas de conector de datos de Pendo?
Las plantillas de conector de datos de Pendo ayudan a Fin a responder preguntas sobre el producto sin pedir al cliente que explique lo que hizo:
Comienza con contexto: Fin ve la actividad reciente de la sesión del cliente, así que el cliente no necesita describir lo que estaba haciendo.
Apunta a la guía correcta: Fin encuentra la guía en la aplicación de Pendo que coincide con una pregunta de cómo hacer algo y comparte un enlace que la lanza.
Captura comentarios del producto: Fin puede enviar comentarios a Pendo en nombre del cliente.
Evita la construcción manual: Los campos de solicitud, entradas y respuesta ya están configurados, así que no tienes que crearlos a mano.
¿Qué plantillas de conector de datos de Pendo están disponibles?
Esta tabla lista las 5 plantillas de conector de datos de Pendo en el grupo de plantillas "Pendo Agent Toolkit API" y lo que Fin obtiene de cada una.
Plantilla | Lo que Fin obtiene |
Obtener actividad de sesión de Pendo para un visitante | Un resumen y línea de tiempo de lo que el visitante estaba haciendo recientemente, incluyendo páginas, elementos, configuraciones, errores y dificultades como clics muertos. Fin pasa una breve descripción de la pregunta del cliente, para que el resumen se enfoque en lo importante. |
Encontrar una guía en la aplicación de Pendo | La guía de Pendo que mejor coincide con una pregunta de cómo hacer algo, con un enlace que lanza la guía en tu aplicación. Fin comparte el enlace con el cliente. |
Obtener actividad de agentes AI de Pendo para un visitante | Las 3 conversaciones más recientes del visitante con tus agentes AI en el producto de los últimos 30 días, y los 3 problemas más recientes detectados, como errores y alucinaciones. Requiere Pendo Agent Analytics. |
Listar áreas de producto de Pendo | Cada área de producto en tu suscripción de Pendo, con su ID y descripción. Fin usa esto antes de enviar comentarios. |
Enviar comentarios a Pendo para un visitante | Crea un ítem de comentarios en Pendo Feedback para el visitante, con título, descripción, área de producto opcional y un enlace a la conversación de Intercom. Requiere Pendo Feedback. |
Ejemplos de consultas de clientes que las plantillas de conector de datos de Pendo ayudan a Fin a responder incluyen:
Sigo recibiendo un error cuando intento guardar mis configuraciones.
¿Cómo creo un nuevo panel?
Tu asistente en la aplicación me dio la respuesta incorrecta.
¿Puedes pasar una solicitud de función a tu equipo de producto?
Consejo: Combina las plantillas de conector de datos de Pendo con Procedimientos Proactivos para iniciar una conversación con Fin cuando Pendo detecte signos de frustración. Aprende cómo activar un procedimiento proactivo desde una API externa.
¿Qué necesitas antes de configurar las plantillas de conector de datos de Pendo?
Antes de configurar las plantillas de conector de datos de Pendo, asegúrate de tener:
Acceso al Agent Toolkit de Pendo: Permiso en Pendo para crear un agente y una cuenta de servicio.
Autenticación del cliente: Código de un solo uso (OTP) por correo electrónico o seguridad Messenger con JSON Web Tokens (JWT) configurados en Intercom. Los conectores de datos no pueden activarse sin esto. Aprende más sobre configurar la autenticación de conectores de datos.
Coincidencia de IDs de visitante: El ID de visitante de Pendo de cada cliente disponible en Intercom, ya sea como su ID de usuario de Intercom o en el atributo pendoVisitorId.
Complementos de Pendo para 2 plantillas: Pendo Agent Analytics para actividad de agentes AI, y Pendo Feedback para enviar comentarios.
Nota: Las plantillas de conector de datos de Pendo solo soportan aplicaciones web y solo cubren clientes con sesión iniciada que tengan un ID de visitante de Pendo. Las aplicaciones móviles y extensiones de navegador aún no están soportadas.
Cómo configurar las plantillas de conector de datos de Pendo
Cada plantilla de conector de datos de Pendo crea su propio conector de datos. Crea la cuenta de servicio de Pendo una vez, luego repite los pasos en Intercom para cada plantilla que quieras que Fin use.
Cómo crear una cuenta de servicio de Pendo para Fin
Para crear la cuenta de servicio de Pendo que usan las plantillas de conector de datos de Pendo:
En Pendo, crea un agente Intercom Fin en el Agent Toolkit.
Crea una cuenta de servicio para el agente.
Copia la URL del token, el ID del cliente, el secreto del cliente y el alcance. Los pegarás en Intercom cuando agregues tu token de autenticación de Pendo.
Cómo crear un conector de datos de Pendo desde una plantilla
Para crear un conector de datos de Pendo desde una plantilla en Intercom:
Ve a Configuración > Integraciones > Conectores de datos y haz clic en Nuevo.
En O empezar desde una plantilla, elige Pendo Agent Toolkit API.
Elige una plantilla, lee lo que hace y luego haz clic en Crear.
Un borrador del conector de datos Pendo se abre con los campos de solicitud, entradas y respuesta ya completados.
Cómo agregar tu token de autenticación Pendo
Para agregar tu token de autenticación Pendo a un conector de datos Pendo:
En Authentication tokens, haz clic en New token y elige el tipo OAuth (Open Authorization).
Pega la URL del token, el ID de cliente, el secreto de cliente y el alcance que copiaste de Pendo.
Selecciona el token en el conector de datos.
Consejo: Cuando configures tu próxima plantilla de conector de datos Pendo, selecciona el mismo token de autenticación Pendo en lugar de crear uno nuevo.
Cómo configurar las entradas de datos de Pendo
Para configurar las entradas de datos para un conector de datos Pendo:
En Data inputs, marca pendo_host. El valor predeterminado es
app.pendo.io. Si tu suscripción Pendo está alojada en la región EU, AU, Japón o us1, cambia su Custom value al host Pendo de tu región.Asocia la entrada Visitor ID con el atributo de Intercom que contiene el ID de visitante Pendo del cliente. Si tu ID de usuario de Intercom y el ID de visitante Pendo coinciden, usa User ID. Si no coinciden, sincroniza los IDs y usa el atributo pendoVisitorId.
Si la plantilla solicita configuraciones de equipo, como tu ID de app Pendo, ID de agente o el hostname del enlace de guía, introdúcelos como Custom values.
Nota: Fin nunca completa las configuraciones de equipo para las plantillas de conector de datos Pendo, como tu ID de app Pendo, ID de agente o el hostname del enlace de guía. Solo los compañeros de equipo establecen estos valores.
Cómo probar un conector de datos Pendo y ponerlo en vivo
Para probar un conector de datos Pendo y permitir que Fin lo use:
Prueba el conector de datos con el ID de visitante de un cliente de prueba que tenga actividad reciente en Pendo.
En la pestaña Fin, bajo How should Fin use this connector?, elige Enabled (direct trigger).
Haz clic en Set live.
Una vez que el conector de datos Pendo está en vivo, Fin lo activa automáticamente cuando la pregunta de un cliente coincide con lo que hace la plantilla.
Nota: Solo puedes probar completamente las plantillas de conector de datos Pendo en un espacio de trabajo de producción, no en uno de prueba.
Nota: Cada llamada exitosa a Submit Pendo feedback for a visitor crea un nuevo ítem de feedback en Pendo, así que usa un cliente de prueba cuando pruebes esta plantilla.
¿Qué ven los clientes cuando Fin usa las plantillas de conector de datos Pendo?
Los clientes no ven Pendo cuando Fin usa las plantillas de conector de datos Pendo, porque Fin usa el contexto de Pendo en segundo plano. La única diferencia visible es el enlace de la guía: cuando Fin encuentra una guía Pendo coincidente, responde con un enlace que lanza el recorrido en tu app.
Las conversaciones donde Fin usa datos de Pendo aparecen en el Inbox como cualquier otra conversación de Fin.
Cómo reportar sobre las plantillas de conector de datos Pendo
Las plantillas de conector de datos Pendo no tienen un informe dedicado. Son conectores de datos estándar, por lo que su uso aparece en tus informes existentes de conectores de datos y Fin.
¿Cuáles son las limitaciones de las plantillas de conector de datos Pendo?
Las plantillas de conector de datos Pendo tienen estas limitaciones, con soluciones cuando existen:
Solo apps web: Las apps móviles y extensiones de navegador aún no son compatibles, y no hay solución.
Solo clientes con sesión iniciada: Fin solo puede buscar clientes que hayan iniciado sesión y tengan un ID de visitante Pendo.
Coincidencia de Visitor ID: Si el ID de visitante en Intercom no coincide con Pendo, Fin no puede encontrar al cliente. Sincroniza los IDs y asigna la entrada Visitor ID al atributo pendoVisitorId.
Solo actividad etiquetada: Los resúmenes de sesión solo incluyen páginas y funciones etiquetadas en Pendo. Etiqueta más páginas y funciones en Pendo para incluirlas.
Se requiere autenticación del cliente: Las plantillas no pueden activarse hasta que se configure el OTP por email o la seguridad de Messenger.
Solo pruebas en producción: Solo puedes probar completamente las plantillas en un espacio de trabajo de producción, no en uno de prueba.
Complementos Pendo: La actividad del agente AI necesita Pendo Agent Analytics, y enviar feedback necesita Pendo Feedback. Sin ellos, esas 2 plantillas no devuelven datos útiles.
Nuevo ítem de feedback por llamada: Cada llamada exitosa a Submit Pendo feedback for a visitor crea un nuevo ítem de feedback en Pendo.
No hay contacto proactivo: Las plantillas no inician conversaciones. Para que Fin contacte cuando Pendo detecta frustración, configura señales de frustración en Pendo y combínalas con Procedimientos Proactivos, que requieren Proactive Support Plus o Full Suite.
Preguntas frecuentes sobre las plantillas de conector de datos Pendo
¿Por qué Fin no puede encontrar a mi cliente en Pendo?
Fin no puede encontrar a un cliente en Pendo cuando el ID de visitante en Intercom no coincide con Pendo, o cuando el cliente no tiene actividad etiquetada. Verifica que la entrada Visitor ID esté asignada al atributo correcto. Si tus IDs de usuario de Intercom y los IDs de visitante Pendo difieren, sincroniza los IDs y usa el atributo pendoVisitorId.
¿Por qué Fin encuentra a algunos clientes en Pendo pero no a otros?
Fin encuentra solo a algunos clientes en Pendo cuando tus IDs de usuario de Intercom y los IDs de visitante Pendo difieren para el resto. Sincroniza los IDs y verifica que el atributo pendoVisitorId esté poblado para esos clientes.
¿Por qué mi conector de datos Pendo muestra un error de autenticación?
Un conector de datos Pendo muestra un error de autenticación cuando los valores OAuth son incorrectos o han expirado, o cuando la cuenta de servicio fue creada para una región Pendo diferente. Recrea la cuenta de servicio en Pendo y luego crea un nuevo token OAuth en Intercom con los nuevos valores.
¿Por qué mi conector de datos Pendo no devuelve datos?
Un conector de datos Pendo no devuelve datos cuando pendo_host no coincide con tu región Pendo. Si aún está configurado en app.pendo.io y tu suscripción Pendo está alojada en EU, AU o Japón, cámbialo al host Pendo de tu región.
¿Por qué Fin no está usando mi conector de datos Pendo?
Fin no usa un conector de datos Pendo a menos que esté en vivo y configurado en Enabled (direct trigger) en la pestaña Fin. Abre el conector de datos, verifica ambas configuraciones y haz clic en Set live si es necesario.
¿Por qué la plantilla de actividad del agente AI de Pendo no devuelve nada?
La plantilla Get Pendo AI agent activity for a visitor no devuelve nada útil cuando tu suscripción Pendo no incluye Pendo Agent Analytics. Añade Agent Analytics en Pendo para usar esta plantilla.
¿Por qué hay elementos de retroalimentación duplicados en Pendo?
Los elementos de retroalimentación duplicados aparecen en Pendo porque cada llamada exitosa para Enviar retroalimentación de Pendo para un visitante crea un nuevo elemento. Verifique la conversación para intentos repetidos.
¿Pueden Operator y Copilot usar datos de Pendo?
Operator y Copilot pueden usar datos de Pendo a través del Model Context Protocol (MCP), sin las plantillas del conector de datos de Pendo. Aprende cómo conectar Pendo a Operator con Connections. Connections están incluidos con Operator en el complemento Pro. El acceso a Pendo en Copilot está en beta cerrada.