Embedded Signing

Integra la experiencia de firma electrónica directamente dentro de tu aplicación web. Tus usuarios firman documentos sin salir de tu plataforma — tú controlas la experiencia, AllSign se encarga de la legalidad.

¿Qué es Embedded Signing?

Con Embedded Signing, la interfaz de firma de AllSign se carga dentro de tu aplicación mediante un iFrame controlado por un JS SDK ligero. El firmante nunca sale de tu sitio, y tú recibes eventos en tiempo real sobre el progreso de la firma.

┌───────────────────────────────────────────────────────┐
│ Tu aplicacion (ERP, SaaS, portal de clientes)         │
│                                                       │
│  ┌─────────────────────────────────────────────────┐  │
│  │ AllSign Embedded Widget                         │  │
│  │                                                 │  │
│  │  ┌───────────────────────────────────────────┐  │  │
│  │  │ PDF del contrato                          │  │  │
│  │  │                                           │  │  │
│  │  │ [Firma aqui]                              │  │  │
│  │  │                                           │  │  │
│  │  └───────────────────────────────────────────┘  │  │
│  │                                                 │  │
│  │  [ Firmar documento ]                           │  │
│  └─────────────────────────────────────────────────┘  │
│                                                       │
│ Tu branding, tu dominio, tu experiencia               │
└───────────────────────────────────────────────────────┘

¿Por qué Embedded vs Email/WhatsApp?

	Email / WhatsApp	Embedded Signing
Experiencia	El firmante sale de tu app, abre un link externo	El firmante firma dentro de tu aplicación
Conversión	Fricción alta — el usuario puede no completar	Fricción mínima — flujo continuo
Control	Dependes del timing del firmante	Tú controlas cuándo y dónde aparece la firma
Branding	Interfaz de AllSign	Tu branding con AllSign por detrás
Eventos	Webhooks (async)	Eventos en tiempo real + webhooks

Flujo de integración

Inspirado en los mejores SDKs del mercado (Plaid Link moderno, Typeform Embed). La integración se hace en 4 pasos:

1. Crea tu documento

Usa la API de documentos que ya conoces. Si ya tienes un document_id, salta al paso 2.

POST /v2/documents → { id: "550e8400-..." }

2. Genera una Signing Session con el document_id

Pasa el document_id y el email del firmante. Recibes un client_secret para tu frontend.

POST /v2/signing-sessions → { client_secret: "as_sess_xxx_secret_yyy" }

Esto también funciona para documentos ya firmados — el widget se monta en modo lectura.

3. Tu frontend monta el widget (3 modos disponibles)

import { AllSign } from '@allsign/embedded';

// Una sola credencial en el frontend: el client_secret de la session.
// No hay publishable key — el client_secret es efímero (15 min) y scoped
// a una sola firma, siguiendo el modelo Plaid moderno (link_token-only).
const session = AllSign.init({
  clientSecret: 'as_sess_xxx_secret_yyy',
});

// Modal — un overlay sobre tu app (el más fácil)
session.modal();

// Inline — dentro de un div que tú controlas
session.inline('#firma-container');

4. Escuchas eventos y reaccionas

AllSign.init({
  clientSecret: 'as_sess_xxx_secret_yyy',
  onSuccess: (result) => {
    // Actualiza tu UI — feedback instantáneo
  },
});

Tu servidor recibe el webhook signer.signed como fuente de verdad.

O sin JS — con un atributo HTML

Para integraciones no-code (WordPress, Webflow):

<div data-allsign-session="as_sess_xxx" data-allsign-mode="inline"></div>
<script src="https://js.allsign.io/v1/embed.js" async></script>

Casos de uso

Fintech y crédito digital

El solicitante firma pagaré, contrato de mutuo y aviso de privacidad sin salir del flujo de aprobación. Cada paso extra reduce la conversión entre 15-40% — la firma embebida elimina esa fricción. El usuario solicita, se aprueba, firma y recibe el dinero en un solo flujo.

Insurtech — Emisión de pólizas

El asegurado firma la solicitud de seguro y póliza justo después de cotizar. La firma ocurre entre la cotización y el pago — interrumpir ese momento con un email mata el impulso de compra.

