Actualizado el Aug 4, 2026

Referencia de Acciones

Las acciones son los bloques de construcción que agregas en:

• Workflows > Pasos
• Agentes de IA > Acciones para pre-acciones y post-acciones
• Botones de notificación que ejecutan lógica de seguimiento

Cada acción hace un trabajo: llamar a una API, enviar un mensaje, actualizar un registro, ejecutar otro workflow o preparar datos para pasos posteriores.

No todas las acciones están disponibles en todos los constructores. Algunas acciones solo tienen sentido en workflows, algunas están diseñadas para pre-acciones o post-acciones de asistentes, y algunas requieren un contexto de conversación activo.

Cómo usar esta referencia

Usa estas páginas para responder tres preguntas prácticas:

1. ¿Cuál acción debo elegir?
2. ¿Qué campos necesito completar?
3. ¿Qué resultado puedo reutilizar en un paso posterior?

Si necesitas ayuda para escribir expresiones para campos dinámicos, consulta el Editor de Expresiones CEL.

Reutilizando resultados de pasos anteriores

La mayoría de las acciones ponen datos a disposición de pasos posteriores. Referéncialos con step(0), step(1) y así sucesivamente.

Ejemplos:

• step(0).data
• step(1).status
• step(2).choices[0].message.content

Usa Iniciar depuración o depuración paso a paso para inspeccionar la forma exacta de la salida antes de crear condiciones sobre ella.

Metadatos compartidos de ejecución

Cuando quieres saber cómo se ejecutó un paso en sí, usa el objeto anidado executionContext. Esto mantiene los metadatos del ejecutor separados de las salidas propias de la acción.

Campos comunes:

• step(0).executionContext.status -- running, completed, skipped o failed
• step(0).executionContext.startedAt
• step(0).executionContext.finishedAt
• step(0).executionContext.safeError.code
• step(0).executionContext.safeError.userMessage
• step(0).executionContext.safeError.retryable
• step(0).executionContext.safeResult

Ejemplos:

• get(step(0), 'executionContext.status') == 'completed'
• get(step(1), 'executionContext.safeError.code') == 'unsupported_media_format'
• get(step(2), 'executionContext.safeResult.reason') == 'condition_false'

safeError y safeResult están sanitizados para ramificación y depuración. No incluyen stack traces sin procesar, secretos ni payloads del proveedor.

Algunas acciones ya usan campos de nivel superior como step(N).status para sus propias salidas, por ejemplo, un código de estado HTTP. Prefiere step(N).executionContext.status cuando te refieres al resultado de la acción en sí.

Disponibilidad y contexto

• Usa acciones de conversación solo cuando la ejecución actual ya tiene una conversación con la que trabajar.
• Usa acciones específicas de asistente solo donde las acciones de asistente están soportadas.
• Si una acción depende de una funcionalidad específica, como memoria de conversación o un workflow hijo, asegúrate de que esa funcionalidad ya esté configurada antes de depender de la acción en producción.

Categorías

Categoría	Uso típico
IA y asistentes	Generar texto, enviar trabajo a otro asistente, limpiar memoria o pausar las respuestas del asistente
Código	Ejecutar JavaScript en un sandbox sobre datos de pasos anteriores
Configuración	Cargar variables y secretos de la empresa en expresiones CEL
Datos	Crear, obtener, buscar, actualizar, eliminar o activar workflows en tus datos de la empresa
Mensajes	Enviar respuestas a la conversación actual o enviar mensajes proactivamente a un contacto
Integraciones	Llamar APIs externas con solicitudes HTTP o descargar archivos directamente al storage
MCP	Conectar servidores MCP para que un agente use sus herramientas
Medios	Guardar archivos en storage, reutilizar sus URLs y crear enlaces de descarga firmados
Notificaciones	Alertar a miembros del equipo dentro de AutoTalk
Seguridad	Generar tokens JWT temporales
Estado de la sesión	Almacenar valores para expresiones CEL posteriores en la misma ejecución

Eligiendo la acción correcta

• Usa Generar Respuesta LLM cuando quieras la salida directa del modelo.
• Usa Enviar Mensaje al Asistente cuando quieras que otro asistente maneje la solicitud.
• Usa Componer Respuesta de la Conversación cuando quieras responder en la conversación actual.
• Usa Enviar Mensaje al Contacto cuando necesites enviar un mensaje directamente a un contacto específico.
• Usa Buscar Datos de la Empresa cuando necesites una lista.
• Usa Obtener Datos de la Empresa cuando ya sepas qué registro quieres.
• Usa Ejecutar Workflow cuando quieras que un workflow llame a otro.

Acciones que no retornan campos reutilizables

Algunas acciones son principalmente efectos secundarios y no proporcionan un resultado de paso significativo para reutilizar.

Ejemplos comunes:

• Limpiar Memoria de la Conversación
• Pausar respuestas del asistente
• Crear Notificación del Profesional

Úsalas cuando necesites el efecto en sí, no un valor para lógica posterior.