Firma electrónica (DocuSign)

Envía propuestas para firma electrónica usando tu propia cuenta DocuSign (modelo BYO).

La integración de Firma electrónica usa TU cuenta DocuSign (modelo BYO, "trae tu propia cuenta"). Los envelopes se crean y se cobran en tu cuenta DocuSign: 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 se guarda cifrado en el CRM y nunca se muestra de vuelta.

Requisitos previos

• Una cuenta DocuSign (entorno de prueba/demo o producción) con permiso para enviar envelopes.
• Acceso al panel de DocuSign para ver Apps and Keys (Account ID y Base URI), generar un access token OAuth y configurar DocuSign Connect (Admin → Connect).
• En Sellio, ser administrador para guardar las credenciales y activar la integración en Configuración → Integraciones.

Lo que necesitas completar

• Account ID (API Account ID): el identificador de tu cuenta DocuSign, que se encuentra en Settings → Apps and Keys en el panel de DocuSign.
• Base URI de la cuenta: la dirección base de tu cuenta: https://demo.docusign.net en el entorno de prueba, o algo como https://na3.docusign.net en producción (el subdominio varía según tu cuenta; aparece en la misma pantalla de Apps and Keys).
• Access token (OAuth): un token de acceso que generas en DocuSign para autorizar las llamadas. Se guarda cifrado en el CRM.
• Clave HMAC de Connect (obligatoria para recibir webhooks): la clave secreta que DocuSign usa para firmar cada webhook. Activa el HMAC en Admin → Connect y copia la clave generada. Sin ella, los webhooks se rechazan (el estado de la firma no avanza por sí solo).

Cómo configurar

1. Abre Configuración → Integraciones y localiza la tarjeta "Firma electrónica (DocuSign)".
2. Pega el Account ID, el Base URI, el Access token y la Clave HMAC de Connect y haz clic en "Guardar credenciales".
3. Copia la "URL del webhook (DocuSign Connect)" que aparece y, en DocuSign Admin → Connect, crea una configuración personalizada apuntando a esa URL, marcando los eventos de envelope (enviado, entregado, completado, rechazado, anulado).
4. En la misma configuración de Connect, ACTIVA el HMAC (Include HMAC signature) usando la misma clave que pegaste en el CRM; DocuSign firma entonces cada evento en el header X-DocuSign-Signature-1 y el CRM la verifica.
5. Vuelve al CRM y haz clic en "Activar".

Cómo enviar una propuesta a firma

1. Abre una oportunidad y ve a la sección de Propuestas.
2. En la versión deseada, haz clic en "Firma", indica el correo (y, opcionalmente, el nombre) del firmante y confirma.
3. El CRM crea un envelope en DocuSign con el documento de la propuesta y envía el correo de firma al firmante.
4. A medida que el firmante avanza, el estado aparece en la lista "Firmas" de la propuesta (Enviado → Entregado → Firmado).

Hoy la autenticación usa un access token que pegas (el camino más simple). Una evolución futura es el JWT grant (integration key + clave privada), que renueva el token automáticamente sin pegar manualmente.

Cómo probar

1. Usa el entorno demo (Base URI https://demo.docusign.net) con un access token de prueba.
2. En una propuesta, haz clic en "Firma", indica tu propio correo como firmante y confirma.
3. Verifica que recibiste el correo de DocuSign y que la lista "Firmas" de la propuesta muestra "Enviado".
4. Firma el documento; confirma que el estado avanza (Entregado → Firmado) y que la propuesta se marca como aceptada: es señal de que DocuSign Connect llegó al CRM.

Solución de problemas

• 401 al enviar: el access token venció (los tokens OAuth de DocuSign tienen validez corta) o es incorrecto. Genera un nuevo token y vuelve a pegar. El Account ID y el Base URI deben ser de la MISMA cuenta.
• Error de cuenta/URL: confirma el Base URI correcto (demo.docusign.net en prueba; naX.docusign.net en producción; el subdominio aparece en Apps and Keys) y el API Account ID.
• El estado no se actualiza en la propuesta: DocuSign Connect no está llegando O la firma HMAC no coincide. En Admin → Connect, confirma la configuración apuntando a la "URL del webhook (DocuSign Connect)", con los eventos de envelope y con el HMAC activado usando la MISMA clave pegada en el CRM.
• Webhook rechazado (firma inválida / sin clave HMAC): por seguridad, el CRM solo acepta webhooks firmados. Si la Clave HMAC de Connect no está completada en el CRM, o difiere de la que usa DocuSign, los eventos se rechazan. Alinea la misma clave en ambos lados y reactiva el HMAC en Connect.
• No aparece el botón / no ocurre nada: la integración está inerte por falta de credenciales o no se activó. Completa los campos y haz clic en Activar.
• 404 en la URL de Connect: la integración se desactivó o el token de la URL cambió; reactiva y reconfigura la URL en DocuSign.

Abrir este artículo dentro del sistema →