共用方式為

DataMotion （預覽版）

DataMotion， Inc. 專注於安全資料交換 API，使公司能夠將安全訊息和檔案交換解決方案整合到其現有工作流程中並節省開發時間。 遵循安全協定可能非常耗時，但 DataMotion 的連接器可實現無縫、單向加密訊息傳遞，幫助使用者遵守行業法規和企業的安全策略。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 DataMotion 支援
URL https://datamotion.com/support-request/
Email support@datamotion.com
連接器中繼資料
Publisher 數據運動公司
網站 https://datamotion.com/secure-message-delivery-api/
隱私策略 https://datamotion.com/privacy-policy/
類別 傳達;安全

DataMotion， Inc. 是一家專門從事安全資料傳輸的 API 公司。 這意味著您可以利用我們的安全訊息傳遞連接器將加密的文字、文件、圖像、檔案等安全地傳送給任何具有有效電子郵件地址的使用者。 透過這種端對端加密，您可以確保訊息內容沒有被離線或以任何方式更改，無論是在傳輸過程中還是在收件匣中。 除了安全地傳送訊息之外，安全訊息傳遞連接器還可讓您追蹤和撤回安全訊息。 透過將此功能整合到您的工作流程中，您的使用者將能夠安全地自動執行以前可能完全不可能的任務，因為自動化可能會危及安全性。 您的組織將能夠利用 Power Automate 自動執行無數任務，包括正確、安全地處理臨床資訊、傳輸病患健康記錄、傳輸付款存根、儲存員工退休計劃等等。

先決條件

要使用 DataMotion 的安全訊息傳遞連接器，您首先需要建立一個 DataMotion 帳戶。 您可以選擇建立付費、基於訂閱的帳戶，或 30 天免費試用來開始。 若要建立帳戶，請導覽至 datamotion.com/portal。

完成此步驟後，您將自動收到 25 美元的積分來測試 API。 在這裡，您可以選擇「付款」，以一次性或定期付款的形式繼續添加到您的餘額中。 您需要餘額，才能繼續使用安全訊息傳遞連接器傳送、追蹤和撤回安全訊息。

如何取得認證

若要建立 DataMotion 帳戶，請導覽至 datamotion.com/portal，您將在其中看到顯示的 API 方案清單。 將滑鼠懸停在「安全訊息傳遞」計劃上，然後按一下「立即嘗試」圖示。

選擇“立即試用”後，您將看到“API – 安全消息傳遞 Self-Service 中心”頁面顯示。 該中心提供測試 DataMotion API、檢閱文件並在需要時聯絡支援人員的選項。

屏幕右上角有一個“登錄”按鈕。 按一下此按鈕即可開始。 選擇按鈕後，將顯示一個新的彈出窗口;在此彈出視窗的底部，選擇「在此處註冊」。

完成這些步驟後，您將看到資訊請求和建立密碼的部分。 輸入所需資訊並建立您的安全密碼。

查看並同意服務條款，然後選擇「建立您的帳戶」完成該過程。 你有它！ 您的帳戶已建立完畢，您將自動擁有 25 美元的餘額來測試我們的 API。

開始使用我們的連接器

DataMotion 的安全訊息傳遞是自動化工作流程中的完美補充。 連接器本身不能用作觸發器，但可用於在工作流程啟動後傳送、追蹤和撤回安全訊息。

使用安全訊息傳遞聯結器的工作流程有一些常見的觸發器。 表單提交就是一個例子，因為使用者可能需要從表單中提取敏感資料，然後以安全的方式發送。 使用 DocuSign 連接器簽署表單也是一個常見的觸發因素。 需要簽署和傳遞的重要文件通常是關鍵業務文件，或包含 PII、PHI 或 PCI，因此應安全傳送。 最後，可以使用定時間隔來觸發每日、每週或每月的工作流程。 當重要資料（例如更新的客戶帳戶清單或每週利潤審查）需要加密並定期發送給第三方時，這尤其有用。

若要開始使用安全訊息傳遞連接器，請先建立新的 Power Automate 工作流程，然後選取觸發程序。 您可以使用上述範例之一或更獨特的觸發器。

選擇觸發器後，您將需要添加要發送的敏感數據。 例如，如果您選擇表單提交作為觸發器，則工作流程的第一步是從此表單收集資料。 透過工作流程收集敏感資料後，下一步就是透過安全訊息傳送資料。 為此，您需要新增一個額外的工作流程步驟。

