Configurar y probar
Crea webhooks en tu equipo, prueba el receptor y consulta los registros de entrega.
Necesitas acceso a la configuración del equipo de Digito Business y una URL pública de tu servidor que acepte solicitudes POST con Content-Type: application/json. Utiliza HTTPS en producción y configura primero la autenticación del receptor.
Crea una suscripción
- Accede a Digito Business y selecciona el equipo de la integración.
- Abre Configuración del equipo → Webhooks. Según el idioma de la aplicación, verás Team Settings → Webhooks.
- Pulsa Crear Webhook (Create Webhook).
- Introduce la URL de recepción, por ejemplo
https://integracion.example.com/webhooks/digito. - En Desencadenadores, selecciona uno o más eventos. Para archivar documentos al finalizar, comienza con
DOCUMENT_COMPLETED. - Configura un secreto y guárdalo también en tu servidor. Aunque el formulario permite omitirlo, tu receptor de producción debe exigirlo.
- Activa Habilitado y pulsa Crear.
Las direcciones privadas o de loopback no sirven como destino público de entrega. No incluyas claves de API, secretos ni tokens de destinatario en la URL.
Envía una prueba
Abre el detalle de la suscripción y utiliza Probar (Test). En Prueba de Webhook, selecciona Tipo de evento y pulsa Enviar. En tu receptor, comprueba que la autenticación funciona y que el JSON se almacena antes de responder.
Los datos de prueba son sintéticos: un aviso de prueba DOCUMENT_COMPLETED no demuestra que exista un documento real completado. Usa un entorno de pruebas y evita activar acciones sobre clientes o documentos reales.
Revisa las entregas
El detalle del webhook muestra el resultado de las llamadas, el evento, la fecha y el código HTTP. Al abrir una llamada puedes consultar su cuerpo de solicitud, respuesta y cabeceras de respuesta.
| Resultado | Qué revisar |
|---|---|
SUCCESS | El receptor aceptó la entrega. Comprueba también el resultado de tu procesamiento interno. |
FAILED con 401 | El secreto y el nombre de cabecera configurados en el receptor. |
FAILED con 400 | La estructura y el formato que espera tu receptor. |
FAILED con 5xx | La disponibilidad del servidor, la cola o la base de datos. |
Código 0 | La conectividad o el rechazo del destino antes de obtener una respuesta HTTP. |
Código 3xx | La URL devuelve una redirección; configura directamente el destino final. |
Protege también los registros: el cuerpo de una entrega puede contener datos personales y tokens. No copies el JSON completo a herramientas de analítica ni a registros abiertos.
Responde y recupera los fallos
Devuelve un código 2xx antes de 10 segundos. Guarda el evento en una bandeja de entrada o cola duradera y deja el trabajo costoso para un proceso separado. No respondas con éxito antes de guardar el aviso: si el proceso se interrumpe después, podrías perderlo.
Una respuesta distinta de 2xx, un timeout o un fallo de red hace fallar la entrega. No se siguen redirecciones. Los reintentos automáticos dependen de la configuración del servicio; no bases tu lógica en un número fijo de intentos o un intervalo determinado.
Para recuperar una llamada fallida, abre su detalle y utiliza Reenviar (Resend). El receptor debe soportar entregas repetidas sin duplicar tareas. Una entrega fallida no deshabilita automáticamente la suscripción: sigue supervisando los avisos posteriores.
Si tu aplicación necesita reconciliar información que no recibió, consulta el estado de los sobres mediante la API y revisa su historial de auditoría.