HR Tech — Onboarding de empleados

El nuevo empleado firma contrato laboral, NDA, políticas internas y formatos IMSS dentro del portal de RRHH. Un solo flujo secuencial para 5-15 documentos, con visibilidad en tiempo real del progreso para el equipo de RRHH.

Proptech — Contratos de arrendamiento

Arrendador y arrendatario firman contrato, inventario y fianza dentro de la plataforma de gestión de propiedades. El sistema ya tiene toda la información del inmueble — generar y firmar in situ reduce el cierre de semanas a horas.

ERP y Procurement

El responsable de compras firma órdenes de compra y contratos marco dentro del módulo de compras. La firma es parte nativa del workflow de aprobación — no hay desincronización con el sistema contable.

Telemedicina y salud

El paciente firma consentimiento informado y autorización de procedimiento dentro de la app de telemedicina, segundos antes de iniciar la consulta. Los datos de salud requieren cadena de custodia estricta (NOM-004-SSA3).

Legal Tech y notarías digitales

Las partes firman escrituras, poderes y constitutivas con verificación de INE + firma en un solo flujo auditable. Cumple con la Ley del Notariado Digital y genera constancia NOM-151 automáticamente.

Educación — Inscripciones y becas

El estudiante o tutor firma contrato de servicios educativos y reglamento dentro del portal de inscripciones. Miles de contratos en períodos cortos — la firma embebida elimina la presencia física.

Plataformas SaaS B2B

Al hacer upgrade a plan enterprise, el administrador firma el MSA (Master Service Agreement) como paso obligatorio antes de desbloquear las features. La firma es un gate de activación dentro del onboarding del producto.

Logística y entrega de mercancía

El receptor firma el comprobante de entrega dentro de la app del repartidor o del sistema de gestión logística. La firma se captura en el momento exacto con geolocalización y timestamp, vinculada automáticamente al número de guía.

Marketplaces — Alta de vendedores

El seller firma contrato de comisión mercantil y formato fiscal como paso obligatorio para poder listar productos. Es un gate automático — sin firma, no se publican productos.

Automotriz — Cierre de venta

El comprador firma compraventa, solicitud de crédito y póliza de seguro en una sola sesión dentro del sistema del dealer. Un "closing room digital" que reduce la firma de 8-12 documentos de días a minutos.

Factoraje y supply chain finance

El proveedor cede facturas y firma la cesión de derechos de cobro dentro de la plataforma de factoraje. Cada minuto que tarda la firma retrasa el fondeo — la inmediatez es crítica.

Telecomunicaciones — Contratación de servicios

El cliente firma contrato de adhesión dentro del portal del operador. La firma embebida permite que la contratación sea 100% digital y el servicio se active inmediatamente después.

Gobierno — Trámites ciudadanos

El ciudadano firma solicitudes, permisos y declaraciones dentro del portal de trámites del gobierno. La firma es parte integral del sistema — no se redirige a un tercero que genere desconfianza.

Energía — Paneles solares y suministro

El cliente firma contrato de suministro y financiamiento del sistema solar durante la presentación del asesor. Si tiene que esperar un email, se enfría la venta. Firmar al momento de la cotización cierra el deal.

Construcción — Estimaciones de obra

El residente firma estimaciones quincenales y actas de entrega desde su tablet en el sitio de construcción, dentro del sistema de gestión de proyectos. Decenas de contratistas, cada quincena — inmanejable por email.

Compliance y KYC

El cliente firma formatos de conoce a tu cliente, declaración de beneficiario controlador y PEP dentro del portal de onboarding regulatorio. Verificación de identidad + firma en un solo flujo auditable para cumplir con CNBV y UIF.

Cobranza — Convenios de pago

El deudor firma un convenio de pago durante la llamada con el agente o desde el portal de autoatención. El momento de disposición es efímero — la firma debe ocurrir en el mismo instante de la negociación.

Farmacéuticas — Ensayos clínicos

El paciente participante firma eConsent (consentimiento informado electrónico) con material multimedia, preguntas de comprensión y timestamps exactos. COFEPRIS y las GCP exigen trazabilidad completa.

