Événements en temps réel
Legalesign peut envoyer des événements à votre application en temps réel — document signé, téléchargement terminé, envoi échoué, etc. Il existe deux mécanismes, et vous pouvez utiliser l’un ou les deux.
Abonnements
Les abonnements GraphQL ouvrent une connexion WebSocket persistante vers le point de terminaison AppSync de Legalesign. Votre client reçoit les événements au fur et à mesure, sans avoir à faire de sondage.
Idéal pour :
- Applications frontend qui nécessitent des mises à jour instantanées de l’interface utilisateur
- Suivre la progression des téléchargements ou des envois en temps réel
- Tout flux où vous maintenez déjà une connexion GraphQL
Pour commencer : Démarrage rapide des abonnements
Guides :
- Se connecter aux abonnements AppSync
- Suivre les tâches d’envoi
- Suivre la progression des téléchargements
- Suivre le cycle de vie des documents et des destinataires
Webhooks
Les webhooks envoient une requête HTTP POST à une URL que vous configurez dès qu’un événement survient. Aucune connexion persistante n’est nécessaire — votre serveur traite simplement les requêtes entrantes.
Idéal pour :
- Intégrations backend et automatisation
- Systèmes derrière des pare-feux pouvant recevoir des requêtes HTTP mais pas tenir de connexions WebSocket
- Flux simples "prévenez-moi quand c’est terminé"
Pour commencer : Webhooks
Lequel devrais-je utiliser ?
| Abonnements | Webhooks | |
|---|---|---|
| Connexion | WebSocket persistante | HTTP POST par événement |
| Latence | Instantanée | Presque instantanée |
| Idéal pour | Applications frontend / interactives | Backend / automatisation |
| Auth | Jeton d’accès à la connexion | URL configurée + secret optionnel |
| Réessai | Reconnexion client | Réessais par Legalesign en cas d’échec |
Vous pouvez utiliser les deux ensemble — par exemple, abonnements pour mettre à jour votre interface utilisateur et webhooks pour déclencher des flux backend.