Skip to main content
Recomendamos encarecidamente usar Ejecutar script para crear automatizaciones, ya que permite cubrir el comportamiento de todas las acciones, incluidas aquellas que, de otro modo, tendrían que crearse manualmente. Solo tienes que describir tus requisitos a la IA en el chat.Ten en cuenta que, si añades acciones manualmente, la IA no podrá reconocerlas ni modificarlas más adelante.
La acción Ejecutar script te permite escribir JavaScript personalizado para aplicar una lógica que las acciones integradas no pueden cubrir. Puedes transformar datos, llamar a API externas, realizar cálculos, implementar ramificaciones condicionales y mucho más, todo ello dentro de un entorno aislado seguro. Los scripts reciben datos de pasos anteriores mediante el objeto input y pasan los resultados a los pasos posteriores mediante la función output.set().

Cuándo usar Ejecutar script en lugar de las acciones integradas

En general, utiliza las acciones integradas cuando se ajusten a tus necesidades. Utiliza Ejecutar script cuando necesites lógica personalizada, transformación de datos o una interacción compleja con una API.

Entorno

Cómo configurarla

  1. Añade una acción Ejecutar script a tu flujo de trabajo.
  2. El editor de scripts se abre con un lienzo en blanco. Escribe aquí tu código JavaScript.
  3. El script puede leer datos de pasos anteriores mediante el objeto input (consulta la información siguiente).
  4. Utiliza output.set(key, value) para pasar resultados a los pasos posteriores.
  5. (Opcional) Añade dependencias npm en el panel de configuración si tu script necesita bibliotecas externas.
  6. Haz clic en Probar para ejecutar el script con datos reales de la ejecución más reciente del desencadenador.
  7. Comprueba la salida de la prueba y los registros de la consola para verificar que el script funciona correctamente.
  8. Guarda la acción.

Leer datos de entrada

El objeto input contiene datos de todos los pasos anteriores del flujo de trabajo. Cada paso se identifica por el ID de su acción.

Estructura de la entrada

Obtener datos del desencadenador (Campos del Registro)

Obtener datos de un paso Obtener Registros

Obtener datos de las salidas de otras acciones

Utiliza console.log(JSON.stringify(input, null, 2)) durante las pruebas para ver la estructura exacta de los datos de entrada. Es la forma más rápida de saber qué hay disponible.

Escribir la salida

Utiliza output.set(key, value) para poner los datos a disposición de los pasos posteriores. Puedes definir varias claves.
Cada clave que definas se convierte en una variable independiente a la que los pasos posteriores pueden hacer referencia mediante el selector de variables +. Por ejemplo, si llamas a output.set("status", "success"), el paso siguiente puede hacer referencia a status en la salida de este script.

Depurar con console.log

Durante el desarrollo, utiliza console.log() para inspeccionar datos y seguir el flujo de ejecución. La salida de los registros aparece en el panel de prueba al hacer clic en Probar.
Los registros de la consola solo son visibles durante las pruebas; no aparecen en el historial de ejecuciones de producción. Utilízalos con libertad mientras creas tu script.

Gestión de paquetes npm

Puedes utilizar paquetes npm en tus scripts. Declara las dependencias en el panel de configuración:
Después, utilízalos en el script con require():
Siempre que sea posible, da prioridad a las funciones integradas de JavaScript frente a los paquetes npm. JavaScript moderno incluye muchas utilidades: Array.map(), Array.filter(), Object.entries(), literales de plantilla, desestructuración, etc. Añade paquetes npm únicamente cuando aporten un valor significativo.

Variables integradas

Seguridad: alcance de AUTOMATION_TOKEN

El AUTOMATION_TOKEN se genera automáticamente para cada ejecución de la Automatización. Tiene los mismos permisos que el creador de la Automatización y su alcance se limita a la ejecución actual. Aspectos clave:
  • Puede acceder a cualquier Tabla a la que tenga acceso el creador de la Automatización.
  • Solo es válido mientras dure la ejecución del script (tiempo de espera de 60 segundos).
  • No expongas este token a sistemas externos: está destinado a llamar a la API de Teable desde el script.

Llamar a la API de Teable

Llamar a la IA desde un script

POST /api/automation/runtime/ai envía un prompt al modelo de IA de tu Base. La Base se obtiene del contexto de la Automatización, por lo que no se necesita ningún ID de Base. El cuerpo acepta prompt, además de los parámetros opcionales attachments, modelKey, temperature y outputType; la respuesta es { "message": ... }. Los archivos adjuntos son elementos { url, mimetype, name }: se admiten hasta 10 por llamada, cada uno de menos de 20 MB y con 30 segundos para su descarga, e incluyen imágenes, archivos PDF y documentos de Office. Es posible que el modelo de chat predeterminado no pueda leer imágenes y archivos similares, así que proporciona modelKey cuando envíes archivos. Cada llamada consume créditos.

Gestión de errores

Envuelve siempre las operaciones de riesgo en bloques try/catch para que el flujo de trabajo pueda gestionar los fallos correctamente:
Sin la gestión de errores, un error de fetch o un formato de datos inesperado bloqueará el script, y los pasos posteriores no recibirán ninguna salida.

Ejemplo completo: procesar y dirigir tickets de soporte

Consejos

  • Empieza con console.log. Al crear un script nuevo, registra primero el objeto input completo para comprender su estructura.
  • Crea scripts específicos. Haz bien una sola cosa en vez de concentrar varias tareas en un único script. Encadena varias acciones Ejecutar script si es necesario.
  • Ten en cuenta el tiempo de espera de 60 segundos. Las operaciones prolongadas (procesamiento de grandes volúmenes de datos o muchas llamadas secuenciales a API) pueden alcanzar el tiempo de espera. Divide las tareas grandes en fragmentos más pequeños.
  • Haz pruebas con datos reales. El panel de prueba utiliza datos reales de la ejecución más reciente del desencadenador para ofrecerte resultados realistas.
  • Gestiona los datos que faltan. Utiliza valores predeterminados (operador ||) para los Campos que puedan estar vacíos o no definidos.

Contenido relacionado

  • Generar con IA — para tareas de IA basadas en prompts que no necesitan código personalizado
  • Solicitud HTTP — para llamadas sencillas a API que no necesitan scripts
Última modificación el 4 de septiembre de 2026