若要這麼做，請選取 [+ 下一步] 並搜尋 DataMotion 連接器。 您可以透過在新步驟部分頂部的搜尋欄中輸入「安全訊息傳遞」來執行此操作。

選取 [+ 下一步] 按鈕之後，您會看到與此連接器相關聯的動作清單。 選擇「傳送安全訊息」作為動作。

新的小工具將顯示安全訊息請求。

下面，我將逐步介紹請求的每個部分並提供範例條目。 請記住，您可能需要自訂這些欄位才能正確測試（尤其是「收件者」地址！

  • 版本

    • V— 此部分詢問您正在使用的 DataMotion API 版本。 您可以在自助服務入口網站的 「如何操作」 部分找到您正在使用的 API 版本。 在「必要參數」區段的頂端，您可以找到 API 版本。

  • X-API-秘密

    • 若要取得 API 秘密金鑰，請導覽回 自助服務中心 並登入。 登入後，應該會出現一個標題為「應用程式」的新標籤。 選取此索引標籤。
      • 從這裡，選擇“創建應用程序”按鈕並為應用程序命名。 然後為應用程式類型選擇「其他」並提供描述。
      • 選取 API 金鑰區段中央的「加號 （+）」，然後複製快顯視窗中提供的 API 密碼。 將此金鑰貼到 Power Automate 的 X-API-Secret 文字方塊中。

  • X-API 金鑰

    • 在 API 金鑰區段中，複製提供的金鑰，並將其貼到 Power Automate 的 X-API-Key 區段中。

  • 從

    • 「寄件者」位址將是您傳送安全訊息的位址。 輸入您建立 API 密碼和金鑰時使用的位址。

  • 到

    • 「收件者」地址可以是任何帶有郵箱的地址。 若要進行測試，您可以輸入用於寄件者地址的相同地址或您有權存取的任何地址。

  • 抄送（選用）

    • 輸入具有您要複製的對應信箱的任何其他電子郵件地址。

  • 密件抄送（可選）

    • 輸入具有您要密印的相應郵箱的任何其他電子郵件地址。

  • 主題（選填）

    • 輸入電子郵件的主旨。

  • 附件（可選）

    • 若要新增附件，您需要提供 base64 字串、內容類型、檔案名稱和內容 ID。 還有一些額外的步驟可以自動收集此信息，但對於今天的演示，您可以將此部分留空。

  • HtmlBody （選用）

    • 在此區段中，您可以新增要在訊息內文中傳送的 html 文字。 在此範例中，您可以將此區段保留空白。

  • TextBody （選擇性）

    • 在此區域中，以純文字勾勒正文並新增您要傳送的敏感資訊。

單擊每個文本框時，您可能會看到“插入上一步的參數”。 您看到的這些參數是您先前可能從表單、Excel 工作表或其他敏感性文件提取的回應。 您可以選取這些引數，以將此資料包含在電子郵件內文中。

完成配置後，選擇“保存”。 您將在螢幕頂部看到一條訊息，確認您的工作流程已儲存。

現在您已經建立了包含 DataMotion 安全訊息傳遞 API 的工作流程！

已知問題與限制

DataMotion 的安全訊息傳遞連接器有一個已知的限制。 如果使用者在傳送訊息後嘗試直接追蹤或撤回訊息，則可能會出現錯誤訊息，指出找不到該訊息。 這是因為訊息 ID 尚未更新。 失敗時延遲兩秒鐘或重試將解決此問題。

常見錯誤和補救措施

無效的 API 密碼或金鑰會導致 401 錯誤。 若要解決此錯誤，您需要建立新金鑰。 導覽至 DataMotion 安全訊息傳遞入口網站 ，然後選取 應用程式 索引標籤。在此選項卡中，您將看到一個 API 密鑰部分，其中包含您當前的 API 密鑰顯示。 刪除您目前的 API 金鑰，並將垃圾桶圖示放在金鑰右側。

選擇垃圾桶圖示後，金鑰將被刪除，並且頁面的 API 金鑰部分中間將提供用於新增金鑰的新選項。 選取此選項並安全地儲存秘密金鑰（您將看到顯示），因為您將無法再次從 DataMotion 入口網站存取此金鑰。 從這裡，將新的 API 金鑰複製到 Power Automate 工作流程中。

FAQ

從哪裡取得 API 金鑰和密碼？

