Aller au contenu principal

FAQ

Envoi​

L'envoi échoue avec « recipient email must belong to your organization »​

Vous êtes en sandbox Yousign : les e-mails des signataires doivent appartenir à votre organisation Yousign. Testez avec des e-mails internes, ou passez en production — la restriction n'y existe pas.

Yousign rejette le numéro de téléphone​

Yousign exige le format international E.164 (+33612345678). TrueSign normalise automatiquement les formats courants — mais un numéro trop court ou invalide est refusé. Le téléphone n'est requis que si l'authentification SMS est activée pour ce signataire.

Mon template n'apparaît pas dans le sélecteur​

Trois causes, dans l'ordre : le template est inactif ou en brouillon ; il est associé à un autre objet que celui de l'enregistrement courant ; vous n'avez pas le permission set requis. Voir Créer un template.

Aucun document proposé dans le formulaire d'envoi​

En envoi libre, seuls les PDF attachés à l'enregistrement (section Fichiers) sont proposés. Chargez le PDF d'abord.

L'envoi en masse indique des erreurs​

Ouvrez TrueSign Jobs : chaque lot trace ses erreurs par enregistrement, avec le détail Yousign. Cause la plus fréquente en sandbox : e-mails hors organisation Yousign.

Statuts & webhook​

Le statut ne se met pas à jour​

  1. Cliquez Actualiser sur la demande — si le statut se corrige, le problème vient du webhook.
  2. Regardez la carte Webhook intake de l'écran Settings : elle liste chaque événement reçu. Vide alors que des signatures ont eu lieu ? Les livraisons n'arrivent pas (voir question suivante). Des événements présents mais rejetés ? Le secret HMAC n'est pas synchronisé — relancez Provision webhook (production) ou recollez le secret (sandbox).
  3. Consultez les logs : une notification rejetée pour signature invalide y apparaît explicitement.

Le webhook n'est pas reçu du tout​

  1. Vérifiez que le Site Salesforce est actif et que le Guest User a l'accès à la classe du webhook (Public Access Settings).
  2. En production, relancez Provision webhook — l'opération est idempotente et resynchronise l'URL et le secret.
  3. Piège sandbox : après une série de notifications rejetées (secret désynchronisé → 401), Yousign suspend silencieusement les livraisons sans changer l'état affiché du webhook. Réarmez-le depuis le dashboard Yousign, puis revérifiez la carte Webhook intake.

Le bouton « Download signed » n'apparaît pas​

Il n'apparaît que lorsque le PDF signé existe — demande en statut Done. Voir Télécharger le document signé.

Configuration​

« Test Connection » échoue​

Vérifiez : la clé API (recollez-la — elle n'est visible qu'une fois côté Yousign), la cohérence environnement ↔ clé (une clé sandbox ne fonctionne pas en production), et le Remote Site Setting correspondant à l'environnement.

Renvoyer affiche « ce signataire a déjà signé »​

C'est le comportement attendu : on ne renvoie une invitation qu'aux signataires en attente. Toute autre erreur affiche le détail exact renvoyé par Yousign.

Comment couper l'intégration en urgence ?​

Le kill-switch, dans Settings → Governance. Réversible, sans perte de données.

Pas de réponse ici ? Direction le support — pensez à joindre le numéro de la demande (SIG-…) et l'extrait de log correspondant.