Integra el editor

Permite que tus clientes creen, editen, prueben y publiquen sus decisiones dentro de tu app con sesiones de embed desde tu backend, el script @dcision/embed, permisos y eventos.

Tus usuarios finales obtienen las pantallas de decisiones de Dcision dentro de tu app: la lista de decisiones, las plantillas, Crear con el agente, el editor y el constructor visual, el playground, la publicación y las ejecuciones de cada decisión. Actúan solo en su subespacio y nunca ven claves de API, facturación ni configuración.

1. Abre una sesión (tu backend)

Cuando un usuario con sesión iniciada abre la página, tu backend llama a POST /v1/embed/sessions con tu clave de API, nunca desde el navegador:

// POST /api/dcision/session in your backend — the user and their workspace come from YOUR session, never the request.
const session = await dcision.embed.createSession({
  workspace: { external_id: currentWorkspace.id, name: currentWorkspace.name },
  user: { id: currentUser.id, name: currentUser.name },
  permissions: canEdit ? undefined : ["decisions:read", "executions:read"],
  start_path: body.path, // where the user was (sent back by the embed after a session expires)
  locale: "pt",
});
return { url: session.url };

url es un enlace de apertura de un solo uso, válido por 60 segundos. La sesión en sí dura ttl_seconds (por defecto 1 hora, hasta 12).

2. Móntalo (tu página)

import { mount } from "@dcision/embed";

const embed = await mount(document.getElementById("decisions")!, {
  getSession: ({ path }) => fetch("/api/dcision/session", { method: "POST", body: JSON.stringify({ path }) }).then((r) => r.json()),
  onEvent: (event) => {
    if (event.type === "decision.deployed") refreshStrategies();
  },
});
  • El iframe crece con su contenido (height: "auto") y vuelve a abrir una sesión por sí solo cuando expira, en la página donde estaba el usuario.
  • embed.navigate("/decisions/new") abre una página; embed.setTheme("dark") cambia el tema.
  • Permite el frame en tu Content-Security-Policy: frame-src https://app.dcision.io.
  • Hasta que @dcision/embed esté en npm, copia su código fuente del repositorio de Dcision (packages/embed): no tiene dependencias.

Permisos

PermisoPermite al usuario
decisions:readVer decisiones, versiones, el resumen y la conversación con el agente
decisions:writeCrear (desde plantillas), editar, duplicar y probar en el playground
decisions:deployPublicar, desactivar y activar
decisions:deleteEliminar decisiones
executions:readVer ejecuciones y entregas de destinos
agentCrear y editar con el agente

Por defecto: todos. Asígnalos a partir de tus propios roles; p. ej., los lectores reciben decisions:read y executions:read.

Eventos

El embed envía estos mensajes a tu página (solo a tus orígenes permitidos). Llevan IDs, slugs, versiones y rutas, nunca tokens ni entradas.

EventoCuándo
ready, navigateEl embed cargó, o el usuario pasó a otra página (path)
resizeCambió la altura del contenido (height)
decision.created · decision.updated · decision.deletedSe creó una decisión, se guardó su borrador o se eliminó
decision.deployed · decision.enabled · decision.disabledCambió lo que se ejecuta en producción (version)
session.expiring · session.expiredLa sesión termina en 2 minutos / terminó (el script la vuelve a abrir)

Seguridad

  • Solo los orígenes permitidos en Configuración → Socio pueden mostrar el editor en un frame, y solo durante la vida de la sesión. Abierto fuera de un iframe, el enlace no muestra nada.
  • Tu clave de API se queda en tu servidor. Revoca una sesión con DELETE /v1/embed/sessions/{id}, o todas las de un usuario con POST /v1/embed/sessions/revoke; revocar o regenerar la clave de API que las creó también las cierra.
  • El user que envías se muestra en el editor y en el chat del agente, y cuenta para los límites por persona del agente. Tómalo de tu propia sesión.

En esta página