Utilice este artículo para leer e interpretar los registros del conector de datos, identificar la causa de los errores del conector y tomar las medidas adecuadas para resolverlos. Este artículo es para compañeros que han configurado al menos un conector de datos y necesitan diagnosticar por qué está fallando.
Cómo acceder a los registros del conector de datos
Los registros del conector de datos muestran un historial de cada solicitud que el conector ha realizado. Para abrir los registros de un conector, vaya a Settings > Integrations > Data Connectors, seleccione un conector y luego abra la pestaña Logs.
Cómo encontrar registros para una conversación específica
Para ver qué data connectors se ejecutaron durante una conversación específica (y si alguno falló), abra la conversación en el Inbox y active la vista de historial de eventos desde la línea de tiempo de la conversación. Las ejecuciones fallidas del conector de datos aparecen resaltadas en rojo.
Cómo leer los registros
El área de registros tiene tres componentes principales. Seleccione cualquier solicitud en la lista para abrir su panel de detalles:
Filtro: Puede filtrar los registros por diferentes valores y rangos de tiempo.
Lista de solicitudes: Cada entrada muestra la fecha y hora, qué activó el conector y si la solicitud tuvo éxito o falló.
Detalles de la solicitud: Muestra un desglose de cada etapa por la que pasó la solicitud y en qué etapa falló.
Filtrar
Use el selector de rango de fechas para filtrar los registros por un período de tiempo específico.
También puede filtrar por cualquiera de los siguientes valores:
ID de ejecución: Un identificador único para cada solicitud del conector. Nuestro equipo de soporte puede solicitarlo al diagnosticar problemas.
ID de conversación
Estado (Éxito/Fallo)
Tipo de fallo:
Error de configuración de la solicitud: El conector está configurado incorrectamente — por ejemplo, falta o es incorrecta la URL o un campo obligatorio — por lo que Fin ni siquiera pudo intentar la llamada.
Error de Faraday: Un error de conectividad a nivel de red — Fin no pudo alcanzar el servicio externo en absoluto. Esto suele ser causado por un tiempo de espera, fallo de DNS o que el servidor no sea accesible. Verifique si el servicio externo está en línea y que la URL del conector sea correcta.
Error de API de terceros (interfaz de programación de aplicaciones): Fin alcanzó el servicio externo con éxito, pero el servicio devolvió un error en respuesta — por ejemplo, la solicitud fue rechazada o el servicio estuvo temporalmente no disponible. Contacte al proveedor del servicio externo y comparta la respuesta de error para su investigación.
Error de mapeo de respuesta: El servicio externo respondió con éxito, pero Fin no pudo leer o extraer los datos de la respuesta de la manera esperada.
Error de actualización de token: El token OAuth (Open Authorization) usado para autenticar con el servicio externo expiró, y el intento de renovación automática falló. Use el botón Reauthenticate en la configuración del conector para restaurar el acceso.
Error de validación de la solicitud: Los datos que Fin estaba a punto de enviar fueron verificados y se encontró que eran inválidos o incompletos antes de que se hiciera la solicitud.
Error de transformación de bloque de código: Un fragmento de código personalizado que el conector usa para reformatear datos antes de enviarlos o después de recibirlos falló o produjo un resultado inesperado.
Ejecutado en:
Fin: El conector fue activado por Fin AI mientras manejaba una conversación con un cliente.
Procedure: El conector fue activado por un Procedure — una tarea estructurada o workflow que Fin sigue paso a paso.
Inbox: El conector fue activado manualmente por un compañero directamente desde una conversación en el inbox.
Inbox Automation Rule: El conector fue activado automáticamente por una regla configurada para ejecutar acciones cuando se cumplen ciertas condiciones en el inbox.
Custom Bot: El conector fue activado por un flujo de bot construido en el Workflows builder para automatizar conversaciones.
Resolution Bot: El conector fue activado por el antiguo Resolution Bot mientras intentaba responder automáticamente a la pregunta de un cliente.
Macros (Saved Reply): El conector fue activado cuando un compañero usó una respuesta guardada (macro) en una conversación.
Detalles de la solicitud
Seleccionar una solicitud de la lista abre su panel de detalles. Las siguientes cuatro secciones cubren cada etapa de la ejecución del conector de datos:
Ejecución
Solicitud
Respuesta
Procesamiento de la respuesta
Cada una de las cuatro secciones representa una fase distinta de la solicitud del conector de datos:
Ejecución cubre todo el ciclo de vida de la solicitud de principio a fin. Muestra qué activó el conector de datos — por ejemplo, Fin AI Agent, un Procedure o un compañero en el Inbox.
Solicitud es lo que Fin envía al sistema externo. Si hay un error aquí, la solicitud nunca se envió. Esto suele ser causado por un problema con la URL, la carga útil de la solicitud o la configuración del conector. Si la causa no está clara, contacte al soporte con los detalles del registro de ejecución.
Respuesta es lo que el sistema externo devuelve a Fin. Un código de estado 200 indica éxito. Los códigos de estado en el rango 5XX (como 500 o 502) indican un error del lado del servidor en el sistema externo — comparta la respuesta de error con el proveedor del servicio externo para su investigación. Los códigos de estado en el rango 4XX indican un error del lado del cliente: 404 significa que el recurso solicitado no se encontró, mientras que 401 y 403 indican problemas de autenticación o autorización. En general, los errores 4XX significan que la solicitud envió datos inválidos, incompletos o no autorizados.
Procesamiento de la respuesta es donde Fin aplica el mapeo de respuesta configurado en la configuración del conector de datos. Si este paso falla, generalmente significa que la respuesta de la API tiene una estructura diferente a la que el conector esperaba. Revise el mapeo de respuesta en la configuración del conector y contacte al soporte con los detalles del registro si el problema persiste.
¿Por qué mi conector de datos tiene éxito pero Fin dice que no puede encontrar nada?
Un conector de datos puede ejecutarse con éxito — devolviendo un código de estado 200 — pero aún así hacer que Fin AI Agent diga que no pudo encontrar nada. Esto suele ocurrir cuando la carga útil de la respuesta de la API es demasiado grande o no estructurada para que Fin extraiga los datos relevantes. Para resolver esto, optimice la respuesta de la API para devolver solo los campos específicos que Fin necesita, en lugar de enviar un objeto de datos completo. Si el problema persiste después de reducir el tamaño de la respuesta, contacte al soporte.
Consejo: Para problemas específicos de los data connectors que se ejecutan dentro de un Procedure, consulte Solución de problemas de Fin Procedures y Data connectors.