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.
Prueba en Samples
Copia el snippet y valida eventos en el harness local.