Jobs & synchronisation
TrueSign traite en arrière-plan tout ce qui dépasse une transaction Salesforce : envois en masse, traitements de webhook, purges. Chaque opération asynchrone est tracée — rien ne se perd silencieusement.
Le journal des jobs
L'onglet TrueSign Logs de l'app expose la vue Jobs : chaque job avec son statut (En cours / Terminé / Erreur), dates de début et de fin, nombre d'enregistrements traités, nombre d'erreurs et message d'erreur détaillé.
Cliquez un job pour le détail — c'est le premier réflexe quand un envoi en masse semble incomplet.
Ce qui tourne en asynchrone
| Traitement | Déclencheur | Particularités |
|---|---|---|
| Envoi en masse | Bulk Send utilisateur | Lots de 5 enregistrements max par transaction (limite de gouverneur : 5 appels sortants) ; création Yousign + upload PDF + signataires + activation par enveloppe |
| Traitement webhook | Notification Yousign | Mise à jour des statuts, récupération du PDF signé, writeback |
| Purge des logs | Batch quotidien | Selon la rétention configurée |
Les 5 jobs de maintenance
Ils sont planifiés automatiquement à l'installation du package — promesse « zéro config » :
| Job | Heure | Rôle |
|---|---|---|
| Status Sync | 02:00 | Resynchronisation de rattrapage des statuts |
| Approval Reminders | 02:30 | Rappels et escalades du circuit d'approbation |
| weSign Lifecycle | 02:45 | Relances, expirations et alertes des enveloppes weSign |
| Log Cleanup | 03:00 | Purge des logs selon la rétention |
| Job Cleanup | 03:15 | Purge des enregistrements de jobs archivés |
La carte de santé de l'écran Setup affiche « Jobs de maintenance : N/5 planifiés » ; s'il en manque (job supprimé par erreur, migration d'org), le bouton Planifier maintenant les réarme — l'opération est idempotente.
Synchronisation des statuts
Deux mécanismes complémentaires :
- Webhook (temps réel) — Yousign notifie Salesforce à chaque événement ; c'est le mode nominal, configuré au setup.
- Actualisation manuelle — le bouton Actualiser d'une demande interroge Yousign à la demande ; il rattrape n'importe quelle notification manquée (statuts et document signé).
Rétention
Les jobs terminés sont archivés après 90 jours ; les jobs en erreur sont conservés 365 jours pour l'analyse.
- Ouvrez la vue Jobs → trouvez le job du bulk (statut, erreurs).
- Le compteur « erreurs » est non nul ? Le message détaille la cause par enregistrement (ex. e-mail hors organisation Yousign en sandbox).
- Croisez avec les logs d'appels API pour le détail requête/réponse.