Cycle de vie d'un message
Ce qui se passe de l'envoi à la fin de vie d'un message : lien, ouvertures, avis, expiration et suppression.
Les étapes
| Étape | Ce qui se passe |
|---|---|
| 1. Envoi | Le SDK chiffre le corps et les fichiers dans votre application, puis les dépose chez Secure Exchanges. Chaque destinataire reçoit son propre lien et son propre numéro de suivi. |
| 2. Remise | Avec getBackHtml à false, Secure Exchanges envoie le courriel (ou le SMS). À true, le SDK vous renvoie le courriel en HTML : c'est votre application qui doit l'envoyer, sinon le destinataire ne reçoit rien. |
| 3. Ouverture | Le destinataire ouvre le lien, avec le mot de passe ou le code d'ouverture s'il y en a un. Chaque ouverture consomme une des ouvertures permises, y compris une lecture par le SDK. |
| 4. Avis | Avec getNotify à true, le titulaire de la licence reçoit un courriel quand le message est ouvert : voir Le courriel d'avis. |
| 5. Suivi | Les journaux indiquent, pour chaque destinataire, les ouvertures, les téléchargements et la signature. |
| 6. Fin de vie | Le message expire au bout de la durée choisie, quand ses ouvertures sont épuisées, ou quand vous le supprimez : voir Fin de vie. |
Les paramètres qui gouvernent la vie d'un message
| Paramètre | Rôle | Valeur par défaut |
|---|---|---|
minutesExpiration |
Durée de vie du message, en minutes. | 10080, soit 7 jours, en Python et en PHP ; obligatoire en .NET. |
maximumOpenTime |
Nombre d'ouvertures permises, de 1 à 99. | 1 en Python et en PHP ; obligatoire en .NET. |
getNotify |
Avis par courriel au titulaire du compte à l'ouverture. | true en Python et en PHP ; obligatoire en .NET. |
getBackHtml |
Qui envoie le courriel : Secure Exchanges (false) ou votre application (true). | true en Python et en PHP ; obligatoire en .NET. |
La durée maximale dépend de votre licence : voir MaxMinMsgRetention dans Licence et quotas.
Ce que l'envoi vous retourne
Pour chaque destinataire :
| Élément | Ce qu'il faut en faire |
|---|---|
| Statut | Le vérifier : un envoi peut réussir pour un destinataire et échouer pour un autre. Voir Plusieurs destinataires. |
Numéro de suivi (TrackingID) |
Le conserver : il sert aux journaux et à la suppression. |
| Lien et courriel HTML | Ce sont des secrets : remettez-les au seul destinataire et ne les journalisez jamais. |
À la lecture
La réponse de lecture donne le nombre d'ouvertures restantes (RemainingOpenTime) et la date d'expiration (ExpireOn), égale à la date d'envoi plus minutesExpiration. Voir Lire un message.
Les réponses
Une réponse à une enveloppe est rattachée par Secure Exchanges à la demande d'origine. Dans les journaux, elle apparaît comme une réponse (MsgType à 2).
Fin de vie
| Événement | Ce qui se passe |
|---|---|
| Dernière ouverture permise | Le destinataire voit le message une dernière fois, puis le serveur le détruit avec ses fichiers. Le journal ajoute une activité Destroy, mais son statut reste celui de la récupération (Retreive). |
| Expiration | Le lien ne mène plus au message, et le serveur l'efface ensuite avec ses fichiers. Le statut du journal ne change pas : son champ ExpirationDate donne la date d'expiration. |
| Suppression | Le message est détruit avec ses fichiers, le journal passe au statut Destroy, et le titulaire de la licence reçoit un courriel de confirmation. Voir Supprimer un message. |
Le courriel d'avis
Avec getNotify à true, le titulaire de la licence qui a envoyé le message reçoit un courriel quand le destinataire l'ouvre, dans la langue de son compte. Son objet est « Votre message vient d'être lu par », suivi de l'adresse du destinataire. Il indique le destinataire, le sujet du message, la date d'envoi et celle de l'ouverture, dans le fuseau horaire du compte. Si votre organisation a activé la géolocalisation des avis, il indique aussi le pays, la ville et l'adresse IP d'où le message a été ouvert.
Le sujet du message figure en clair dans ce courriel : n'y mettez pas plus de renseignements personnels que nécessaire.