若要建立 API 金鑰或密碼，請導覽至 DataMotion 安全訊息傳遞入口網站 ，然後選取「應用程式」標籤。在「API 金鑰」部分中，將提供新增金鑰的選項;您將在該部分中間看到該選項。 選取此選項並安全地儲存將顯示的金鑰，因為您將無法再次從 DataMotion 入口網站存取此金鑰。 從這裡，將新的 API 金鑰複製到 Power Automate 工作流程中。

如何註冊 DataMotion 帳戶？

要註冊 DataMotion 帳戶，請導航到 datamotion.com/portal，您將在其中看到顯示的 API 計劃列表。 將滑鼠懸停在「安全訊息傳遞」計劃上，然後按一下「立即嘗試」圖示。

選擇“嘗試”後，您將看到顯示的“API – 安全消息傳遞 Self-Service 中心”頁面。 該中心提供測試 DataMotion API、檢閱文件並在需要時聯絡支援人員的選項。

屏幕右上角有一個“登錄”按鈕。 選取此按鈕即可開始。 選擇按鈕後，將顯示一個新的彈出窗口 - 在此彈出窗口的底部選擇“在此處註冊”。

完成這些步驟後，您將看到資訊請求和建立密碼的部分。 輸入所需資訊並建立您的安全密碼。

查看並同意服務條款，然後選擇「建立您的帳戶」完成該過程。 你有它！ 您的帳戶已建立完畢，您將自動擁有 25 美元的餘額來測試我們的 API。

如何添加到我的餘額中？

要添加到您的餘額中，請導航到 DataMotion 安全消息傳遞門戶 ，然後在您的可用餘額下選擇“付款”。 提供您的姓名、公司和地址，然後點擊“下一步”。 從這裡，您可以設定自動充值的定期付款;您也可以選擇一次性付款。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

傳送安全訊息

以安全的方式發送訊息，確保資料不會損壞。
撤回安全訊息

撤回先前傳送的安全訊息。
追蹤安全訊息

追蹤安全訊息以確保訊息已傳遞並開啟。

傳送安全訊息

作業識別碼：
SendSecureMessageAsync

以安全的方式發送訊息，確保資料不會損壞。

參數

名稱 機碼 必要 類型 Description
寄件者
 From True string

將傳送訊息的使用者位址。
發往
 To array of string

安全訊息的收件者陣列。
副本
 Cc array of string

收件者陣列，複製到安全訊息上。
密件抄送
 Bcc array of string

一系列收件人，在安全消息上盲複印。
主旨
 Subject string

安全訊息的主旨。
附件基數64
 AttachmentBase64 string

附件的 Base64 編碼字串。
內容類型
 ContentType string

附件的媒體類型。
檔案名稱
 FileName string

附件檔的名稱。
內容標識符
 ContentId string

Content ID （僅在附件是內嵌影像時才填入）。
Html正文
 HtmlBody string

電子郵件訊息的 HTML 內文。
文字內文
 TextBody string

電子郵件的文字內文。
V
 v True string

API 版本。 您可以通過訪問 https://developers.datamotion.com 然後從左側菜單中選擇“API 版本 （BaseURL）”來找到這。
X-API-Key
 X-API-Key True string

用來識別 API 金鑰物件的唯一識別碼。 要了解有關這方面的更多信息，請訪問 https://datamotion.com/how-to-use-datamotion-with-power-automate/。
X-API-Secret
 X-API-Secret True string

繫結至 API 金鑰的秘密值。 要了解有關這方面的更多信息，請訪問 https://datamotion.com/how-to-use-datamotion-with-power-automate/。

傳回

傳送安全訊息回應模型。

身體
SendSecureMessageResponse

撤回安全訊息

作業識別碼：
RetractMessageAsync

撤回先前傳送的安全訊息。

參數

名稱 機碼 必要 類型 Description
TransactionId
 transactionId True uuid

要撤回的安全訊息的 ID。
V
 v True string

API 版本。 您可以通過訪問 https://developers.datamotion.com 然後從左側菜單中選擇“API 版本 （BaseURL）”來找到這。
X-API-Key
 X-API-Key True string

用來識別 API 金鑰物件的唯一識別碼。 要了解有關這方面的更多信息，請訪問 https://datamotion.com/how-to-use-datamotion-with-power-automate/。
X-API-Secret
 X-API-Secret True string

繫結至 API 金鑰的秘密值。 要了解有關這方面的更多信息，請訪問 https://datamotion.com/how-to-use-datamotion-with-power-automate/。

追蹤安全訊息

作業識別碼：
TrackMessageAsync

追蹤安全訊息以確保訊息已傳遞並開啟。

參數

