Digito

Webhooks

Recibe notificaciones de documentos, destinatarios y plantillas en tu servidor.

Los webhooks permiten sincronizar Digito Business con tu aplicación cuando cambia un documento o una plantilla. Digito envía una solicitud HTTP POST con JSON a la URL que configures para tu equipo. Tu servidor recibe el aviso y responde con un código 2xx para confirmar la recepción.

Puedes usarlos para actualizar el estado de un contrato en tu CRM, avisar de un rechazo o iniciar el archivo del resultado de un proceso completado.

Empieza por aquí

Cómo encaja en tu integración

  1. Configura una URL HTTPS de tu servidor y selecciona los eventos que necesitas.
  2. Autentica cada entrega antes de leer o procesar sus datos.
  3. Guarda el aviso de forma duradera y responde rápidamente.
  4. Procesa el trabajo en segundo plano y consulta el sobre por API para obtener su estado actual.

Para saber que un proceso terminó, suscríbete a DOCUMENT_COMPLETED. DOCUMENT_SIGNED corresponde a la firma de una persona y puede llegar cuando todavía faltan otras acciones.

El aviso y el estado actual cumplen funciones distintas

Un webhook describe un evento; no sustituye la consulta del recurso. Usa payload.envelopeId para recuperar el sobre desde tu servidor y confirma COMPLETED antes de descargar y archivar los PDFs finales. Un reenvío puede describir un estado anterior al actual.

Los webhooks se configuran por equipo. Revisa acceso por equipo y disponibilidad de la integración por plan. Una clave de API sirve para las consultas que hace tu servidor; el secreto del webhook autentica las notificaciones que recibe.

El firmante se autentica de nuevo con Digito ID antes de cada acción de firma. Un webhook o una clave de API no sustituye esa autenticación ni autoriza a tu aplicación a firmar por él.

Seguimiento del proceso · Auditoría y evidencia.