API DocuSign : Comment configurer les "Rappels" et les "Expirations" via JSON ?

Comprendre l'API DocuSign pour la gestion des enveloppes

Dans le paysage concurrentiel des solutions de signature électronique, l'API de DocuSign reste une pierre angulaire pour les développeurs qui souhaitent intégrer des flux de travail automatisés dans les processus métier. À mesure que les entreprises étendent leurs opérations numériques, les fonctionnalités de rappel et d'expiration jouent un rôle essentiel pour garantir la finalisation des documents en temps voulu sans supervision manuelle. Cet article explore comment configurer ces paramètres dans l'API DocuSign via JSON, en s'appuyant sur la documentation officielle et des informations pratiques sur la mise en œuvre. D'un point de vue commercial, la maîtrise de ces éléments d'API peut rationaliser les cycles de contrats, réduire la charge administrative et améliorer la conformité dans les environnements à volume élevé.

Vous comparez des plateformes de signature électronique similaires à DocuSign ou Adobe Sign ?

eSignGlobal offre une solution de signature électronique plus flexible et plus rentable, avec une conformité mondiale, une tarification transparente et un processus d'intégration plus rapide.

👉 Démarrez un essai gratuit

Configuration des rappels et des expirations dans l'API DocuSign : Guide étape par étape

L'API eSignature de DocuSign permet aux développeurs d'intégrer des règles de rappel et d'expiration directement dans les demandes de création d'enveloppes. Ces fonctionnalités sont essentielles pour l'automatisation des activités, car elles automatisent le suivi et empêchent les documents de rester en suspens indéfiniment, ce qui pourrait monopoliser les ressources des équipes de vente, des RH ou juridiques. Les rappels notifient les signataires à intervalles définis si un document n'est pas signé, tandis que les expirations invalident l'enveloppe après une période spécifiée, garantissant ainsi l'efficacité du flux de travail.

Prérequis pour l'intégration de l'API

Avant de plonger dans la charge utile JSON, assurez-vous d'avoir :

• Un compte développeur DocuSign avec accès à l'API (disponible via le centre de développement).
• Une authentification configurée à l'aide d'OAuth 2.0 ou JWT pour des appels API sécurisés.
• Une connaissance de l'endpoint Envelopes: create (POST /accounts/{accountId}/envelopes).

L'API utilise des endpoints RESTful, et toute la configuration est transmise via le corps JSON de la requête. L'utilisation de l'API est soumise à la tarification du plan développeur de DocuSign, qui commence à partir d'un niveau d'entrée de 600 $/an, comprenant un quota d'enveloppes de base adapté aux tests initiaux.

Configuration des rappels via JSON

Les rappels sont définis dans l'objet reminders au sein de la définition de l'enveloppe. Cet objet spécifie la fréquence, le délai avant le premier rappel et le nombre de tentatives. Les entreprises utilisent fréquemment cette fonctionnalité pour inciter les signataires dans des scénarios tels que les contrats clients ou l'intégration des employés, réduisant ainsi les taux d'abandon.

Voici un extrait JSON d'une demande de création d'enveloppe :

{
  "status": "sent",
  "emailSubject": "Veuillez signer ce document",
  "documents": [
    {
      "documentBase64": "BASE64_ENCODED_DOCUMENT_CONTENT",
      "name": "Exemple d'accord",
      "fileExtension": "pdf",
      "documentId": "1"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "John Doe",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ]
  },
  "reminders": {
    "reminderDelay": 2,  // Jours avant le premier rappel (par exemple, 2 jours après l'envoi)
    "reminderFrequency": "daily",  // Options : daily, weekly, monthly
    "reminderOffset": 1,  // Nombre de jours entre les rappels
    "reminderMaxAttempts": 5  // Nombre total de rappels envoyés (par exemple, 5 tentatives)
  }
}

• reminderDelay : Définit la période d'attente initiale en jours. Une valeur de 1 à 3 jours est courante pour les transactions urgentes.
• reminderFrequency : Dicte l'intervalle - quotidien pour les éléments urgents, hebdomadaire pour les contrats standard.
• reminderOffset : L'intervalle entre les rappels, aligné sur le rythme de l'entreprise.
• reminderMaxAttempts : Limite le nombre total pour éviter le spam ; DocuSign recommande 3 à 7 tentatives en fonction du volume d'enveloppes.

