Digito

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

  1. Accede a Digito Business y selecciona el equipo de la integración.
  2. Abre Configuración del equipo → Webhooks. Según el idioma de la aplicación, verás Team Settings → Webhooks.
  3. Pulsa Crear Webhook (Create Webhook).
  4. Introduce la URL de recepción, por ejemplo https://integracion.example.com/webhooks/digito.
  5. En Desencadenadores, selecciona uno o más eventos. Para archivar documentos al finalizar, comienza con DOCUMENT_COMPLETED.
  6. Configura un secreto y guárdalo también en tu servidor. Aunque el formulario permite omitirlo, tu receptor de producción debe exigirlo.
  7. 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.

ResultadoQué revisar
SUCCESSEl receptor aceptó la entrega. Comprueba también el resultado de tu procesamiento interno.
FAILED con 401El secreto y el nombre de cabecera configurados en el receptor.
FAILED con 400La estructura y el formato que espera tu receptor.
FAILED con 5xxLa disponibilidad del servidor, la cola o la base de datos.
Código 0La conectividad o el rechazo del destino antes de obtener una respuesta HTTP.
Código 3xxLa 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.