TrueSign Connect — Writeback
Le writeback ramène dans Salesforce ce que le signataire a saisi dans le document : classification fiscale, numéro de bon de commande, consentement, IBAN… La donnée collectée à la signature atterrit directement dans vos champs, sans ressaisie.
Il se déclenche à la complétion de l'enveloppe, jamais avant : une réponse que le signataire suivant peut encore modifier n'est pas une réponse.
Il existe deux niveaux.
1. Writeback simple — le même champ, aller et retour
Sur une ligne de champ de fusion, cochez « Writeback vers Salesforce ». La valeur saisie repart dans le champ d'où elle venait, sur l'enregistrement source. Rien d'autre à configurer : la ligne connaît déjà les deux bouts.
Sans effet sur un champ en lecture seule — un champ que le signataire ne peut pas modifier n'a rien à rapporter.
C'est le cas le plus fréquent, et le plus sûr : il n'y a pas deux listes à faire coïncider à la main.
2. Writeback avancé — un champ différent, un autre objet
L'onglet Writeback envoie un champ du document ailleurs :
| Réglage | Rôle |
|---|---|
| Champ du document | Le libellé du champ à récupérer — choisi dans la liste des champs déclarés au-dessus, jamais saisi au clavier |
| Champ Salesforce | La destination, choisie dans une liste (seuls les champs modifiables sont proposés) |
| Objet cible | L'enregistrement source, le Contact lié, ou un objet personnalisé |
| Transformation | Majuscules, Minuscules, Booléen, ou aucune |
| Déclencheur | À la complétion de l'enveloppe, ou dès qu'un signataire a signé |
Une ligne enregistrée sans avoir sélectionné de déclencheur ne se déclenchera jamais.
3. Conversion des valeurs
Un document rend du texte ; un champ Salesforce attend son propre type. La conversion est automatique : cases à cocher (true, oui, 1…), montants (les espaces et le € sont retirés), entiers, et dates aux formats jj/mm/aaaa et aaaa-mm-jj.
4. Savoir ce qui s'est passé
Chaque writeback laisse une trace dans le journal d'audit de la demande :
WRITEBACK— le nombre d'enregistrements mis à jour ;WRITEBACK_FAILED— ce qui a été refusé, et pourquoi.
Un mapping mal réglé n'empêche jamais les autres d'aboutir : chaque enregistrement est traité indépendamment. Une configuration invalide est d'ailleurs refusée dès l'enregistrement du template (champ inexistant, non modifiable, writeback sur un champ en lecture seule, libellé dupliqué, placement absent) plutôt que de rester muette jusqu'au jour de la signature.
5. Exemple complet
Un contrat cadre envoyé depuis une Opportunité.
À l'envoi, quatre champs sont pré-remplis :
| Champ du document | Chemin Salesforce | Mode | Résultat |
|---|---|---|---|
| Client | Account.Name | Lecture seule | Nord Industries |
| Secteur | Account.Industry | Saisissable | Manufacturing |
| Montant | Amount | Lecture seule | 24 500,00 € |
| Bon de commande | Description | Saisissable, vide | (à remplir) |
Le signataire corrige le secteur si besoin, saisit son numéro de bon de commande (BC-245556), coche « Dossier confidentiel », signe.
À la complétion, Salesforce est mis à jour :
Opportunity.Description=BC-245556(writeback simple)Account.Industry= la valeur confirmée (writeback simple, chemin parent)Opportunity.IsPrivate=true(case à cocher)Opportunity.NextStep=BC-245556(writeback avancé, transformation Majuscules)
6. Writeback automatique (sans configuration)
Indépendamment des mappings, TrueSign maintient toujours à jour : le statut de la demande et de chaque signataire, la date de signature et le compteur, et le PDF signé attaché à l'enregistrement — voir Télécharger le document signé.
7. Diagnostic
| Symptôme | Cause la plus fréquente |
|---|---|
| Le writeback n'écrit rien | Champ en lecture seule, ou déclencheur non sélectionné (§2) |
| Il écrit sur le mauvais enregistrement | Vérifier l'objet cible : source, Contact lié, ou personnalisé |
| Une date part de travers | Le signataire a saisi un format libre ; seuls jj/mm/aaaa et aaaa-mm-jj sont acceptés |
| Rien ne se passe alors que tout semble bon | Consulter le journal d'audit de la demande : WRITEBACK_FAILED en donne la raison exacte |
Le writeback ne s'exécute que sur un événement authentifié — signature HMAC pour le webhook Yousign, cérémonie interne pour weSign. Une notification forgée ne peut rien écrire dans votre org. Voir Architecture de sécurité.