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í
Configurar y probar
Crea una suscripción, selecciona eventos y revisa las entregas y reenvíos.
Eventos y payloads
Consulta los 14 eventos y relaciona cada aviso con el sobre de la API v2.
Autenticación del receptor
Valida el secreto, comprueba el JSON y guarda la entrega antes de responder.
Cómo encaja en tu integración
- Configura una URL HTTPS de tu servidor y selecciona los eventos que necesitas.
- Autentica cada entrega antes de leer o procesar sus datos.
- Guarda el aviso de forma duradera y responde rápidamente.
- 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.