Talkdesk Automation Flows: Resolución de problemas

Automation Flows le permite crear procesos empresariales de varios pasos y varias integraciones. Cuando un flujo falla o se comporta de manera inesperada, el área de Governance le brinda visibilidad sobre lo que sucedió para que pueda diagnosticar y resolver problemas por su cuenta.

Este artículo explica cómo revisar las ejecuciones de flujos, leer los datos de una ejecución individual y resolver los problemas más comunes.

Acceso a Governance

Para revisar las ejecuciones de flujo, abra Automation Flows, haga clic en un flujo y revise la sección Executions 

Lista Flow Executions

La lista de ejecuciones de flujo muestra todas las ejecuciones de flujo de los últimos 20 días. 

En la lista de ejecuciones, puede ver: 

  • Fecha: La hora de inicio de la ejecución
  • Estado: El resultado de la ejecución (completada o fallida).
  • ID de ejecución: El identificador único de la ejecución.
  • Interaction ID: El identificador único de la interacción relacionada con esta ejecución, si existe.
  • Duración: Cuánto tiempo tarda esta ejecución en seguir su curso dentro del flujo.
  • Activación: ¿Qué activación inició la ejecución (por ejemplo, a través de una activación por tiempo o evento)?

También puede filtrar las ejecuciones en función de la fecha de la ejecución, el tipo de activación que inició la ejecución, el estado y la Interaction ID. Además, puede buscar ejecuciones por ID de ejecución.

 

Detalles de la ejecución

Seleccione una ejecución para abrir sus detalles. La vista de detalles está organizada en tres partes.

Dentro de cada detalle de la ejecución, puede ver información sobre el flujo, como la versión en la que tuvo lugar esta ejecución y las fechas de creación y última modificación. También puede ver algunos detalles genéricos de la ejecución, como el estado, el ID, la duración, la hora de inicio y la hora de finalización.

Desglose de la ejecución

El desglose muestra la ruta completa que tomó el flujo, lo que le permite inspeccionar cada paso. Dependiendo del componente, un paso puede mostrar:

  • Entrada: Los valores que recibió el paso, disponibles como JSON y como una coincidencia de clave compatible con la interfaz de usuario.
  • Salida: Los valores que produjo el paso, disponibles como JSON y como una coincidencia de clave compatible con la interfaz de usuario.
  • Tiempo de ejecución del paso y cualquier mensaje o detalle de error (por ejemplo, la respuesta de una petición HTTP).
  • El paso de salida seguido (por ejemplo, Éxito o Error).

¿Qué muestra cada componente?

Utilice esta tabla para saber qué esperar cuando abre un paso en el desglose.

Componente Entrada Resultado Salidas
Activador de eventos de Talkdesk Valores del campo Evento — Éxito · Error
APITrigger Solicitar valores de entrada (parámetros resueltos que se envían realmente) — Éxito · Error / Tiempo de espera
Activador basado en el tiempo (planificador) Configuración del programa Detalles de la ejecución programada Éxito · Error
Activador del Webhook Valores de la petición entrante — Éxito · Error
Execute Action Campos de entrada mapeados y la petición final enviada al sistema externo Los campos respuesta de acción y resultado, cuando estén disponibles Éxito · Error / Tiempo de espera
Get Context Campos de entrada mapeados en tiempo de ejecución Valores de contexto recuperados Éxito · Error / Tiempo de espera
Functions Campos de entrada mapeados en tiempo de ejecución Respuesta de Function y campos de resultado Éxito · Error / Tiempo de espera
Búsqueda en la tabla de referencia Tabla seleccionada y claves/valores de búsqueda Columnas de la fila coincidente expuestas como variables Éxito · Error
Actualización de la tabla de referencia Tabla seleccionada y valores de columna asignados Resultado de la inserción Éxito · Error
Split Flow Condiciones evaluadas y sus valores de entrada El resultado de cada condición y la ruta tomada Una salida por condición · Salida de contingencia
Wait Duración configurada o fecha/hora objetivo — Éxito
Agente de AI Campos de entrada mapeados en tiempo de ejecución Respuesta del agente y campos de salida Éxito · Error / Tiempo de espera
End Flow — — —

 

