Eventos en Tiempo Real
Legalesign puede enviar eventos a tu aplicación en tiempo real — documento firmado, subida completada, envío fallido, y así sucesivamente. Hay dos mecanismos, y puedes usar uno o ambos.
Suscripciones
Las suscripciones de GraphQL abren una conexión WebSocket persistente al endpoint AppSync de Legalesign. Tu cliente recibe eventos a medida que ocurren, sin necesidad de sondeo.
Ideal para:
- Aplicaciones frontend que necesitan actualizaciones instantáneas en la interfaz de usuario
- Seguimiento en tiempo real del progreso de subida o envío
- Cualquier flujo donde ya mantienes una conexión GraphQL
Comienza aquí: Introducción rápida a suscripciones
Guías:
- Conectar a suscripciones de AppSync
- Rastrear tareas de envío
- Rastrear progreso de subida
- Rastrear el ciclo de vida del documento y destinatario
Webhooks
Los webhooks envían un POST HTTP a una URL que configures cada vez que ocurre un evento. No se necesita conexión persistente — tu servidor solo maneja las solicitudes entrantes.
Ideal para:
- Integraciones backend y automatización
- Sistemas detrás de firewalls que pueden recibir HTTP pero no mantener conexiones WebSocket
- Flujos simples de "notifícame cuando esté listo"
Comienza aquí: Webhooks
¿Cuál Debo Usar?
| Suscripciones | Webhooks | |
|---|---|---|
| Conexión | WebSocket persistente | POST HTTP por evento |
| Latencia | Instantáneo | Casi instantáneo |
| Ideal para | Aplicaciones frontend / interactivas | Backend / automatización |
| Autenticación | Token SRP en la conexión | URL configurada + secreto opcional |
| Reintento | El cliente se reconecta | Legalesign reintenta en caso de fallo |
Puedes usar ambos juntos — por ejemplo, suscripciones para actualizar tu interfaz y webhooks para activar flujos backend.