Firma electrónica (Clicksign)
Envía propuestas para firma electrónica usando tu propia cuenta Clicksign (modelo BYO).
La integración de Firma electrónica con Clicksign usa TU cuenta Clicksign (modelo BYO, "trae tu propia cuenta"). Los documentos se crean y se cobran en tu cuenta Clicksign: no hay costo, margen ni intermediación de nuestra parte. Nosotros solo programamos los campos y el botón para enviar la propuesta a firma.
La integración nace inerte: no ocurre nada hasta que completes los campos y actives. El access token y el secret del webhook se guardan cifrados en el CRM y nunca se muestran de vuelta.
Requisitos previos
- Una cuenta Clicksign (Sandbox para pruebas o Producción) con permiso de API.
- Acceso al panel de Clicksign para generar el access token (Configuración → API) y crear un webhook con un secret HMAC.
- En Sellio, ser administrador para guardar las credenciales y activar la integración en Configuración → Integraciones.
Lo que necesitas completar
- Entorno: Sandbox (para pruebas, en sandbox.clicksign.com) o Producción (para valer, en app.clicksign.com). Cada entorno tiene su propio access token.
- Access token: el token de acceso de la API, generado en el panel de Clicksign en Configuración → API. Autentica las llamadas (mediante ?access_token=). Se guarda cifrado en el CRM.
- Secret del webhook (HMAC): un secreto que defines al crear el webhook en Clicksign. Sirve para verificar la firma HMAC-SHA256 de los eventos que Clicksign nos envía. Se guarda cifrado en el CRM.
Cómo configurar
- Abre Configuración → Integraciones y localiza la tarjeta "Firma electrónica (Clicksign)".
- Elige el entorno, pega el Access token y el Secret del webhook, y haz clic en "Guardar credenciales".
- Copia la "URL del webhook (Clicksign)" que aparece y, en Clicksign → Configuración → API/Webhooks, crea un webhook apuntando a esa URL usando exactamente el mismo secret.
- Vuelve al CRM y haz clic en "Activar".
Cómo enviar una propuesta a firma
- Abre una oportunidad y ve a la sección de Propuestas.
- En la versión deseada, haz clic en "Firma", indica el correo (y, opcionalmente, el nombre) del firmante.
- Si tienes DocuSign y Clicksign activos al mismo tiempo, aparecen dos botones ("Enviar vía DocuSign" y "Enviar vía Clicksign"); elige Clicksign. Si solo Clicksign está activo, un único botón ya lo usa.
- El CRM crea el documento en Clicksign, agrega al firmante y solicita la firma; Clicksign envía el correo de firma al firmante.
- A medida que el firmante avanza, el estado aparece en la lista "Firmas" de la propuesta (Enviado → Entregado → Firmado).
💡 Cuando el documento se firma por completo (evento de cierre de Clicksign) y la solicitud está vinculada a una propuesta, la propuesta se marca como aceptada automáticamente. Los webhooks se verifican por firma HMAC-SHA256 (header Content-Hmac): si el secret no coincide, el evento se rechaza. Si intentas enviar sin haber configurado Clicksign, el CRM avisa de forma clara; la funcionalidad queda inerte hasta que las credenciales estén en su lugar.
Cómo probar
- Usa el entorno Sandbox con el access token de sandbox.
- En una propuesta, haz clic en "Firma", indica tu propio correo como firmante y confirma.
- Confirma que recibiste el correo de Clicksign y que la lista "Firmas" muestra "Enviado".
- Firma el documento y verifica que el estado avanza a "Firmado" y la propuesta se marca como aceptada: es señal de que el webhook (con HMAC válido) llegó.
Solución de problemas
- 401 al enviar: el access token es incorrecto o es de otro entorno (token de sandbox usado en producción, o viceversa). Confirma el entorno y vuelve a pegar el token de ese entorno.
- El estado no se actualiza en la propuesta: el webhook no está llegando o la firma falla. Confirma que el webhook en Clicksign apunta a la "URL del webhook (Clicksign)" y usa EXACTAMENTE el mismo secret guardado en el CRM (header Content-Hmac, HMAC-SHA256).
- Evento rechazado (firma inválida): el secret del webhook difiere entre Clicksign y el CRM. Guarda el mismo valor en ambos lados.
- No ocurre nada al enviar: la integración está inerte por falta de credenciales o no se activó. Completa entorno + token + secret y haz clic en Activar.