Pour la mise en œuvre, envoyez ce JSON via une requête POST à l'API Envelopes. Par exemple, en utilisant cURL :

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-d '@envelope.json'

En pratique, les entreprises disposant de plans API avancés (5760 $/an) bénéficient de quotas plus élevés, ce qui permet une logique de rappel robuste dans les envois en masse. Les tests dans un environnement sandbox garantissent que la configuration est conforme aux exigences de conformité, telles que les pistes d'audit dans les secteurs réglementés.

Mise en œuvre des expirations via JSON

Les expirations rejettent automatiquement les enveloppes non signées après une date limite, libérant ainsi le quota d'API et évitant le gaspillage de ressources. Ceci est particulièrement précieux dans les pipelines de vente à grande vitesse où les documents pourraient autrement rester bloqués.

Les paramètres expireAfter et expireNotify sont imbriqués sous les propriétés de niveau supérieur de l'enveloppe ou dans la configuration de destinataires spécifiques pour un contrôle précis.

Exemple JSON d'expiration :

{
  "status": "sent",
  "emailSubject": "Action requise : Examiner et signer",
  "documents": [
    // ... (identique à ci-dessus)
  ],
  "recipients": {
    "signers": [
      // ... (identique à ci-dessus)
    ]
  },
  "expireAfter": "30",  // Jours jusqu'à l'expiration (par exemple, 30 jours à compter de la date d'envoi)
  "expireNotify": true  // Indique s'il faut envoyer un e-mail à l'expéditeur lors de l'expiration (true/false)
}

• expireAfter : Spécifié en jours (1-9999). Les entreprises définissent des périodes plus courtes (7-14 jours) pour les accords urgents afin de maintenir l'élan.
• expireNotify : Par défaut sur false ; l'activer alerte l'expéditeur pour les actions de suivi, s'intégrant de manière transparente aux systèmes CRM.

Pour les expirations au niveau du destinataire (utile dans les flux de travail à plusieurs signataires), imbriquez-les dans l'objet signataire :

"signers": [
  {
    "email": "signer@example.com",
    "name": "John Doe",
    "recipientId": "1",
    "routingOrder": "1",
    "expireAfter": "15",  // Expiration par signataire
    "expireNotify": "1"  // Notifier l'expéditeur (1 = oui, 0 = non)
  }
]

La combinaison des rappels et des expirations peut créer une stratégie complète de gestion du cycle de vie. Par exemple, une expiration de 30 jours associée à des rappels quotidiens après 5 jours peut augmenter les taux d'achèvement de 20 à 30 % par rapport aux références du secteur. Notez que ces paramètres consomment le quota d'enveloppes - les plans standard sont limités à ~100 enveloppes/utilisateur/an, de sorte que les utilisateurs API de niveau intermédiaire (3600 $/an) gagnent en flexibilité pour les flux de travail automatisés.

Bonnes pratiques et pièges courants

D'un point de vue commercial, une configuration excessive des rappels peut entraîner des frais SMS/supplémentaires (facturés par message), tandis que des expirations laxistes monopolisent les sièges dans les modèles de tarification basés sur les sièges. Validez toujours le JSON par rapport au schéma de l'API à l'aide de la documentation Swagger de DocuSign. Les pièges incluent les incompatibilités de fuseaux horaires - les équipes mondiales utilisent UTC - et l'ignorance des motifs de refus, qui peuvent être personnalisés pour une meilleure analyse.

Dans la région Asie-Pacifique, la latence et la conformité ajoutent de la complexité, et les intégrations API doivent tenir compte des fonctionnalités supplémentaires régionales telles que la livraison de SMS, ce qui peut augmenter les coûts. Il est conseillé de tester avec des charges utiles d'échantillon dans le sandbox DocuSign avant le déploiement en production.

Cette fonctionnalité API met en évidence la force de DocuSign en matière d'outils conviviaux pour les développeurs, bien que les entreprises doivent évaluer le coût total, y compris les plafonds d'automatisation (~10/utilisateur/mois).

Paysage concurrentiel : Comparaison des plateformes de signature électronique

