Ir al contenido

Scripts

Un script es código JavaScript (async) que corre en segundo plano en un sandbox aislado. Se usa cuando una automatización o un flujo no alcanza: cálculos entre colecciones, llamadas HTTP, valores para dashboards o lógica de un sitio.

Orígenes: una colección (al crear, actualizar, borrar o a mano), comentarios de sus registros, mensajes de un canal del chat, una conexión MQTT, eventos de una integración, una acción de un sitio o una programación.

  1. Ve a «Configuración → Scripts» y crea uno.
  2. Elige el origen y los eventos, y declara el alcance: qué colecciones lee o escribe, si usa HTTP, servicios o el chat.
  3. Escribe el código en el editor y pulsa Probar: corre de verdad la lectura, pero las escrituras no se aplican, se muestran como efectos.
  4. Revisa la consola y las corridas recientes.
  5. Actívalo. Cambiar el código o el alcance lo vuelve a pausar.
  • Sin fetch, require, import ni DOM: todo pasa por las variables globales (ver API de scripts).
  • Un script solo ve las colecciones que declara. Quien lo activa aprueba el alcance y debe tener esos permisos.
  • Código hasta 50 000 caracteres; 250 llamadas a la plataforma y 500 escrituras por corrida; una cadena de scripts llega hasta 3 niveles.
  • HTTP solo con una conexión «HTTP para scripts» y el interruptor de la empresa encendido.
  • Permisos: scripts:view, scripts:edit, scripts:test, scripts:enable.
  • get_script_guide: API del sandbox, orígenes, límites y recetas. Léela antes de escribir código.
  • create_script (nace pausado) → test_script → corregir con update_script → set_script_enabled solo si la persona lo pide.
  • list_scripts, get_script y get_script_runs para revisar y diagnosticar.