Eventos en Tiempo Real
Legalesign puede enviar eventos a tu aplicación en tiempo real — documento firmado, carga completada, envío fallido, y más. Hay dos mecanismos, y puedes usar uno o ambos.
Suscripciones
Las suscripciones 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 de la interfaz de usuario
- Seguimiento en tiempo real del progreso de carga o envío
- Cualquier flujo donde ya mantienes una conexión GraphQL
Comienza aquí: Subscriptions Quickstart
Guías:
- Conectar a Suscripciones AppSync
- Rastrear Tareas de Envío
- Rastrear Progreso de Carga
- Rastrear Ciclo de Vida de 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 "avísame cuando termine"
Comienza aquí: Webhooks
¿Cuál Debo Usar?
| Suscripciones | Webhooks | |
|---|---|---|
| Conexión | WebSocket persistente | POST HTTP por evento |
| Latencia | Instantánea | Casi instantánea |
| Ideal para | Apps frontend / interactivas | Backend / automatización |
| Autenticación | Token de acceso en la conexión | URL configurada + secreto opcional |
| Reintentos | Reconexión del cliente | Reintentos de Legalesign en fallo |
Puedes usar ambos juntos — por ejemplo, suscripciones para actualizar la UI y webhooks para activar flujos backend.