Mailgun（預覽）
Mailgun 提供強大的 API，用於發送、接收、追蹤及儲存電子郵件。 使用此連接器自動化電子郵件傳遞與溝通工作流程，無需撰寫程式碼。
此連接器適用於以下產品和區域：
| Service | Class | 地區 |
|---|---|---|
| Copilot Studio | 進階 | 除下列區域外的所有 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） |
| 聯絡方式 | |
|---|---|
| 名字 | 支援通道 |
| URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| 連接器中繼資料 | |
|---|---|
| 發行者 | 辛奇瑞典 AB |
| 網站 | https://www.mailgun.com |
| 隱私權原則 | https://www.mailgun.com/legal/privacy-policy/ |
| 類別 | 營銷;銷售和客戶關係管理 |
連接器名稱
郵槍
連接器摘要
Mailgun 連接器讓 Power Automate 用戶能發送電子郵件、取得 Mailgun 網域資訊、驗證個別電子郵件地址、提交大量電子郵件驗證工作，以及使用 Mailgun 帳號取得大量驗證結果。
聯絡方式
聯絡網址： https://help.mailgun.com/hc/en-us
支援/聯絡電子郵件： support@mailgun.com
報名網址： https://signup.mailgun.com/
要求
- 一個郵件槍帳號。 如果你沒有，請在 https://signup.mailgun.com/.
- Mailgun API 金鑰或網域發送金鑰。
- 你帳戶正確的 Mailgun API 區域：美國或歐盟。
- 發送電子郵件時，使用郵件槍發送網域。 生產傳送需要驗證網域。
- 驗證操作請使用Mailgun Validate。
沙盒網域可用於初步測試，但僅限於授權接收者。
如何取得認證
此連接器使用 Mailgun API 金鑰驗證。 登入 Mailgun 控制台，從 API Security 建立 API 金鑰，或從你的發送網域設定建立專屬的 Sending API 金鑰。
連接器使用 Basic 認證，使用者 api 名稱為用戶名，Mailgun API 金鑰為密碼。 在連線設定時，選擇與你帳號相符的 Mailgun API 區域。
支援的作業
此連接器支援下列作業：
-
Send Email：使用 Mailgun 發送網域發送電子郵件。 -
Get Domain Information： 取得 Mailgun 網域資訊。 -
Validate Email Address驗證個人電子郵件地址。 -
Submit Bulk Validation Job： 提交一封大量電子郵件驗證工作。 -
Get Bulk Validation Results：取得大量電子郵件驗證結果。
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有地區 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名字 | 類型 | 描述 | Required |
|---|---|---|---|
| API 金鑰 | 安全字串 | Mailgun 私有 API 金鑰 | 沒錯 |
| 郵槍區 | 字串 | 選擇 Mailgun 美國版或 Mailgun EU 版 | 沒錯 |
動作
| 傳送電子郵件 |
透過與 Mailgun 訊息 API 相容的多部分表單欄位，使用 Mailgun 帳號發送電子郵件。 |
| 取得批量驗證結果 |
取得先前提交工作的批量驗證工作狀態與摘要結果。 |
| 取得網域 |
取得網域清單。 可依州或權限篩選。 該清單有頁碼，每頁限制為1000件。 |
| 取得網域資訊 |
擷取包含網域狀態與設定細節的 JSON 表示。 |
| 批量電子郵件驗證 |
上傳帶有電子郵件標頭欄位的 CSV，並使用 Mailgun 的 V4 API 開始批量驗證工作。 |
| 驗證電子郵件 |
使用 Mailgun 的驗證服務驗證電子郵件地址，並回傳可達結果。 |
傳送電子郵件
透過與 Mailgun 訊息 API 相容的多部分表單欄位，使用 Mailgun 帳號發送電子郵件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網域名稱
|
domain_name | True | string |
寄信的網域 |
|
來自電子郵件地址
|
from | True | string |
訊息發送的電子郵件地址。 |
|
寄到電子郵件地址
|
to | True | string |
收件者電子郵件地址。 |
|
主旨
|
subject | True | string |
電子郵件的主旨。 |
|
電子郵件正文（文字）
|
text | string |
電子郵件的純文字內容。 |
|
|
電子郵件正文（HTML）
|
html | html |
電子郵件的 HTML 正文。 |
|
|
抄送電子郵件地址
|
cc | string |
副本收件人電子郵件地址。 |
|
|
密件副本電子郵件地址
|
bcc | string |
盲寫副本收件人電子郵件地址。 |
|
|
Reply-To 電子郵件地址
|
h:Reply-To | string |
應該在回應的地方。 |
|
|
附件
|
attachment | file |
附件，請隨訊息附上。 |
|
|
Tags
|
o:tag | array |
在 Mailgun 中設置一個或多個標籤，以便分組和過濾郵件（每封郵件最多 10 個）。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
訊息標識碼
|
id | string |
為排隊訊息分配的唯一識別碼 |
|
狀態訊息
|
message | string |
來自 Mailgun 的人類可讀狀態（例如，已排隊。謝謝你。） |
取得批量驗證結果
取得先前提交工作的批量驗證工作狀態與摘要結果。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
作業識別碼
|
list_id | True | string |
工作識別碼是從批次驗證請求中回傳的。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
作業識別碼
|
id | string |
工作識別碼 |
|
作業識別碼
|
list_id | string |
職缺名稱 |
|
工作狀態
|
status | string |
現職狀態 |
|
創立於
|
created_at | integer |
工作建立時間（Unix 時間戳記） |
|
CSV 下載網址
|
download_url.csv | string |
下載所有結果的 CSV 檔網址 |
|
精選 CSV 下載網址
|
download_url.curated_csv | string |
下載 CSV 檔案的精選結果網址 |
|
JSON 下載網址
|
download_url.json | string |
下載所有結果的 URL 以 JSON 檔案 |
|
精選 JSON 下載網址
|
download_url.curated_json | string |
下載精選結果的 JSON 檔案網址 |
|
總數量
|
quantity | integer |
工作中的總記錄數 |
|
處理紀錄
|
records_processed | integer |
目前處理的紀錄數量 |
|
交付數量
|
summary.result.deliverable | integer |
交付地址數量 |
|
無法交付的計數
|
summary.result.undeliverable | integer |
無法投遞的地址數量 |
|
全數計數
|
summary.result.catch_all | integer |
覆蓋所有地址的數量 |
|
請勿發送計數
|
summary.result.do_not_send | integer |
標記為「不發送」的地址數量 |
|
接受所有計數
|
summary.result.accept_all | integer |
接受所有地址的數量 |
|
未知伯爵
|
summary.result.unknown | integer |
可交付性未知的地址數量 |
|
高風險計數
|
summary.risk.high | integer |
高風險地址數量 |
|
中等風險計數
|
summary.risk.medium | integer |
中等風險地址數量 |
|
低風險計數
|
summary.risk.low | integer |
低風險地址數量 |
|
未知風險計數
|
summary.risk.unknown | integer |
風險不明地址數量 |
|
高度投入的伯爵
|
summary.engagement.highly_engaged | integer |
高度參與的演講數量 |
|
訂婚伯爵
|
summary.engagement.engaged | integer |
已參與地址數量 |
|
脫離戰鬥的伯爵
|
summary.engagement.disengaged | integer |
脫落地址數量 |
|
機器人計數
|
summary.engagement.bot | integer |
機器人地址數量 |
|
抱怨者數量
|
summary.engagement.complainer | integer |
投訴者地址數量 |
|
無資料計數
|
summary.engagement.no_data | integer |
沒有互動資料的地址數量 |
取得網域
取得網域清單。 可依州或權限篩選。 該清單有頁碼，每頁限制為1000件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
物品數量上限。 Max：1000。 預設值：100 |
|
|
跳過
|
skip | integer |
取得從第n個元素開始的物品清單。 預設值：0 |
|
|
State
|
state | string |
只取得特定州的網域。 可以是啟用、未驗證或停用。 |
|
|
Sort
|
sort | string |
有效的排序選項有 name（asc）、name：asc 或 name：desc。 |
|
|
權威
|
authority | string |
只取得具有特定權威的網域。 |
|
|
搜尋
|
search | string |
依照給定的部分或完整名稱搜尋網域。 不支援萬用牌。 |
|
|
包含子帳號
|
include_subaccounts | boolean |
搜尋該帳戶下任何子帳號的每個網域。 預設：false。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
total_count
|
total_count | integer |
網域總數 |
|
items
|
items | array of object |
網域列表 |
|
id
|
items.id | string |
網域的唯一識別碼 |
|
名字
|
items.name | string |
已在Mailgun註冊的完全合格網域名稱 |
|
狀態
|
items.state | string |
網域目前的驗證狀態 |
|
型別
|
items.type | string |
領域分類。 可能的值有自訂或沙盒 |
|
建立於
|
items.created_at | string |
時間戳記顯示網域以RFC1123格式建立的時間 |
|
is_disabled
|
items.is_disabled | boolean |
顯示該網域目前是否已停用 |
|
require_tls
|
items.require_tls | boolean |
如果是真的，Mailgun 只會透過 TLS 連線發送訊息 |
|
skip_verification
|
items.skip_verification | boolean |
如果是真的，Mailgun 在設定 TLS 連線時不會驗證憑證和主機名稱 |
|
smtp_login
|
items.smtp_login | string |
網域的 SMTP 登入使用者名稱 |
|
smtp_password
|
items.smtp_password | string |
用於 SMTP 認證的網域可選 SMTP 密碼 |
|
spam_action
|
items.spam_action | string |
當訊息被標記為垃圾郵件時應採取的行動。 選項有停用、標籤或封鎖 |
|
萬用字元
|
items.wildcard | boolean |
顯示該網域是否為萬用碼網域，並可接收任何子網域的電子郵件 |
|
subaccount_id
|
items.subaccount_id | string |
網域所屬的子帳號 ID |
|
tracking_host
|
items.tracking_host | string |
用於追蹤開啟與點擊的網域自訂追蹤主機 |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
如果 True，Mailgun 會自動管理 DKIM 金鑰產生和 DNS 記錄設定 |
|
web_prefix
|
items.web_prefix | string |
用於開啟與點擊追蹤的子網域前綴 |
|
web_scheme
|
items.web_scheme | string |
用於追蹤的協定方案 |
|
archive_to
|
items.archive_to | string |
每個成功送達的訊息副本都會被貼上網址 |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
如果該網域的真實訊息會被加密 |
|
message_ttl
|
items.message_ttl | integer |
指定取回接收與發出訊息所需的存活時間（TTL），以秒計 |
取得網域資訊
擷取包含網域狀態與設定細節的 JSON 表示。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網域名稱
|
name | True | string |
你想取得的網域名稱 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
id
|
domain.id | string |
網域的唯一識別碼 |
|
名字
|
domain.name | string |
已在Mailgun註冊的完全合格網域名稱 |
|
狀態
|
domain.state | string |
網域目前的驗證狀態 |
|
型別
|
domain.type | string |
領域分類。 可能的值有自訂或沙盒 |
|
建立於
|
domain.created_at | string |
時間戳記顯示網域以RFC1123格式建立的時間 |
|
is_disabled
|
domain.is_disabled | boolean |
顯示該網域目前是否已停用 |
|
require_tls
|
domain.require_tls | boolean |
如果是真的，Mailgun 只會透過 TLS 連線發送訊息 |
|
skip_verification
|
domain.skip_verification | boolean |
如果是真的，Mailgun 在設定 TLS 連線時不會驗證憑證和主機名稱 |
|
smtp_login
|
domain.smtp_login | string |
網域的 SMTP 登入使用者名稱 |
|
smtp_password
|
domain.smtp_password | string |
用於 SMTP 認證的網域可選 SMTP 密碼 |
|
spam_action
|
domain.spam_action | string |
當訊息被標記為垃圾郵件時應採取的行動。 選項有停用、標籤或封鎖 |
|
萬用字元
|
domain.wildcard | boolean |
顯示該網域是否為萬用碼網域，並可接收任何子網域的電子郵件 |
|
subaccount_id
|
domain.subaccount_id | string |
網域所屬的子帳號 ID |
|
tracking_host
|
domain.tracking_host | string |
用於追蹤開啟與點擊的網域自訂追蹤主機 |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
如果 True，Mailgun 會自動管理 DKIM 金鑰產生和 DNS 記錄設定 |
|
web_prefix
|
domain.web_prefix | string |
用於開啟與點擊追蹤的子網域前綴 |
|
web_scheme
|
domain.web_scheme | string |
用於追蹤的協定方案 |
|
archive_to
|
domain.archive_to | string |
每個成功送達的訊息副本都會被貼上網址 |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
如果該網域的真實訊息會被加密 |
|
message_ttl
|
domain.message_ttl | integer |
指定取回接收與發出訊息所需的存活時間（TTL），以秒計 |
|
receiving_dns_records
|
receiving_dns_records | array of object |
接收電子郵件所需的 DNS 紀錄列表 |
|
is_active
|
receiving_dns_records.is_active | boolean |
顯示 DNS 紀錄目前是否仍在運作 |
|
快取
|
receiving_dns_records.cached | array of string |
Mailgun DNS 紀錄快取值列表 |
|
名字
|
receiving_dns_records.name | string |
DNS紀錄名稱（如適用） |
|
優先權
|
receiving_dns_records.priority | string |
MX DNS 紀錄的優先權值 |
|
record_type
|
receiving_dns_records.record_type | string |
DNS 記錄類型，如 MX、TXT 或 CNAME |
|
有效
|
receiving_dns_records.valid | string |
顯示 DNS 紀錄是否有效 |
|
value
|
receiving_dns_records.value | string |
DNS 記錄的期望值 |
|
sending_dns_records
|
sending_dns_records | array of object |
發送電子郵件所需的 DNS 紀錄清單 |
|
is_active
|
sending_dns_records.is_active | boolean |
顯示 DNS 紀錄目前是否仍在運作 |
|
快取
|
sending_dns_records.cached | array of string |
Mailgun DNS 紀錄快取值列表 |
|
名字
|
sending_dns_records.name | string |
DNS紀錄名稱（如適用） |
|
優先權
|
sending_dns_records.priority | string |
MX DNS 紀錄的優先權值 |
|
record_type
|
sending_dns_records.record_type | string |
DNS 記錄類型，如 MX、TXT 或 CNAME |
|
有效
|
sending_dns_records.valid | string |
顯示 DNS 紀錄是否有效 |
|
value
|
sending_dns_records.value | string |
DNS 記錄的期望值 |
批量電子郵件驗證
上傳帶有電子郵件標頭欄位的 CSV，並使用 Mailgun 的 V4 API 開始批量驗證工作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
職缺名稱
|
list_id | True | string |
路徑參數，用以識別批次驗證工作。 |
|
CSV 檔案
|
file | True | file |
CSV 檔案要上傳。 檔案必須包含名為電子郵件的標頭。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
職缺識別碼（清單名稱）
|
id | string |
工作識別碼（清單名稱） |
|
伺服器訊息
|
message | string |
Mailgun 的狀態訊息 |
驗證電子郵件
使用 Mailgun 的驗證服務驗證電子郵件地址，並回傳可達結果。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
電子郵件地址
|
address | True | string |
要驗證的電子郵件地址。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
電子郵件地址
|
address | string |
驗證過的電子郵件地址 |
|
有效
|
is_valid | boolean |
Mailgun 是否認為該地址有效 |
|
信箱驗證
|
mailbox_verification | string |
信箱驗證狀態 |
|
是一次性地址
|
is_disposable_address | boolean |
無論地址是否來自一次性服務提供者 |
|
是角色地址
|
is_role_address | boolean |
該位址是否為基於角色的位址 |
|
驗證理由
|
reason | array of string |
Mailgun 回傳的驗證原因（有效時為空） |
|
風險等級
|
risk | string |
由Mailgun分配的風險等級 |
|
結果
|
result | string |
郵件槍投遞結果（例如可投遞或無法投遞） |
|
根地址
|
root_address | string |
正規化根地址 |
|
顯示名稱
|
parts.display_name | string |
地址的顯示名稱部分 |
|
網域
|
parts.domain | string |
位址的網域部分 |
|
地方部分
|
parts.local_part | string |
地址的本地部分 |