全部產品
Search
文件中心

Direct Mail:快速使用API和SMTP發信的流程簡化說明

更新時間:Aug 09, 2024

快速使用API和SMTP發信的流程簡化說明。

為了您快速瞭解Direct Mail產品,您可以瀏覽如下流程圖,對應節點可以在文檔中找到具體解釋。

image

開通Direct Mail服務

  • 主帳號開通:主帳號登入Direct Mail產品頁面,在Direct Mail產品頁面,選擇立即購買購買Direct Mail資源套件(預付費)或立即開通直接開通隨用隨付(後付費)。

  • 子帳號開通:如果希望子帳號開通Direct Mail,需要主帳號在RAM控制台賦予子帳號如下兩個許可權點AliyunDirectMailFullAccess和 AliyunDirectMailReadOnlyAccess

選擇發信地區

目前有華東、新加坡、美國和德國四個叢集。四個地區的網域名稱和發信地址互相不通,在某個地區建立的發信地址只能使用相應地區的控制台、API或者SMTP服務發信。

image

如何選擇發信地區:

1、前提:不同的地區決定了資料落地的地區。如果涉及境外客戶,請先諮詢您公司的法務,資料在哪個地區才合規。

2、如果您的發信程式部署在境內,建議您選擇華東1地區。

3、如果您的發信程式部署在境外,且收信地址境外居多,建議您使用新加坡、美國和德國叢集。

4、如果您的發信程式部署在境外,且收信地址境內居多:

a)如果您的發信程式使用SMTP發信,且部署在美國或者新加坡,建議您使用華東1地區,會自動通過美國或者新加坡加速節點路由到華東1節點。

b)其他情況,建議您使用新加坡地區。

建立和佈建網域名

在您使用Direct Mail產品時,第一步是需要建立發信網域名稱。設定網域名稱分為自動設定手動設定,設定網域名稱的具體步驟請參考發送郵件的配置步驟簡化說明的Step 1-Step 4。

建立發信地址

  • 建立發信地址:發信地址就是您通過Direct Mail平台發信後,收件者收到的郵件中所顯示的寄件者的郵件地址。

  • 驗證回信地址:在設定發信地址時,您可以設定回信地址以接收回信。

  • 設定SMTP密碼:如果您需要使用SMTP發信方式,可以設定該發信地址對應的SMTP 密碼。

具體步驟請參考設定發信地址

API發信

API服務地址:參考API服務地址文檔

發送郵件的介面:單一發信介面SingleSendMail,批量發信介面BatchSendMail

API的調用方式有兩種分別是:簽名機制和SDK,兩種方式都提供了相應的範例程式碼,SDK是使用者使用比較多的一種方式。這邊介紹下SDK方式。

簽名機制:參考簽名機制文檔

SDK:

1、OpenAPI自動產生代碼的方式。通過OpenAPI進行調試,選擇開發語言,填寫參數,下載自動產生的程式碼。SDK 版本分為升級版和原版,推薦使用升級版。openapi

2、其他SDK的方式。通過SDK參考裡面的範例文件下載所需的SDK包或者通過Maven進行安裝,再根據提供的發送郵件樣本發信。

舊版SDK

注意:在代碼中需要填入相應的"accessKeyId","accessKeySecret"值,AccessKey ID和AccessKey Secret是您訪問阿里雲API的密鑰,這個要在控制台的AccessKey管理建立AccessKey。

image

SMTP發信

SMTP 服務地址:參考SMTP服務地址文檔

SMTP發信樣本:

官方文檔已經提供了多種開發語言,可以通過SMTP參考文檔跳轉選擇對應語言的程式碼範例。SMTP發信以用的比較多的Java代碼為例:

1、配置好Java的開發環境和下載相應的代碼編輯工具。

2、找到SMTP之Java調用樣本,按表徵圖複製所有的代碼放到編輯工具裡面,替換您配置的參數資訊,就可以實現發信。

複製代碼

發送資料統計

查看主賬戶下全部發信地址的發出的郵件摘要資料,有兩種方式:

1、通過Direct Mail控制台>資料統計模組可以查看發送資料,具體的發信詳情,查看無效地址,具體步驟可以參考資料統計文檔資料統計

2、通過發送資料相關介面查詢,目前提供5個相關介面,介面介紹請參考發送資料相關介面文檔,調用方式參考上面API發信裡面介紹的API的調用。發送資料相關介面