Ir al contenido

API de scripts

Dentro de un script no hay módulos ni red directa: todo pasa por variables globales que el servidor revisa en cada llamada. Las principales:

VariablePara qué
eventLo que disparó el script: event.recordId, event.record, event.previousRecord, event.text…
collectionsLeer y escribir registros de las colecciones del alcance.
httpSolicitudes HTTPS a dominios permitidos.
services / integrationsInvocar acciones de integraciones y ver su estado.
dashboardPublicar valores para widgets y hacer sonar avisos.
chatPublicar en un canal o comentar un registro.
notify, reports, properties, globals, dates, utilities, consoleAvisos, reportes, propiedades del script, valores compartidos, fechas y utilidades.
const abiertos = await collections("Pedidos").findMany({ estado: "Pagado" }, { limit: 50 });
await collections("Pedidos").update(event.recordId, { estado: "Enviado" });
await dashboard.set("ventas_hoy", abiertos.length);
const r = await http.get("https://api.ejemplo.com/tasa");
console.log(r.status);
  • Lectura: findMany, findOne, find(id), count, search, paginate o query().where().orderBy().limit().
  • Escritura: create, update, delete (con las mismas validaciones y reglas que una persona) e increment para sumas atómicas.
  • Hasta 2000 registros por consulta y 200 por getMany.
  • HTTP: solo https en el puerto 443, sin redes internas ni redirecciones, 10 s, 64 KB, 30 por minuto y 1000 por día.
  • Cada escritura dispara las automatizaciones y scripts de esa colección, con la cadena limitada a 3 niveles.
  • chat.post y chat.comment publican con el nombre del script y los permisos de quien lo activó.
  • get_script_guide: la firma exacta de cada método, lo que trae event por origen, los límites y recetas probadas.
  • test_script devuelve effects: lo que el script haría sin aplicarlo.