Développement & intégration API

Envoyer les e-mails via son serveur de messagerie

Dans cette article, nous allons aborder ensemble comment envoyer les e-mails de notification avec votre propre serveur de messagerie.

Nous avons vu précédemment comment gérer les notifications de relance et dans ce cas c'est bien l'infrastructure Yousign qui est chargée d'envoyer les e-mails aux différents destinataires.

Voyons maintenant comment envoyer ces e-mails depuis votre serveur.

Etape n°1 : Créer la procédure de signature sans configuration e-mail

Pour commencer, il convient d'envoyer un fichier PDF à Yousign puis de supprimer l'ensemble de la configuration (partie "config") de votre création de la procédure de signature. Nous allons donc garder une configuration totalement vierge pour commencer.

Voici un exemple :

{
    "name": "Test d'envoi des e-mails depuis mon serveur de messagerie",
    "description": "Cette procédure a été créée pour la démo du Centre d'aide Yousign",
    "template": false,
    "ordered": false,
    "metadata": {
        "type": "test"
    },
    "config": {},
    "members": [
        {
            "type": "signer",
            "firstname": "Romain",
            "lastname": "Pichard",
            "email": "support@yousign.fr",
            "phone": "+33612345678",
            "position": 0,
            "fileObjects": [
                {
                    "file": "/files/12f61fc8-4455-4cbb-85be-43cd1076be79",
                    "page": 2,
                    "position": "188,493,501,603",
                    "mention": "Lu et approuvé",
                    "mention2 (internal)": "Signé par Romain de Yousign"
                }
            ]
        }
    ],
    "start": true,
    "relatedFilesEnable": false,
    "archive": false
}

 

Etape n°2 : Reconstituer le lien d'accès à la procédure

Généralement, le premier e-mail qui est envoyé permet d'inviter le membre de la procédure à signer ou valider les documents. Pour cela, vous devez donc reconstituer le lien permettant d'accéder à la procédure pour le membre en question.

Une fois votre POST /procedures effectué, vous allez recevoir un identifiant pour chaque membre de la procédure :

yousign_id_member_procedure_signature.png

Le lien d'accès à la procédure sera formaté à partir de cet identifiant, de la façon suivante :

https://webapp.yousign.com/#!/procedure/sign?members=/members/[ID_MEMBER]

[ID_MEMBER] devra donc être remplacé par l'identifiant du membre retourné par la réponse de l'API Yousign (encadré en rouge sur la capture d'écran ci-dessus).

Etape n°3 : Formater et envoyer les e-mails depuis votre serveur de messagerie

Voici les principales raisons poussant à vouloir envoyer les e-mails depuis son propre serveur de messagerie :

  • Meilleure personnalisation du contenu de l'e-mail (respect de la charte graphique, ajout de couleurs, ajout d'une signature en bas de l'e-mail, ajout d'images...).
  • L'adresse e-mail d'envoi ne sera pas une adresse e-mail Yousign (en @yousign.fr) mais bien l'adresse de votre choix (en @votre-societe.fr).
  • Maîtrise totale sur les règles de sécurité et liées au spams notamment
  • Maîtrise totale sur les envois effectués (mise en place de logs, taux d'ouverture, etc...).

Pour bénéficier de ces avantages, vous devez donc déclencher l'envoi des e-mails depuis votre code source aux moments souhaités. Ce mécanisme étant spécifique en fonction du langage utilisé  pour votre développement mais aussi en fonction de la solution retenue pour envoyer les e-mails (infrastructure propre ou solution en ligne d'envoi d'e-mails), il ne sera pas plus détaillé dans cet article.

Il est tout à fait possible de n'envoyer aucun e-mail via Yousign mais vous avez également la liberté d'envoyer une partie des e-mails via votre solution interne et d'autres par l'intermédiaire de Yousign.

 

 

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0