Saltar al contenido

Pídele a tu agente que integre la firma.

Tu usuario firma por WhatsApp con cédula y rostro.

  • npx skills add redcumbre/skills
  • npm install -g @redcumbrecl/validafirma-cli
  • validafirma login
  • /plugin marketplace add redcumbre/skills
  • /plugin install validafirma@redcumbre
  1. Integra la firma de ValidaFirma en mi app.
  2. validafirma init
  3. Listo: keys/validafirma-prueba.json quedó en tu proyecto con la llave de prueba (prueba). Producción se pide después con `validafirma pasar-a-produccion`.
  4. validafirma prueba verificar --reenviar-a http://localhost:3000/webhooks/validafirma --crear "node crear-contrato.js"
  5. ✓ Verificado: la firma y el rechazo llegaron a tu sistema con 2 aviso(s) respondidos con 2xx, el duplicado descartado con 2xx y la firma alterada rechazada con 401.
+56

Te llega un documento marcado PRUEBA.

Crear cuenta con 5 firmas gratis

Lo que ve tu usuario.

Firma desde su celular, sin instalar nada. La verificación ocurre fuera de tu app.

la primera vez, con cédula y rostro
menos de2 minutos
las siguientes, solo con su rostro
menos de15 segundos

Un llamado lo crea. Un aviso te dice que está firmado.

Pruébalo gratis con una API key de sandbox. Nada se envía ni se cobra, y el firmante 49999901-1 firma solo.

POST /api/fes/documentos
curl -X POST https://api.validafirma.cl/api/fes/documentos \
  -H "X-API-Key: $VALIDAFIRMA_API_KEY" \
  -F "documento=@contrato.pdf" \
  -F 'firmantes=[{"rut":"49999901-1","canal":"whatsapp","telefono":"+56912345678"}]' \
  -F "webhook_url=https://tu-sistema.cl/webhooks/validafirma"
import fs from 'node:fs';

const form = new FormData();
form.append('documento', new Blob([fs.readFileSync('contrato.pdf')], { type: 'application/pdf' }), 'contrato.pdf');
form.append('firmantes', JSON.stringify([{ rut: '49999901-1', canal: 'whatsapp', telefono: '+56912345678' }]));
form.append('webhook_url', 'https://tu-sistema.cl/webhooks/validafirma');

const r = await fetch('https://api.validafirma.cl/api/fes/documentos', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.VALIDAFIRMA_API_KEY },
  body: form,
});
console.log(r.status); // 201
import json, os
import requests

with open("contrato.pdf", "rb") as pdf:
    r = requests.post(
        "https://api.validafirma.cl/api/fes/documentos",
        headers={"X-API-Key": os.environ["VALIDAFIRMA_API_KEY"]},
        files={"documento": ("contrato.pdf", pdf, "application/pdf")},
        data={
            "firmantes": json.dumps([{"rut": "49999901-1", "canal": "whatsapp", "telefono": "+56912345678"}]),
            "webhook_url": "https://tu-sistema.cl/webhooks/validafirma",
        },
    )
print(r.status_code)  # 201
{
  "documento": {
    "id": "9f1c2a7e-4b3d-4e6f-8a21-5c0d7e9b1f44",
    "estado": "pendiente",
    "es_prueba": true,
    "firmantes": [{ "rut": "49999901-1", "canal": "whatsapp", "estado": "pendiente" }]
  },
  "cobro": { "modo": "prueba", "mensaje": "En modo de prueba no se cobra." }
}
{
  "evento": "documento.completado",
  "es_prueba": true,
  "documento": {
    "id": "9f1c2a7e-4b3d-4e6f-8a21-5c0d7e9b1f44",
    "estado": "firmado",
    "url_api_descarga": "https://api.validafirma.cl/api/fes/documentos/9f1c2a7e-4b3d-4e6f-8a21-5c0d7e9b1f44/descargar",
    "url_validacion": "https://app.validafirma.cl/public/validar?codigo=mu8k2x4p-9A4C71E8"
  },
  "firmantes": [{
    "nombre": "ANA MARÍA PÉREZ SOTO",
    "rut": "49999901-1",
    "estado": "firmado",
    "verificacion": { "metodo": "pinrut" }
  }]
}

Documentación API REST de firma electrónica Referencia OpenAPI

Tu agente lo integra y lo prueba.

Le pides la firma y tu agente la integra en modo de prueba, paso a paso.

Tú, a tu agente
«Integra la firma de ValidaFirma en mi app: cuando alguien contrate, que le llegue el contrato para firmar por WhatsApp y que vuelva firmado.»

Cámbialo por lo que hace tu app.

  1. Lee la guía

    validafirma guia

    Guía del integrador. Lee un tema con `validafirma guia <tema>`; las instrucciones para el agente, con `validafirma guia instrucciones`.

  2. Deja la llave de prueba en tu proyecto

    validafirma init

    Listo: keys/validafirma-prueba.json quedó en tu proyecto con la llave de prueba (prueba). Producción se pide después con `validafirma pasar-a-produccion`.

  3. Te pregunta lo que falta

    ¿Cuántos días tiene tu firmante para firmar? En prueba uso 3, el máximo.

  4. Escribe la integración

    + crear-documento.js

    + webhook.js

  5. La prueba de punta a punta

    validafirma prueba verificar --reenviar-a http://localhost:3000/webhooks/validafirma --crear "node crear-contrato.js"

    ✓ Verificado: la firma y el rechazo llegaron a tu sistema con 2 aviso(s) respondidos con 2xx, el duplicado descartado con 2xx y la firma alterada rechazada con 401.

Producción la apruebas tú.

  • Cada operación en producción la apruebas tú, en el navegador.

  • La llave de producción queda fuera del chat con tu agente y del repositorio.

validafirma pasar-a-produccion

Aprueba esta operación en el navegador: https://app.validafirma.cl/…

Esperando la aprobación en el navegador…

Precio

$690+ IVA por firma

5 firmas gratis, 30 díasSin costo mensual.

Míralo funcionar.

  • Tu agente integra la firma

  • De punta a punta

  • La firma por WhatsApp, en tu app

Preguntas.

¿Cuánto cuesta integrarlo?

Intégralo completamente gratis con una API key de sandbox, la llave de prueba. Con ella, ValidaFirma simula lo que cuesta o le llega a una persona: los mensajes, la verificación y el cobro. El PDF sale marcado «PRUEBA, sin validez».

El modo de prueba admite 200 documentos al día, con 3 días para firmar, y cada documento se borra 3 días después de vencer o de terminar. En producción pagas $690 más IVA por firma, sin costo mensual.

¿Necesito Claude Code?

No. validafirma login deja el skill para Claude Code, Codex y Cursor. Con otro agente, o sin agente, sigues la documentación y la API.

¿Mi app recibe datos biométricos?

No. La verificación de identidad ocurre fuera de tu app, con PINRUT. Tu app recibe el PDF firmado y el nombre verificado de cada firmante, y ValidaFirma guarda la evidencia de cada firma durante 6 años.

¿Qué validez tiene la firma?

La firma electrónica simple vale como firma manuscrita según la Ley 19.799, salvo en los actos que la misma ley excluye y en los instrumentos públicos, que piden firma avanzada.

¿Te ayudamos a empezar?

Cuéntanos qué documento firma tu app. Te decimos cómo quedaría la integración.

O llámanos al +56 9 2821 5142