Skip to main content

Webhooks

Autosign notifica vía webhooks a tu sistema el progreso de una transaccion. De esta manera, tu sistema puede recibir información en tiempo real del estado de una transaccion, documentos firmados, etc.

Eventos​

Los eventos que autosign notifica a tu sistema son:

  • transaction_completed: Se dispara cuando todos los destinatarios han completado sus acciones en la transacción
  • transaction_created: Se dispara cuando se ha creado una transacción dentro de la plataforma
  • transaction_started: Se dispara cuando la transacción ha sido iniciada por el remitente
  • transaction_expired: Se dispara cuando la transacción ha expirado
  • transaction_rejected: Se dispara cuando la transacción ha sido rechazada por alguno de los destinatarios
  • recipient_submitted: Se dispara cuando un destinatario ha completado todas sus acciones en la transacción

Cada uno de estos eventos son enviados al endpoint configurado realizando una HTTP REQUEST de tipo POST con información relacionada al evento

Para conocer a detalle cada uno de los eventos, puedes consultar la documentación de eventos y webhooks.

Crear webhooks​

Puedes crear un webhook desde el dashboard. Para ello, sigue los siguientes pasos:

1. Ingresa al dashboard de autosign
2. Dirigite a configuracion
3. Selecciona la opción de webhooks
4. Haz click en el botón de "Crear webhook"
5. Completa la información requerida (nombre, endpoint, eventos a escuchar)

Seguridad​

Par una comunicación mas segura, se recomienda seguir el flujo de HMAC (hash message authorization code).

Cada vez que autosign envía un evento, en la request estará el header autosign-signature que corresponde al HMAC generado mediante el uso de la signature del webhook. De esta manera, en tu aplicación tu puedes generar otro HMAC mediante el body de la request y la private signature del webhook para comparar el HMAC generado por ti con el que se encuentra en la request.

Si los dos HMAC coinciden, quiere decir que quien esta realizando la request a tu sistema es efectivamente autosign.

WEBHOOK SIGNATURE

El webhook signature lo puedes encontrar en el dashboard dentro del detalle de tu webhook. Puedes generar nuevos tantas veces lo necesites.

Lógica de reintentos​

En el ciclo de vida de una aplicación, el posible downtime forma parte de la misma. Es por ello, que hay eventos que son resilientes a cierta cantidad de fallos y siguen una lógica de reintentos.

Estos eventos son:

  • image_processed
  • extra_image_processed
  • inspection_completed

Si al primer intento de enviar la notificación, la integración no responde con un status 2XX, se reintentará enviar en los próximos 30 minutos con dos repeticiones.