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-clivalidafirma login
/plugin marketplace add redcumbre/skills/plugin install validafirma@redcumbre
- Integra la firma de ValidaFirma en mi app.
- 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`.
- 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.
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.
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); // 201import 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.
«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.
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`.
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`.
Te pregunta lo que falta
¿Cuántos días tiene tu firmante para firmar? En prueba uso 3, el máximo.
Escribe la integración
+ crear-documento.js
+ webhook.js
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