Saltar al contenido principal

Widget

Integrar el Widget

Quickstart técnico con URL versionada y callbacks.

Widget

Qué resuelve

UI embebida de revisión contractual sin construir tu propio shell.

Widget

Cuándo usarlo

Checkout, onboarding o portales donde el partner tiene la clave pública y controla el DOM.

Widget

Requisitos

Crea una integración Widget en el dashboard de partner.

  • Integración Widget con ink_pub_*
  • allowedOrigins configurados en el dashboard
  • HTTPS en producción

Widget

Crear integración

Copia ink_pub_* y añade cada origen de producción y staging.

Widget

Snippet mínimo

Carga el bundle v1 e inicializa con preset y parentOrigin.

Bundle estable en /widget/v1/inkspectra-widget.js — alias v1 dentro de la misma major.

<script src="http://localhost:3000/widget/v1/inkspectra-widget.js"></script>
<script>
  const instance = Inkspectra.init({
    publicKey: "ink_pub_…",
    container: "#inkspectra-widget",
    config: { version: 1, preset: "compact_review" },
    locale: "es",
    parentOrigin: window.location.origin,
    document: { title: "Terms", text: "Paste contract text here (minimum 50 characters)…" },
    onAnalysisCompleted: function (e) { console.log(e.riskScore); },
    onResize: function (e) {
      console.log("resize", e.sessionId, e.height);
    },
    onSessionExpired: function (e) {
      void instance.recreateSession();
    },
  });

  // Recommended cleanup (e.g. SPA route change):
  // instance.destroy();
</script>
<div id="inkspectra-widget"></div>

Widget

Callbacks

Escucha onResize, onSessionExpired y onAnalysisCompleted.

Widget

destroy()

Llama instance.destroy() al desmontar (SPA, tabs).

Widget

Expiración de sesión

Usa onSessionExpired y instance.recreateSession() o refresca desde tu backend.

Orígenes permitidos

parentOrigin debe coincidir con un allowedOrigin registrado.

Configuración y presets · Catálogo de eventos

Prueba en Samples

Copia el snippet y valida eventos en el harness local.