名稱 機碼 必要 類型 Description
TransactionId
 transactionId True uuid

要追蹤之安全訊息的識別碼。
V
 v True string

API 版本。 您可以通過訪問 https://developers.datamotion.com 然後從左側菜單中選擇“API 版本 （BaseURL）”來找到這。
X-API-Key
 X-API-Key True string

用來識別 API 金鑰物件的唯一識別碼。 要了解有關這方面的更多信息，請訪問 https://datamotion.com/how-to-use-datamotion-with-power-automate/。
X-API-Secret
 X-API-Secret True string

繫結至 API 金鑰的秘密值。 要了解有關這方面的更多信息，請訪問 https://datamotion.com/how-to-use-datamotion-with-power-automate/。

傳回

訊息追蹤物件。

身體
TrackMessageResponse

定義

SendSecureMessage回應

傳送安全訊息回應模型。

名稱 路徑 類型 Description
TransactionId
 TransactionId uuid

交易的 ID。
收件者數目
 NumberOfRecipients integer

收件者總數。
訊息大小
 MessageSize integer

訊息的大小 （以位元組為單位）。
Expiration
 Expiration string

訊息到期的日期時間。
專案標識符
 ProjectId uuid

專案的識別碼。
ApplicationId
 ApplicationId uuid

應用程式的識別碼

追蹤訊息回應

訊息追蹤物件。

名稱 路徑 類型 Description
費用
 Cost double

交易的總成本。
Attachments
 Attachments array of AttachmentMetaData

包含每個附件附件結構、SecurityEnvelope 結構和追蹤結構的複雜類型。
ExpirationDate
 ExpirationDate string

訊息到期的日期/時間。
訊息標識符
 MessageId integer

訊息的識別碼。
訊息大小
 MessageSize integer

訊息大小 （以位元組為單位）。
安全信封
 SecurityEnvelope object

訊息安全性信封物件。
追蹤
 Tracking array of Tracking

訊息追蹤物件的清單。
主旨
 Subject string

訊息主旨。

附件中繼資料

訊息附件物件。

名稱 路徑 類型 Description
附件標識符
 AttachmentId integer

附件唯一識別碼。
檔案名稱
 FileName string

附件檔名。
內容標識符
 ContentId object

附件內容識別碼 （只有在附件是內嵌影像時才填入）。
內容類型
 ContentType string

附件的媒體類型。
安全信封
 SecurityEnvelope object

附件安全信封。
大小
 Size Size

附件大小物件。
追蹤
 Tracking AttachmentTracking

附件追蹤資訊。

追蹤

訊息追蹤資訊。

名稱 路徑 類型 Description
開張日期
 DateOpened string

開啟訊息時的日期/時間字串。 附註： 如果 year = 1900，則沒有與現行訊息狀態相關聯的 DateOpened。
Email
 Email string

收件者的電子郵件地址。
訊息狀態說明
 MessageStatusDescription string

狀態以字串描述表示。
訊息狀態標識符
 MessageStatusId integer

個別收件者狀態的數字指示器。
Receiver欄位
 ReceiverField string

指出此收件者是郵件的收件人、副本或密件副本。

大小

附件大小物件。

名稱 路徑 類型 Description
標準字串
 StdString string

包含附件大小的字串值;

附件追蹤

附件追蹤資訊。

名稱 路徑 類型 Description
收件者
 Recipients array of Recipient

訊息收件者物件。
開張日期
 DateOpened string

開啟訊息時的日期/時間字串。 附註： 如果 year = 1900，則沒有與現行訊息狀態相關聯的 DateOpened。
Email
 Email string

收件者的電子郵件地址。
訊息狀態說明
 MessageStatusDescription string

狀態以字串描述表示。
訊息狀態標識符
 MessageStatusId integer

個別收件者狀態的數字指示器。
Receiver欄位
 ReceiverField string

指出此收件者是郵件的收件人、副本或密件副本。

Recipient

訊息收件者物件。

名稱 路徑 類型 Description
總和檢查碼已驗證
 ChecksumValidated integer

下列其中一個值：0 （無效）、1 （有效） 或 2 （未套用）。
Delivered
 Delivered boolean

指出訊息是否已傳遞。
交貨日期
 DeliveredDate string

DateTime 字串，代表訊息的傳遞時間。
已下載
 Downloaded boolean

指出是否已下載附件。
下載日期
 DownloadedDate string

DateTime 字串，代表下載附件的時間。
Email
 Email string

收件者的電子郵件地址。