Mandrill
Mandrill 是面向 MailChimp 用戶的交易電子郵件 API。 它可靠、功能強大,非常適合發送數據驅動的電子郵件,包括有針對性的電子商務和個性化的一對一消息。
此連接器適用於以下產品和區域:
| 服務 | 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) |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://mandrill.com/ |
| 隱私策略 | https://mailchimp.com/legal/privacy/ |
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 可共用 |
預設
適用:所有地區
建立連線的參數。
這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Mandrill API 金鑰 | securestring | Mandrill API 金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 1200 | 60 秒 |
動作
| 傳送郵件 [已棄用] |
此動作已被取代。 請改用 [傳送郵件 (V2)] 。
|
| 傳送郵件 (V2) |
透過 Mandrill 傳送新的交易式訊息。 |
| 列出排程訊息 |
查詢您排定的電子郵件。 |
| 目前使用者資訊 |
傳回 API 連線使用者的相關資訊。 |
傳送郵件 [已棄用]
此動作已被取代。 請改用 [傳送郵件 (V2)] 。
透過 Mandrill 傳送新的交易式訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
HTML 文字
|
html | string |
要傳送的完整 HTML 內容 |
|
|
訊息的文字內容
|
text | True | string |
要發送的全文內容 |
|
主旨
|
subject | True | string |
訊息主旨 |
|
來自電子郵件
|
from_email | True | string |
寄件者電子郵件地址 |
|
寄件者名稱
|
from_name | string |
寄件者電子郵件名稱 |
|
|
Email
|
True | string |
收件者的電子郵件地址 |
|
|
名稱
|
name | string |
收件者的顯示名稱 |
|
|
傳送方式
|
type | string |
傳送類型 (收件者、抄送、密件抄送) |
|
|
額外的標頭
|
headers | string |
要新增至郵件的額外標頭 (允許使用大部分標頭) |
|
|
此訊息重要嗎 (true/false)?
|
important | boolean |
此訊息是否重要,以及是否應該在非重要訊息之前傳遞 |
|
|
追蹤訊息開啟時間 (true/false)?
|
track_opens | boolean |
是否要開啟郵件的開啟追蹤 |
|
|
追蹤此訊息的點擊次數 (true/false)?
|
track_clicks | boolean |
是否要開啟訊息的點擊追蹤 |
|
|
如果不存在,請填寫短信(true/false)?
|
auto_text | boolean |
是否要為未指定文字的訊息自動產生文字部分 |
|
|
如果不存在,請填寫 HTML 訊息(true/false)?
|
auto_html | boolean |
是否要為未指定 HTML 的訊息自動產生 HTML 部分 |
|
|
Html 訊息中的內聯 CSS 樣式(true/false)?
|
inline_css | boolean |
是否自動內嵌訊息 HTML 中提供的所有 CSS 樣式 — 僅適用於大小小於 256KB 的 HTML 文件 |
|
|
從彙總資料中的 URL 中刪除查詢字串 (true/false)?
|
url_strip_qs | boolean |
彙總追蹤的 URL 資料時,是否要從 URL 中移除查詢字串 |
|
|
在“收件人”行中顯示所有收件人(true/false)?
|
preserve_recipients | boolean |
是否要將所有收件者公開到每封電子郵件的「收件者」標頭中 |
|
|
刪除內容日誌記錄(true/false)?
|
view_content_link | boolean |
是否要記錄內容。 設定為 false 可移除敏感電子郵件的內容記錄 |
|
|
選用密件副本地址
|
bcc_address | string |
可選地址,以接收每個收件人電子郵件的確切副本 |
|
|
用於追蹤的自訂網域
|
tracking_domain | string |
用於追蹤開啟和點擊的自訂網域,而不是 mandrillapp.com |
|
|
Tags
|
tags | array of string |
要標記訊息的字串陣列。 統計數據是使用標籤累積的,儘管我們只儲存我們看到的前 100 個,因此這不應該是唯一的或經常更改。 標籤應為 50 個字元或更少。 任何以底線開頭的標籤都會保留供內部使用,並且會導致錯誤。 |
|
|
MIME 類型
|
type | string |
附件的 MIME 類型 |
|
|
檔案名稱
|
name | string |
附件的檔案名稱 |
|
|
Content
|
content | byte |
附件內容 |
|
|
發送至
|
send_at | string |
何時此訊息應以 YYYY-MM-DD HH:MM:SS 格式作為 UTC 時間戳記傳送。 如果您指定過去的時間,訊息將立即發送。 預定電子郵件需支付額外費用,此功能僅適用於餘額為正數的帳戶。 |
|
|
啟用非同步 (true/false)?
|
async | boolean |
啟用針對大量傳送最佳化的背景傳送模式 |
|
|
專用 IP 集區名稱
|
ip_pool | string |
應該用來傳送訊息的專用 IP 集區名稱 |
傳回
- response
- array of SendMessageResponse
傳送郵件 (V2)
透過 Mandrill 傳送新的交易式訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訊息內容
|
html | html |
完整內容將發送 |
|
|
主旨
|
subject | True | string |
訊息主旨 |
|
來自電子郵件
|
from_email | True | string |
寄件者電子郵件地址 |
|
寄件者名稱
|
from_name | string |
寄件者電子郵件名稱 |
|
|
Email
|
True | string |
收件者的電子郵件地址 |
|
|
名稱
|
name | string |
收件者的顯示名稱 |
|
|
傳送方式
|
type | string |
傳送類型 (收件者、抄送、密件抄送) |
|
|
額外的標頭
|
headers | string |
要新增至郵件的額外標頭 (允許使用大部分標頭) |
|
|
此訊息重要嗎 (true/false)?
|
important | boolean |
此訊息是否重要,以及是否應該在非重要訊息之前傳遞 |
|
|
追蹤訊息開啟時間 (true/false)?
|
track_opens | boolean |
是否要開啟郵件的開啟追蹤 |
|
|
追蹤此訊息的點擊次數 (true/false)?
|
track_clicks | boolean |
是否要開啟訊息的點擊追蹤 |
|
|
如果不存在,請填寫短信(true/false)?
|
auto_text | boolean |
是否要為未指定文字的訊息自動產生文字部分 |
|
|
Html 訊息中的內聯 CSS 樣式(true/false)?
|
inline_css | boolean |
是否自動內嵌訊息 HTML 中提供的所有 CSS 樣式 — 僅適用於大小小於 256KB 的 HTML 文件 |
|
|
從彙總資料中的 URL 中刪除查詢字串 (true/false)?
|
url_strip_qs | boolean |
彙總追蹤的 URL 資料時,是否要從 URL 中移除查詢字串 |
|
|
在“收件人”行中顯示所有收件人(true/false)?
|
preserve_recipients | boolean |
是否要將所有收件者公開到每封電子郵件的「收件者」標頭中 |
|
|
刪除內容日誌記錄(true/false)?
|
view_content_link | boolean |
是否要記錄內容。 設定為 false 可移除敏感電子郵件的內容記錄 |
|
|
選用密件副本地址
|
bcc_address | string |
可選地址,以接收每個收件人電子郵件的確切副本 |
|
|
用於追蹤的自訂網域
|
tracking_domain | string |
用於追蹤開啟和點擊的自訂網域,而不是 mandrillapp.com |
|
|
Tags
|
tags | array of string |
要標記訊息的字串陣列。 統計數據是使用標籤累積的,儘管我們只儲存我們看到的前 100 個,因此這不應該是唯一的或經常更改。 標籤應為 50 個字元或更少。 任何以底線開頭的標籤都會保留供內部使用,並且會導致錯誤。 |
|
|
MIME 類型
|
type | string |
附件的 MIME 類型 |
|
|
檔案名稱
|
name | string |
附件的檔案名稱 |
|
|
Content
|
content | byte |
附件內容 |
|
|
發送至
|
send_at | string |
何時此訊息應以 YYYY-MM-DD HH:MM:SS 格式作為 UTC 時間戳記傳送。 如果您指定過去的時間,訊息將立即發送。 預定電子郵件需支付額外費用,此功能僅適用於餘額為正數的帳戶。 |
|
|
啟用非同步 (true/false)?
|
async | boolean |
啟用針對大量傳送最佳化的背景傳送模式 |
|
|
專用 IP 集區名稱
|
ip_pool | string |
應該用來傳送訊息的專用 IP 集區名稱 |
傳回
- response
- array of SendMessageResponse
列出排程訊息
查詢您排定的電子郵件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
發往
|
To | string |
選擇性收件者電子郵件地址,以將結果限制為 |
傳回
- response
- array of ListScheduledInfo
目前使用者資訊
定義
UserInfo
使用者資訊,包括使用者名稱、金鑰、信譽、配額和歷史發送統計資料
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
使用者名
|
username | string |
使用者的使用者名稱(用於SMTP驗證) |
|
建立時間
|
created_at | string |
使用者的 Mandrill 帳戶以 YYYY 建立為 UTC 字串的日期和時間 -MM-DD HH:MM:SS 格式 |
|
公開識別碼
|
public_id | string |
此使用者的唯一永久識別碼 |
|
Reputation
|
reputation | integer |
使用者的聲譽範圍從 0 到 100,75 通常是「良好」的聲譽 |
|
每小時配額
|
hourly_quota | integer |
Mandrill 每小時為該使用者傳送的電子郵件數量上限。 超出此範圍的任何電子郵件都將被接受並排隊等待稍後發送。 口碑越高的用戶,每小時的額度就越高 |
|
待辦項目
|
backlog | integer |
因超出每月或每小時配額而排入佇列等待傳送的電子郵件數量 |
|
統計數據
|
stats | Stats |
帳戶發送統計資料的彙總摘要 |
Stats
帳戶發送統計資料的彙總摘要
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
今天
|
today | StatStruct |
結構體以保存統計信息,此結構體在今天、last_7_days、last_30_days、last_60_days、last_90_days和all_time的統計數據之間共享 |
|
last_7_days
|
last_7_days | StatStruct |
結構體以保存統計信息,此結構體在今天、last_7_days、last_30_days、last_60_days、last_90_days和all_time的統計數據之間共享 |
|
last_30_days
|
last_30_days | StatStruct |
結構體以保存統計信息,此結構體在今天、last_7_days、last_30_days、last_60_days、last_90_days和all_time的統計數據之間共享 |
|
last_60_days
|
last_60_days | StatStruct |
結構體以保存統計信息,此結構體在今天、last_7_days、last_30_days、last_60_days、last_90_days和all_time的統計數據之間共享 |
|
last_90_days
|
last_90_days | StatStruct |
結構體以保存統計信息,此結構體在今天、last_7_days、last_30_days、last_60_days、last_90_days和all_time的統計數據之間共享 |
|
all_time
|
all_time | StatStruct |
結構體以保存統計信息,此結構體在今天、last_7_days、last_30_days、last_60_days、last_90_days和all_time的統計數據之間共享 |
統計結構
結構體以保存統計信息,此結構體在今天、last_7_days、last_30_days、last_60_days、last_90_days和all_time的統計數據之間共享
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
寄件日期
|
sent | integer |
為此使用者傳送的電子郵件數 |
|
硬退跳
|
hard_bounces | integer |
此使用者硬退回的電子郵件數目 |
|
軟彈跳
|
soft_bounces | integer |
此使用者軟退信的電子郵件數目 |
|
拒絕
|
rejects | integer |
傳送此使用者而遭到拒絕的電子郵件數目 |
|
投訴
|
complaints | integer |
此使用者的垃圾郵件投訴數量 |
|
取消訂閱
|
unsubs | integer |
此使用者的取消訂閱次數 |
|
獨特開啟次數
|
unique_opens | integer |
此使用者開啟電子郵件的次數 |
|
點擊次數
|
clicks | integer |
到目前為止,該使用者已點選的 URL 數 |
|
獨特點擊次數
|
unique_clicks | integer |
針對此使用者傳送的電子郵件的唯一點按次數 |
傳送訊息回應
每個收件者的訊息資訊,其中包含索引鍵「電子郵件」和電子郵件地址,以及該收件者的訊息狀態詳細資料
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Email
|
string |
收件者的電子郵件地址 |
|
|
傳送狀態
|
status | string |
收件者的傳送狀態 — 「已傳送」、「已排入佇列」、「已排程」、「已拒絕」或「無效」 |
|
拒絕原因
|
reject_reason | string |
如果收件者狀態為「已拒絕」,則拒絕的原因 — 「硬退信」、「軟退信」、「垃圾郵件」、「取消訂閱」、「自訂」、「無效寄件者」、「無效」、「測試模式限制」、「未簽署」或「規則」之一 |
|
訊息 ID
|
_id | string |
訊息的唯一ID |
清單排程資訊
特定 smtp 事件的相關資訊
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
收件人的電子郵件
|
string |
收件者的電子郵件地址 |
|
|
收件人狀態
|
status | string |
收件者的傳送狀態 — 「已傳送」、「已排入佇列」、「已排程」、「已拒絕」或「無效」 |
|
拒絕原因
|
reject_reason | string |
如果收件者狀態為「已拒絕」,則拒絕的原因 - 「硬退信」、「軟退信」、「垃圾郵件」、「取消訂閱」、「自訂」、「無效寄件者」、「無效」、「測試模式限制」、「未簽署」或「規則」之一 |
|
訊息 ID
|
_id | string |
訊息的唯一 ID |