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:
| Variable | Para qué |
|---|---|
event | Lo que disparó el script: event.recordId, event.record, event.previousRecord, event.text… |
collections | Leer y escribir registros de las colecciones del alcance. |
http | Solicitudes HTTPS a dominios permitidos. |
services / integrations | Invocar acciones de integraciones y ver su estado. |
dashboard | Publicar valores para widgets y hacer sonar avisos. |
chat | Publicar en un canal o comentar un registro. |
notify, reports, properties, globals, dates, utilities, console | Avisos, reportes, propiedades del script, valores compartidos, fechas y utilidades. |
Cómo se usa
Sección titulada «Cómo se usa»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,paginateoquery().where().orderBy().limit(). - Escritura:
create,update,delete(con las mismas validaciones y reglas que una persona) eincrementpara sumas atómicas.
Reglas y límites
Sección titulada «Reglas y límites»- Hasta 2000 registros por consulta y 200 por
getMany. - HTTP: solo
httpsen 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.postychat.commentpublican con el nombre del script y los permisos de quien lo activó.
Para agentes (MCP)
Sección titulada «Para agentes (MCP)»get_script_guide: la firma exacta de cada método, lo que traeeventpor origen, los límites y recetas probadas.test_scriptdevuelveeffects: lo que el script haría sin aplicarlo.