Webhooks
Los webhooks te permiten recibir notificaciones en tiempo real sobre eventos en tu cuenta de Signatura. Por ejemplo, puedes configurar un webhook para recibir una notificación cada vez que un firmante haya firmado un documento.
De esta manera, no es necesario que estés consultando periódicamente el estado de los documento pendientes. Ten en cuenta que los firmantes pueden demorarse horas o incluso días en firmar un documento, o quizás abandonan el proceso. Si el conjunto de documentos pendientes crece sin límites, consumirás recursos innecesarios en tu aplicación y es posible que excedas los límites de la API de Signatura.
Para configurar un webhook, debes dirigirte a la sección de Webhooks de la Configuración de Cuenta. Puedes acceder a la configuración desde el menú de usuario ubicado en la esquina superior derecha. Asegurate de que la URL sea accesible, no esté protegida por un firewall y que responda con un código de estado 200.
Los webhooks de Signatura son enviados con el método POST y tienen un cuerpo en formato JSON. Consulta la referencia de la API para obtener más información sobre los eventos que puedes recibir.
Timeouts
Los webhooks de Signatura tienen un timeout de 5 segundos. Si tu servidor no responde con un código de estado 200 dentro de este tiempo, Signatura considerará que la notificación no fue entregada y reintentará el envío.
Política de reintentos
Los webhooks de Signatura siguen una política de reintentos en caso de que la URL de tu webhook no responda con un código de estado 200. La cantidad de reintentos está limitada y se realiza con un retraso exponencial. Si la URL de tu webhook no responde con un código de estado 200 después de varios reintentos, Signatura dejará de enviar notificaciones a esa URL.
Recuerda que los eventos pueden llegar en un orden diferente al que fueron generados. Asegúrate de que tu aplicación esté preparada para manejar eventos duplicados y fuera de orden.
IPs de origen
Los webhooks de Signatura son enviados desde las siguientes direcciones IP:
- 3.229.233.201
- 54.75.193.230
Estas direcciones IP pueden cambiar en el futuro. Si tu implementación está detrás de un firewall, asegúrate de permitir el tráfico de estas direcciones IP y comunicarnos esto para que nos aseguremos de notificarte en caso de cambios.