Problemas comunes y cómo resolverlos

La ejecución de un flujo muestra un estado de error

Abra la ejecución y utilice la función de análisis detallado para encontrar el paso que siguió a su salida de error. Revise el Resultadode ese paso y los detalles del mensaje/error para ver exactamente qué ha fallado, y luego aplique las indicaciones pertinentes que se indican a continuación.

La consulta de la tabla de referencia sigue la salida de error

Esto ocurre cuando el valor de la clave de consulta está en blanco o es nulo, o cuando ninguna fila coincide con los filtros configurados. También puede ocurrir si la tabla del Centro de referencia ya no está disponible o si no tiene acceso a ella.

  • Asegúrese de que la clave mapeada tenga un valor en tiempo de ejecución. Añada un Split Flow antes de la consulta para gestionar los valores vacíos.
  • Confirme que la tabla del Centro de referencia existe y es accesible para su cuenta.
  • Verifique los límites del Centro de referencia: 1000 filas, 100 columnas y 4 campos de tipo URL por tabla.

La actualización de la tabla de referencia sigue la salida de error

La causa más común es que la tabla ha alcanzado su límite de 1000 filas, o que la tabla ya no está disponible.

  • Utilice el indicador de uso de filas para comprobar la capacidad y elimine las filas no utilizadas o póngase en contacto con el servicio de asistencia si la tabla está llena.
  • Este componente inserta una sola fila por ejecución (solo Añadir). No se admiten las actualizaciones, las actualizaciones con inserción ni las eliminaciones.

La acción de ejecución falla o se agota el tiempo

  • Solo se admiten las acciones de Connections, y solo se muestran las acciones de las integraciones instaladas y activas.
  • Confirme que todas las entradas requeridas están mapeadas y revise la respuesta del sistema externo en el paso de Resultado.
  • Para fallos transitorios, configure la pestaña Retry & Timeout del paso. Consulte Flujos de automatización de Talkdesk: Configuración de Retry and Timeout.

No se inicia un flujo activado por API o la llamada a la API falla

  • El activador de la API es solo asíncrono. La respuesta de la API confirma si el flujo se ha activado, no el resultado del flujo.
  • Las peticiones están limitadas a 10 peticiones por segundo.
  • Asegúrese de que los ámbitos de OAuth requeridos estén incluidos en la configuración de su cliente.

Un activador de Webhook no se activa

  • El Webhook solo inicia el flujo cuando recibe una petición firmada correctamente.
  • Verifique la clave de firma y confirme que el sistema externo llama a la URL del Webhook del flujo.

Get Context no devuelve datos.

  • Solo está disponible el contexto de interacción, y únicamente cuando el flujo recibe el Interaction ID.
  • Debe estar disponible el contexto para Conversations & Automationsen la configuración de Studio.
  • Si se configura un campo duplicado, ese campo no se guarda. Compruebe si hay duplicados.

Un paso de espera no funciona como se espera.

  • Se puede pausar un flujo durante un máximo de 30 días. Para obtener demoras más largas, reestructure el flujo.

Un Split Flow siempre toma la salida de contingencia

  • Las condiciones se evalúan por orden de salida; el flujo toma la primera salida cuyas condiciones se cumplan, de lo contrario, la salida de contingencia.
  • Revise los operadores y los valores, y confirme que todas las salidas, incluida la de contingencia predeterminada, estén conectadas a un paso posterior.

Un paso de Functions sigue la salida de error

  • Compruebe si hay errores de tiempo de ejecución en JavaScript y confirme que se ha definido al menos un resultado (obligatorio).

Una variable no está disponible en un paso

  • Solo puede asignar variables de pasos anteriores. Los resultados de cada componente se exponen automáticamente como variables para los pasos siguientes.

 

Artículos relacionados

Volver ""
Por favor, inicie sesión para enviar una solicitud.