DataMotion (préversion)
DataMotion, Inc. se spécialise dans les API d’échange de données sécurisées, ce qui permet aux entreprises d’intégrer des solutions d’échange de messages et de fichiers sécurisées dans leurs flux de travail existants et de gagner du temps de développement. Le protocole de sécurité suivant peut prendre du temps, mais le connecteur de DataMotion permet une messagerie chiffrée unidirectionnelle transparente, aidant les utilisateurs à rester conformes aux réglementations du secteur et aux stratégies de sécurité de votre entreprise.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge de DataMotion |
| URL | https://datamotion.com/support-request/ |
| Messagerie électronique | support@datamotion.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | DataMotion, Inc. |
| Site internet | https://datamotion.com/secure-message-delivery-api/ |
| Politique de confidentialité | https://datamotion.com/privacy-policy/ |
| Catégories | Communication; Sécurité |
DataMotion, Inc. est une société d’API spécialisée dans le transfert de données sécurisé. Cela signifie que vous pouvez utiliser notre connecteur de remise de messages sécurisé pour envoyer en toute sécurité du texte chiffré, des documents, des images, des fichiers et bien plus encore à n’importe quel utilisateur avec une adresse e-mail valide. Avec ce chiffrement de bout en bout, vous pouvez être sûr que le contenu de vos messages n’a pas été mis hors connexion ni modifié d’une manière quelconque, qu’il soit en transit ou dans votre boîte de réception. Outre l’envoi sécurisé de messages, le connecteur de remise de messages sécurisé vous permet de suivre et de retirer des messages sécurisés. En intégrant cette fonctionnalité dans vos flux de travail, vos utilisateurs pourront automatiser en toute sécurité les tâches susceptibles d’avoir été complètement hors question, car l’automatisation risque de compromettre la sécurité. Votre organisation pourra tirer parti de Power Automate pour automatiser une multitude de tâches, notamment la gestion appropriée et sécurisée des informations cliniques, le transfert des dossiers médicaux des patients, le transfert des stubs de paiement, le stockage des plans de retraite des employés, etc.
Prerequisites
Pour utiliser le connecteur de remise de messages sécurisé de DataMotion, vous devez d’abord créer un compte DataMotion. Vous avez la possibilité de créer un compte payant, basé sur un abonnement ou une version d’évaluation gratuite de 30 jours pour commencer. Pour créer un compte, accédez à datamotion.com/portal.
Une fois cette étape terminée, vous recevrez automatiquement un crédit de 25 $ pour tester l’API. À partir de là, vous pouvez sélectionner « Paiements » pour continuer à ajouter à votre solde sous la forme d’un paiement ponctuel ou périodique. Vous aurez besoin d’un solde pour continuer à envoyer, suivre et retirer des messages sécurisés avec le connecteur de remise de messages sécurisé.
Comment obtenir des informations d’identification
Pour créer un compte DataMotion, accédez à datamotion.com/portal où vous verrez une liste de plans d’API affichés. Placez le curseur sur le plan de remise de messages sécurisés, puis cliquez sur l’icône « Essayer maintenant ».
Une fois que vous avez sélectionné « Essayer maintenant », la page « API – Remise de messages sécurisée Self-Service Center » s’affiche. Ce centre offre la possibilité de tester les API DataMotion, de consulter la documentation et de contacter le support technique si nécessaire.
Dans le coin supérieur droit de l’écran, il existe un bouton « Connexion ». Cliquez sur ce bouton pour commencer. Une nouvelle fenêtre contextuelle s’affiche une fois le bouton sélectionné ; en bas de cette fenêtre contextuelle, sélectionnez « s’inscrire ici ».
Une fois ces étapes terminées, vous verrez une demande d’informations et une section pour créer un mot de passe. Entrez les informations requises et créez votre mot de passe sécurisé.
Passez en revue et acceptez les conditions d’utilisation, puis terminez le processus en sélectionnant « Créer votre compte ». Là, tu l’as ! Votre compte a été créé et vous aurez automatiquement un solde de 25 $ pour tester nos API.
Prise en main de notre connecteur
La remise de messages sécurisées de DataMotion est un ajout parfait dans les flux de travail automatisés. Le connecteur lui-même ne peut pas être utilisé comme déclencheur, mais peut être utilisé pour envoyer, suivre et retirer des messages sécurisés une fois votre flux de travail déclenché.
Il existe quelques déclencheurs courants pour les flux de travail utilisant le connecteur de remise de messages sécurisé. Une soumission de formulaire est un exemple, car les utilisateurs peuvent avoir besoin d’extraire des données sensibles d’un formulaire, puis de les envoyer de manière sécurisée. La signature d’un formulaire à l’aide du connecteur DocuSign est également un déclencheur courant. Les documents importants qui doivent être signés et transmis sont souvent critiques pour l’entreprise ou contiennent des informations personnelles, PHI ou PCI, et doivent donc être envoyés en toute sécurité. Enfin, un intervalle chronologique peut être utilisé pour déclencher un flux de travail tous les jours, hebdomadaires ou mensuels. Cela est particulièrement utile lorsque des données importantes, telles qu’une liste de comptes client mis à jour ou un examen hebdomadaire des bénéfices, doivent être chiffrées et envoyées à un tiers régulièrement.
Pour commencer à utiliser le connecteur de remise de messages sécurisé, commencez par créer un flux de travail Power Automate et sélectionnez un déclencheur. Vous pouvez utiliser l’un des exemples ci-dessus ou un déclencheur plus unique.
Une fois qu’un déclencheur est sélectionné, vous devez ajouter les données sensibles que vous souhaitez envoyer. Par exemple, si vous choisissez une soumission de formulaire en tant que déclencheur, la première étape du flux de travail consiste à collecter les données à partir de ce formulaire. Une fois que vous avez collecté des données sensibles via votre flux de travail, l’étape suivante consiste à envoyer les données via un message sécurisé. Pour ce faire, vous devez ajouter une étape de flux de travail supplémentaire.
Pour ce faire, sélectionnez « + Étape suivante » et recherchez le connecteur DataMotion. Pour ce faire, tapez « remise de messages sécurisées » dans la barre de recherche en haut de la section nouvelle étape.
Une fois que vous avez sélectionné le bouton « + Étape suivante », vous verrez une liste d’actions associées à ce connecteur. Choisissez « Envoyer un message sécurisé » comme action.
Un nouveau widget affiche la demande de message sécurisée.
Ci-dessous, je vais parcourir chaque section de la demande et fournir des exemples d’entrées. Gardez à l’esprit que vous devrez peut-être personnaliser ces champs pour tester correctement (en particulier l’adresse « À » !).
Version
- V : cette section demande la version de l’API DataMotion que vous utilisez. Vous trouverez la version de l’API que vous utilisez dans la section « How Do I » de notre portail libre-service. En haut de la section « Paramètre requis », vous trouverez la version de l’API.
X-API-Secret
- Pour obtenir la clé secrète API, revenez au centre libre-service et connectez-vous. Une fois connecté, un nouvel onglet doit apparaître intitulé « Applications ». Sélectionnez cet onglet.
- À partir de là, sélectionnez le bouton « Créer une application » et donnez un nom à l’application. Sélectionnez ensuite « Autre » pour le type d’application et fournissez une description.
- Sélectionnez le signe « plus » (+) dans le centre de la section Clés API et copiez le secret d’API fourni dans la fenêtre contextuelle. Collez cette clé dans la zone de texte X-API-Secret dans Power Automate.
- Pour obtenir la clé secrète API, revenez au centre libre-service et connectez-vous. Une fois connecté, un nouvel onglet doit apparaître intitulé « Applications ». Sélectionnez cet onglet.
X-API-Key
- Dans la section Clé API, copiez la clé fournie et collez-la dans la section X-API-Key dans Power Automate.
De
- L’adresse « De » sera l’adresse à partir de laquelle vous envoyez le message sécurisé. Entrez l’adresse avec laquelle vous avez créé le secret d’API et la clé.
À
- L’adresse « À » peut être n’importe quelle adresse avec une boîte aux lettres. Pour tester, vous pouvez entrer la même adresse que celle que vous avez utilisée pour l’adresse ou toute adresse à laquelle vous avez accès.
Cc (facultatif)
- Entrez toute adresse e-mail supplémentaire contenant une boîte aux lettres correspondante que vous souhaitez copier.
Cci (facultatif)
- Entrez toute adresse e-mail supplémentaire avec une boîte aux lettres correspondante que vous souhaitez copier en aveugle.
Objet (facultatif)
- Entrez l’objet de l’e-mail.
Pièces jointes (facultatif)
- Pour ajouter une pièce jointe, vous devez fournir la chaîne base64, le type de contenu, le nom de fichier et l’ID de contenu. Il existe quelques étapes supplémentaires pour collecter ces informations automatiquement, mais pour la démonstration aujourd’hui, vous pouvez laisser cette section vide.
HtmlBody (facultatif)
- Dans cette section, vous pouvez ajouter du texte html à envoyer dans le corps du message. Pour cet exemple, vous pouvez conserver cette section vide.
TextBody (facultatif)
- Dans cette zone, décrivez le corps en texte brut et ajoutez les informations sensibles que vous souhaitez envoyer.
Lorsque vous cliquez sur chacune des zones de texte, vous pouvez voir « Insérer des paramètres à l’étape précédente ». Ces paramètres que vous voyez sont les réponses que vous avez précédemment extraites d’un formulaire, d’une feuille Excel ou d’un autre document sensible. Vous pouvez sélectionner ces paramètres pour inclure ces données dans le corps de l’e-mail.
Une fois que vous avez finalisé vos configurations, sélectionnez « Enregistrer ». Vous verrez un message confirmant que votre flux de travail a été enregistré en haut de votre écran.
Vous avez maintenant créé un flux de travail qui incorpore l’API de remise de messages sécurisée DataMotion !
Problèmes connus et limitations
Le connecteur de remise de messages sécurisé de DataMotion présente une limitation connue. Si un utilisateur tente de suivre ou de retirer un message directement après l’avoir envoyé, un message d’erreur peut apparaître indiquant que le message est introuvable. Cela est dû au fait que l’ID de message n’a pas encore été mis à jour. Un délai de deux secondes ou une nouvelle tentative en cas d’échec résout ce problème.
Erreurs courantes et solutions
Une clé ou un secret d’API non valide entraîne une erreur 401. Pour résoudre cette erreur, vous devez créer une clé. Accédez au portail de remise de messages sécurisé DataMotion, puis sélectionnez l’onglet Applications. Dans cet onglet, vous verrez une section Clé API avec l’affichage de votre clé API actuelle. Supprimez votre clé API actuelle avec l’icône corbeille située à droite de la clé.
Une fois l’icône corbeille sélectionnée, la clé est supprimée et une nouvelle option permettant d’ajouter une clé sera disponible au milieu de la section Clé API de la page. Sélectionnez cette option et enregistrez en toute sécurité la clé secrète (que vous verrez affichée) car vous ne pourrez plus accéder à cette clé à partir du portail DataMotion. À partir de là, copiez votre nouvelle clé API dans votre workflow Power Automate.
Questions fréquentes (FAQ)
Où puis-je obtenir une clé API et un secret ?
Pour créer une clé API ou un secret, accédez au portail de remise de messages sécurisé DataMotion, puis sélectionnez l’onglet « Applications ». Dans la section « Clé API », une option permettant d’ajouter une clé sera disponible ; vous verrez l’option au milieu de la section. Sélectionnez cette option et enregistrez en toute sécurité la clé secrète qui s’affiche, car vous ne pourrez plus accéder à cette clé à partir du portail DataMotion. À partir de là, copiez votre nouvelle clé API dans votre workflow Power Automate.
Comment m’inscrire à un compte DataMotion ?
Pour vous inscrire à un compte DataMotion, accédez à datamotion.com/portal où vous verrez une liste de plans d’API affichés. Placez le curseur sur le plan de remise de messages sécurisés, puis cliquez sur l’icône « Essayer maintenant ».
Une fois que vous avez sélectionné « Essayer », la page « API – remise de messages sécurisée Self-Service Center » s’affiche. Ce centre offre la possibilité de tester les API DataMotion, de consulter la documentation et de contacter le support technique si nécessaire.
Dans le coin supérieur droit de l’écran, il existe un bouton « Connexion ». Sélectionnez ce bouton pour commencer. Une nouvelle fenêtre contextuelle s’affiche une fois que le bouton est sélectionné , en bas de cette fenêtre contextuelle, sélectionnez « s’inscrire ici ».
Une fois ces étapes terminées, vous verrez une demande d’informations et une section pour créer un mot de passe. Entrez les informations requises et créez votre mot de passe sécurisé.
Passez en revue et acceptez les conditions d’utilisation, puis terminez le processus en sélectionnant « Créer votre compte ». Là, tu l’as ! Votre compte a été créé et vous aurez automatiquement un solde de 25 $ pour tester nos API.
Comment ajouter à mon solde ?
Pour ajouter votre solde, accédez au portail de remise de messages sécurisés DataMotion, puis sélectionnez « Paiements » sous votre solde disponible. Indiquez votre nom, votre entreprise et votre adresse, puis appuyez sur « Suivant ». À partir de là, vous pouvez configurer un paiement périodique qui se recharge automatiquement ; vous avez également la possibilité d’effectuer un paiement unique.
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Envoyer un message sécurisé |
Envoie un message de manière sécurisée pour s’assurer que les données ne sont pas endommagées. |
| Retirer un message sécurisé |
Retirez un message sécurisé qui a été envoyé précédemment. |
| Suivre un message sécurisé |
Suivez un message sécurisé pour vous assurer que le message est remis et ouvert. |
Envoyer un message sécurisé
Envoie un message de manière sécurisée pour s’assurer que les données ne sont pas endommagées.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
De
|
From | True | string |
Adresse de l’utilisateur qui enverra le message. |
|
À
|
To | array of string |
Tableau de destinataires du message sécurisé. |
|
|
Cc
|
Cc | array of string |
Tableau de destinataires, copiés sur le message sécurisé. |
|
|
Bcc
|
Bcc | array of string |
Tableau de destinataires, carbone aveugle copié sur le message sécurisé. |
|
|
Sujet
|
Subject | string |
Objet du message sécurisé. |
|
|
AttachmentBase64
|
AttachmentBase64 | string |
Chaîne encodée en Base64 de la pièce jointe. |
|
|
ContentType
|
ContentType | string |
Type de média de la pièce jointe. |
|
|
Nom du fichier
|
FileName | string |
Nom du fichier de pièce jointe. |
|
|
ContentId
|
ContentId | string |
ID de contenu (renseigné uniquement si la pièce jointe est une image incorporée). |
|
|
HtmlBody
|
HtmlBody | string |
Corps HTML du message électronique. |
|
|
TextBody
|
TextBody | string |
Corps du texte du message électronique. |
|
|
v
|
v | True | string |
Version de l’API. Vous pouvez le trouver en visitant https://developers.datamotion.com , puis sélectionnez « Versions d’API (BaseURL) » dans le menu de gauche. |
|
X-API-Key
|
X-API-Key | True | string |
Identificateur unique utilisé pour identifier l’objet Clé API. Pour en savoir plus sur ce sujet, visitez https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
|
X-API-Secret
|
X-API-Secret | True | string |
Valeur secrète liée à la clé API. Pour en savoir plus sur ce sujet, visitez https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
Retours
Envoyer un modèle de réponse de message sécurisé.
Retirer un message sécurisé
Retirez un message sécurisé qui a été envoyé précédemment.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
TransactionId
|
transactionId | True | uuid |
ID du message sécurisé à retirer. |
|
v
|
v | True | string |
Version de l’API. Vous pouvez le trouver en visitant https://developers.datamotion.com , puis sélectionnez « Versions d’API (BaseURL) » dans le menu de gauche. |
|
X-API-Key
|
X-API-Key | True | string |
Identificateur unique utilisé pour identifier l’objet Clé API. Pour en savoir plus sur ce sujet, visitez https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
|
X-API-Secret
|
X-API-Secret | True | string |
Valeur secrète liée à la clé API. Pour en savoir plus sur ce sujet, visitez https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
Suivre un message sécurisé
Suivez un message sécurisé pour vous assurer que le message est remis et ouvert.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
TransactionId
|
transactionId | True | uuid |
ID du message sécurisé à suivre. |
|
v
|
v | True | string |
Version de l’API. Vous pouvez le trouver en visitant https://developers.datamotion.com , puis sélectionnez « Versions d’API (BaseURL) » dans le menu de gauche. |
|
X-API-Key
|
X-API-Key | True | string |
Identificateur unique utilisé pour identifier l’objet Clé API. Pour en savoir plus sur ce sujet, visitez https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
|
X-API-Secret
|
X-API-Secret | True | string |
Valeur secrète liée à la clé API. Pour en savoir plus sur ce sujet, visitez https://datamotion.com/how-to-use-datamotion-with-power-automate/. |
Retours
Objet de suivi des messages.
- Corps
- TrackMessageResponse
Définitions
SendSecureMessageResponse
Envoyer un modèle de réponse de message sécurisé.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
TransactionId
|
TransactionId | uuid |
ID de la transaction. |
|
NumberOfRecipients
|
NumberOfRecipients | integer |
Nombre total de destinataires. |
|
MessageSize
|
MessageSize | integer |
Taille du message en octets. |
|
Expiration
|
Expiration | string |
Heure d’expiration du message. |
|
ProjectId
|
ProjectId | uuid |
ID du projet. |
|
ApplicationId
|
ApplicationId | uuid |
ID de l’application |
TrackMessageResponse
Objet de suivi des messages.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Coûts
|
Cost | double |
Coût total de la transaction. |
|
Attachments
|
Attachments | array of AttachmentMetaData |
Type complexe contenant la structure de pièces jointes, la structure SecurityEnvelope et la structure de suivi par pièce jointe. |
|
ExpirationDate
|
ExpirationDate | string |
Date/heure de l’expiration du message. |
|
MessageId
|
MessageId | integer |
ID du message. |
|
MessageSize
|
MessageSize | integer |
Taille du message en octets. |
|
SecurityEnvelope
|
SecurityEnvelope | object |
Objet d’enveloppe de sécurité des messages. |
|
Suivi
|
Tracking | array of Tracking |
Liste des objets de suivi des messages. |
|
Sujet
|
Subject | string |
Objet du message. |
AttachmentMetaData
Objet pièce jointe de message.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
AttachmentId
|
AttachmentId | integer |
Identificateur unique de pièce jointe. |
|
Nom du fichier
|
FileName | string |
Nom du fichier de pièce jointe. |
|
ContentId
|
ContentId | object |
ID de contenu de pièce jointe (renseigné uniquement si la pièce jointe est une image incorporée). |
|
ContentType
|
ContentType | string |
Type de média de la pièce jointe. |
|
SecurityEnvelope
|
SecurityEnvelope | object |
Enveloppe de sécurité des pièces jointes. |
|
Taille
|
Size | Size |
Objet de taille de pièce jointe. |
|
Suivi
|
Tracking | AttachmentTracking |
Informations de suivi des pièces jointes. |
Suivi
Informations de suivi des messages.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
DateOpened
|
DateOpened | string |
Chaîne de date/heure de l’ouverture du message. Remarque : Si l’année = 1900, aucune dateOpened n’est associée à l’état actuel du message. |
|
Messagerie électronique
|
string |
Adresse e-mail du destinataire. |
|
|
MessageStatusDescription
|
MessageStatusDescription | string |
État représenté sous la forme d’une description de chaîne. |
|
MessageStatusId
|
MessageStatusId | integer |
Indicateur numérique de l’état du destinataire individuel. |
|
ReceiverField
|
ReceiverField | string |
Indique si ce destinataire était l’objet TO, CC ou CCI du message. |
Taille
Objet de taille de pièce jointe.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
StdString
|
StdString | string |
Valeur de chaîne qui contient la taille d’une pièce jointe ; |
AttachmentTracking
Informations de suivi des pièces jointes.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Destinataires
|
Recipients | array of Recipient |
Objet destinataire du message. |
|
DateOpened
|
DateOpened | string |
Chaîne de date/heure de l’ouverture du message. Remarque : Si l’année = 1900, aucune dateOpened n’est associée à l’état actuel du message. |
|
Messagerie électronique
|
string |
Adresse e-mail du destinataire. |
|
|
MessageStatusDescription
|
MessageStatusDescription | string |
État représenté sous la forme d’une description de chaîne. |
|
MessageStatusId
|
MessageStatusId | integer |
Indicateur numérique de l’état du destinataire individuel. |
|
ReceiverField
|
ReceiverField | string |
Indique si ce destinataire était l’objet TO, CC ou CCI du message. |
Recipient
Objet destinataire du message.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ChecksumValidated
|
ChecksumValidated | integer |
Une des valeurs suivantes : 0 (Non valide), 1 (Valide) ou 2 (NotApplied). |
|
Livré
|
Delivered | boolean |
Indique si le message a été remis ou non. |
|
DeliveredDate
|
DeliveredDate | string |
Chaîne DateTime représentant l’heure de remise du message. |
|
Téléchargé
|
Downloaded | boolean |
Indique si la pièce jointe a été téléchargée ou non. |
|
DownloadedDate
|
DownloadedDate | string |
Chaîne DateTime représentant l’heure de téléchargement de la pièce jointe. |
|
Messagerie électronique
|
string |
Adresse e-mail du destinataire. |