Gobierno corporativo — Asambleas

Los accionistas firman resoluciones unánimes fuera de asamblea desde el portal de gobierno corporativo. 15 accionistas en diferentes ciudades, cada uno firma con visibilidad del estatus para el secretario del consejo.

Agro Tech — Contratos de cosecha

El productor firma contratos de agricultura por contrato y comprobantes de entrega desde la app del técnico de campo. Zonas rurales con conectividad limitada — la firma debe ser parte del flujo de captura en campo.

Contabilidad y fiscal

El contribuyente firma autorizaciones de acceso a datos fiscales y cartas de encargo dentro del sistema contable. El contexto fiscal mexicano permite vincular la e.firma del SAT como parte del flujo de presentación.

Ventajas sobre otras plataformas

AllSign es la única plataforma de firma electrónica que ofrece NOM-151, verificación de identidad (INE + biométricos) y firma embebida en un solo flujo integrado — diseñado desde cero para el mercado mexicano.

Feature	AllSign	SignNow	Dropbox Sign	DocuSign
Crear + firmar en 1 llamada	✅ Signing Sessions	❌ 4-5 calls	❌ 2 calls	❌ 2+ calls
Modos de embedding	Modal, inline, slider	Solo iFrame	Solo modal	Modal o iFrame
React hook nativo	✅ `useAllSignLink()`	❌	❌	❌
Embed sin JS (HTML attributes)	✅ `data-allsign-*`	❌	❌	❌
NOM-151 nativo	✅	❌	❌	❌
Verificación de identidad en flujo	✅ INE + biométricos	❌	❌	Solo KBA
Pre-fill de variables desde frontend	✅ `values` prop	❌	❌	❌
Eventos real-time (SSE)	✅	❌	❌	❌
Test mode con un flag	✅ `test_mode: true`	❌ Sandbox separado	✅	❌ Sandbox separado
Locale es-MX nativo	✅	Traducción	Traducción	Traducción
White-label	Todos los planes	Enterprise	API configurable	Enterprise

MCP Server: AllSign para agentes de IA

AllSign también ofrece un servidor MCP (Model Context Protocol) que permite a agentes de IA y LLMs interactuar con la plataforma directamente. Ideal para automatizar flujos de firma desde asistentes inteligentes, chatbots o pipelines de IA.

Herramientas disponibles

Herramienta	Descripción
`list_templates`	Buscar y listar templates disponibles
`get_template`	Obtener detalle completo de un template (variables, config de firma)
`get_template_variables`	Variables auto-detectadas con tipo y si son requeridas
`preview_template`	Vista previa del template con variables llenadas
`create_document_from_template`	Crear documento llenando variables, convertir a PDF y dejarlo listo para firma
`ai_edit_template`	Editar contenido del template con instrucciones en lenguaje natural
`search_contacts`	Buscar contactos por nombre, email o empresa
`get_contact`	Perfil completo del contacto con campos custom
`list_documents`	Listar documentos con filtros de estado
`get_document`	Detalle del documento con firmantes, estado y audit trail

Configuración

# Variables de entorno
ALLSIGN_API_URL=https://api.allsign.io
ALLSIGN_API_KEY=allsign_live_sk_TU_SECRET_KEY

# Ejecutar el servidor MCP
uv run allsign-mcp

Ejemplo: Un agente crea y envía un contrato

Usuario: "Crea un contrato de servicios para Juan Pérez con RFC PEPJ900101ABC por $50,000"

Agente:
  1. search_contacts("Juan Pérez") → encuentra el contacto
  2. get_template_variables("contrato-servicios") → nombre, rfc, monto
  3. create_document_from_template("contrato-servicios", {nombre: "Juan Pérez", rfc: "PEPJ900101ABC", monto: "$50,000"})
  → Documento creado y listo para firma

Esto abre la puerta a flujos de firma completamente automatizados donde un agente de IA prepara, personaliza y envía documentos sin intervención humana.

Siguiente paso

Sigue el Quickstart para tener tu primera firma embebida funcionando en 5 minutos.