Acciones de flujo de trabajo
Las acciones son los pasos que ejecuta un flujo de trabajo cuando se activa un disparador. Puede encadenar tantas acciones como desee, enrutarlas por ramificaciones, iterar sobre colecciones y llamar a otros flujos. Las acciones se agrupan a continuación por propósito.
Operaciones de registro
- Crear registro: crea un nuevo registro de cualquier tipo de entidad. Asigna campos desde el disparador, desde salidas de pasos previos o desde valores estáticos.
- Actualizar registro: actualiza campos en el registro del disparador o en un registro relacionado. Proporcione un destino (trigger, steps o una expresión de marcador) más un mapa de campos.
- Establecer campo: establece un único campo a un valor. Una alternativa más ligera a Actualizar registro para cambios de un solo campo.
- Añadir etiqueta y Quitar etiqueta: añade o quita etiquetas en el registro destino.
- Cambiar responsable: establece el responsable a un ID de usuario o a un marcador (por ejemplo, el reportador del registro disparador).
- Archivar: archiva el registro destino.
- Eliminar: elimina el registro destino.
- Cambiar estado: mueve un registro por su flujo de estado (por ejemplo, ticket abierto a pendiente, o incidente investigando a contenido).
Notificaciones
- Enviar correo: envía un correo a direcciones estáticas, usuarios, direcciones resueltas por marcadores o listas de distribución. Admite asunto, cuerpo y adjuntos provenientes de salidas de pasos previos.
- Enviar notificación dentro de la aplicación: envía una notificación en tiempo real a uno o varios usuarios. Respeta las preferencias de notificación y las horas de silencio de cada usuario.
Mesa de ayuda
- Crear ticket de mesa de ayuda: crea un ticket con asunto, descripción, prioridad, categoría, canal y solicitante, asignados desde los datos del disparador.
- Asignar política de SLA: aplica una política de SLA al ticket disparador.
- Escalar ticket: cambia la prioridad, reasigna o aplica una ruta de escalado.
- Enviar respuesta predefinida: responde usando una plantilla de respuesta guardada.
- Añadir nota interna: añade una nota privada al hilo del ticket.
- Extraer referencias de ticket: escanea el asunto y el cuerpo de un correo entrante en busca de números de referencia (por ejemplo TKT-00042) usando un patrón regex. Las referencias extraídas se almacenan en el contexto de ejecución.
- Vincular correo a ticket: lee las referencias de ticket extraídas y adjunta el correo entrante a cada ticket coincidente. Coloque esta acción después de Extraer referencias de ticket.
Calendario y actividad
- Crear evento de calendario: programa un evento con título, descripción, horas de inicio y fin, y asistentes.
- Crear nota: guarda una nota en cualquier carpeta con etiquetas opcionales.
- Registrar actividad de ventas: registra una llamada, reunión, correo o nota contra un lead, oportunidad o negocio.
Integraciones externas
- Solicitud HTTP: envía una solicitud GET, POST, PUT, PATCH o DELETE con cabeceras y cuerpo personalizados. El estado y el cuerpo de la respuesta se exponen como salida del paso para acciones posteriores.
- Generar PDF: renderiza un PDF desde una plantilla o desde el contenido de un registro (se admiten notas, tareas, incidencias, incidentes, historias de usuario, políticas y procedimientos). La salida se puede adjuntar al registro disparador o enviarse como adjunto de correo.
Pasos de IA
- Resumir con IA: pasa texto de entrada a la IA y recibe un resumen. Establezca una clave de salida para referenciar el resultado después como
{{steps.<name>.output.<key>}}. El opcional max_words limita la longitud del resumen. - Clasificar con IA: clasifica la entrada en una de una lista de categorías proporcionada. Útil para enrutar tickets, priorizar incidencias o categorizar comentarios.
- Redactar respuesta con IA: redacta una respuesta a un correo o ticket usando el contexto del hilo. El borrador está disponible para acciones posteriores (por ejemplo, enviarlo como respuesta predefinida o como respuesta al ticket).
Los pasos de IA están regulados por la bandera de funcionalidad workflow_ai_actions.
Flujo de control
- Ramificación: evalúa un conjunto de grupos de expresiones (con lógica AND, OR y NOT) y ejecuta diferentes hijos según qué rama coincida. Añada acciones hijas con los botones Añadir acción, Añadir ramificación, Añadir bucle o Añadir sub-flujo.
- For-each: itera sobre una colección. La colección puede venir de una relación (
{{trigger.tasks}}), de una salida de paso o de una consulta específica del bucle. Dentro del bucle, use{{loop.item}},{{loop.item.<field>}}y{{loop.index}}. - Esperar: pausa la ejecución durante una duración relativa (minutos, horas, días) o hasta una fecha y hora específica. El flujo se reanuda desde el punto exacto donde se pausó.
- Llamar a sub-flujo: invoca otro flujo marcado como llamable. Pase entradas mediante input_mappings. La detección de ciclos bloquea cadenas infinitas, y un límite de profundidad por cadena protege contra la recursión descontrolada.
Manejo de errores por acción
Cada acción admite una política de reintento (retardo lineal o exponencial con un número configurable de intentos) y una política en caso de fallo (continuar, detener o ejecutar una acción de respaldo nombrada). Las acciones fallidas se registran con la entrada, el error y el recuento de intentos para que pueda diagnosticar problemas desde la página de detalle de la ejecución.
Salidas de pasos
Cualquier acción puede recibir un step_name. Su salida estará disponible para acciones posteriores como {{steps.<step_name>.output.<key>}}. Así es como los resúmenes de IA, las respuestas HTTP, los PDF adjuntos y las referencias de ticket extraídas se consumen más abajo en la cadena.