Alors que la signature électronique devient essentielle à la transformation numérique, la comparaison de DocuSign avec des alternatives telles qu'Adobe Sign, eSignGlobal et HelloSign (maintenant Dropbox Sign) révèle des forces distinctes. DocuSign excelle dans la robustesse de l'API mondiale, mais sa scalabilité des prix est soumise à un examen minutieux, en particulier pour les utilisateurs intensifs de l'API. Adobe Sign s'intègre profondément à l'écosystème Adobe, adapté aux flux de travail créatifs. eSignGlobal cible la conformité localisée dans la région Asie-Pacifique, tandis que HelloSign offre la simplicité pour les PME.

Aperçu des principaux acteurs

DocuSign : Leader du marché avec des capacités API complètes, y compris les rappels et les expirations mentionnés ci-dessus. Sa force réside dans la sécurité et l'intégration de niveau entreprise, mais la tarification basée sur les sièges peut être un frein pour la mise à l'échelle des équipes. La plateforme prend en charge les enveloppes illimitées à des niveaux supérieurs, bien que les envois automatisés soient limités.

Adobe Sign : La solution d'Adobe met l'accent sur l'intégration transparente avec les outils PDF et Acrobat, adaptée aux secteurs à forte intensité documentaire. Elle offre des contrôles API similaires pour les rappels (via les paramètres de "notification") et les expirations (jusqu'à 999 jours), les charges utiles JSON reflétant la structure de DocuSign. La tarification commence à 10 $/utilisateur/mois pour les particuliers, évoluant vers des devis personnalisés pour les entreprises. Elle est particulièrement robuste en matière de conformité aux États-Unis, mais l'utilisation avancée de l'API peut entraîner des frais supplémentaires.

eSignGlobal : Ce fournisseur axé sur la région Asie-Pacifique prend en charge la conformité dans 100 pays et territoires mondiaux courants, avec un avantage distinct dans la région Asie-Pacifique. Le paysage de la signature électronique dans cette région est fragmenté, avec des normes élevées et des réglementations strictes - contrastant avec les cadres ESIGN/eIDAS de style américain/UE. L'Asie-Pacifique exige une approche d'"intégration de l'écosystème", nécessitant une intégration profonde au niveau du matériel/API avec les identités numériques gouvernementales (G2B), bien au-delà des modèles de vérification par e-mail ou d'auto-déclaration courants en Occident. eSignGlobal est en concurrence directe avec DocuSign et Adobe Sign à l'échelle mondiale, y compris en Amérique et en Europe, grâce à des plans rentables. Sa version Essential, à seulement 16,6 $/mois (annuel), permet jusqu'à 100 signatures de documents, des sièges d'utilisateurs illimités et la vérification du code d'accès - le tout sur une base de conformité et de haute valeur. Elle s'intègre de manière transparente à iAM Smart à Hong Kong et à Singpass à Singapour, résolvant ainsi les problèmes régionaux tels que la résidence des données et la latence.

HelloSign (Dropbox Sign) : Acquis par Dropbox, il privilégie une interface conviviale et une synergie de stockage de fichiers. L'API prend en charge les rappels et les expirations via JSON, avec des quotas plus simples (par exemple, 20 enveloppes/mois au niveau gratuit). La tarification commence à 15 $/mois pour Essentials, attirant les petites équipes, mais la scalabilité pour les besoins API des entreprises est moins bonne que celle de DocuSign.

Vous recherchez une alternative plus intelligente à DocuSign ?

eSignGlobal offre une solution de signature électronique plus flexible et plus rentable, avec une conformité mondiale, une tarification transparente et un processus d'intégration plus rapide.

👉 Démarrez un essai gratuit

Tableau comparatif Markdown

Ce tableau met en évidence les compromis neutres : DocuSign pour la profondeur, Adobe pour l'intégration, eSignGlobal pour la valeur régionale et HelloSign pour l'accessibilité.

Réflexions finales sur le choix de la signature électronique

En conclusion, la configuration des rappels et des expirations dans l'API de DocuSign via JSON peut rationaliser les opérations commerciales, mais le choix de la bonne plateforme dépend de l'échelle, de la région et du budget. Pour ceux qui recherchent des alternatives à DocuSign, eSignGlobal se distingue par sa conformité régionale et sa forte présence mondiale.