Mailgun （预览版）
Mailgun 提供强大的 API 来发送、接收、跟踪和存储电子邮件。 使用此连接器可自动执行电子邮件传送和通信工作流，而无需编写代码。
此连接器在以下产品和区域中可用：
| Service | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| 名字 | 支持渠道 |
| URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| 连接器元数据 | |
|---|---|
| 发布者 | 辛奇瑞典 AB |
| Website | https://www.mailgun.com |
| 隐私策略 | https://www.mailgun.com/legal/privacy-policy/ |
| 类别 | 营销;销售和 CRM |
连接器名称
Mailgun
连接器摘要
Mailgun 连接器允许Power Automate用户发送电子邮件、检索 Mailgun 域信息、验证单个电子邮件地址、提交批量电子邮件验证作业，以及使用其 Mailgun 帐户检索批量验证结果。
联系人
联系人 URL： https://help.mailgun.com/hc/en-us
支持/联系电子邮件： support@mailgun.com
注册 URL： https://signup.mailgun.com/
要求
- Mailgun 帐户。 如果没有，请 https://signup.mailgun.com/注册。
- Mailgun API 密钥或域发送密钥。
- 帐户的正确 Mailgun API 区域：美国或欧盟。
- 若要发送电子邮件，请使用 Mailgun 发送域。 生产发送需要已验证的域。
- 对于验证操作，访问 Mailgun Validate。
沙盒域可用于初始测试，但仅限于授权的收件人。
如何获取凭据
此连接器使用 Mailgun API 密钥身份验证。 登录到 Mailgun 控制面板并从 API 安全性创建 API 密钥，或者从发送域设置创建特定于域的发送 API 密钥。
连接器使用基本身份验证 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 US 或 Mailgun EU | 是 |
操作
| 发送电子邮件 |
通过与 Mailgun 的邮件 API 兼容的多部分表单字段使用 Mailgun 帐户发送电子邮件。 |
| 批量电子邮件验证 |
上传包含电子邮件标题列的 CSV，并使用 Mailgun 的 V4 API 启动批量验证作业。 |
| 获取域 |
获取域列表。 可以按状态或颁发机构进行筛选。 列表分页，每页限制为 1000 个项目。 |
| 获取域详细信息 |
提取域的 JSON 表示形式，其中包含有关域的状态和设置的详细信息。 |
| 获取批量验证结果 |
检索以前提交的作业的批量验证作业状态和摘要结果。 |
| 验证电子邮件 |
使用 Mailgun 的验证服务验证电子邮件地址并返回可交付结果。 |
发送电子邮件
通过与 Mailgun 的邮件 API 兼容的多部分表单字段使用 Mailgun 帐户发送电子邮件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
域名
|
domain_name | True | string |
要从中发送电子邮件的域 |
|
发件人电子邮件地址
|
from | True | string |
邮件将从中发送的电子邮件地址。 |
|
电子邮件地址
|
to | True | string |
收件人电子邮件地址。 |
|
Subject
|
subject | True | string |
电子邮件的主题。 |
|
电子邮件正文（文本）
|
text | string |
电子邮件的纯文本正文。 |
|
|
电子邮件正文（HTML）
|
html | html |
电子邮件的 HTML 正文。 |
|
|
抄送电子邮件地址
|
cc | string |
抄送收件人电子邮件地址。 |
|
|
BCC 电子邮件地址
|
bcc | string |
盲件抄送收件人电子邮件地址。 |
|
|
Reply-To 电子邮件地址
|
h:Reply-To | string |
应在何处传递答复。 |
|
|
附件
|
attachment | file |
要包含在邮件中的文件附件。 |
|
|
Tags
|
o:tag | array |
在 Mailgun 中对电子邮件进行分组和筛选的一个或多个标记（每封邮件最多 10 封）。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
消息标识符
|
id | string |
分配给排队消息的唯一标识符 |
|
状态消息
|
message | string |
Mailgun 中的人类可读状态（例如，已排队）。谢谢。 |
批量电子邮件验证
上传包含电子邮件标题列的 CSV，并使用 Mailgun 的 V4 API 启动批量验证作业。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
作业列表名称
|
list_id | True | string |
标识批量验证作业的路径参数。 |
|
CSV 文件
|
file | True | file |
要上传的 CSV 文件。 该文件必须包含一个名为电子邮件的标头。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
作业 ID （列表名称）
|
id | string |
作业标识符（列表名称） |
|
服务器消息
|
message | string |
Mailgun 中的状态消息 |
获取域
获取域列表。 可以按状态或颁发机构进行筛选。 列表分页，每页限制为 1000 个项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
限度
|
limit | integer |
项的最大计数。 最大值：1000。 默认值：100 |
|
|
跳过
|
skip | integer |
获取从第 n 个元素开始的项列表。 默认值：0 |
|
|
州
|
state | string |
仅获取具有特定状态的域。 可以是活动、未经验证或禁用的。 |
|
|
Sort
|
sort | string |
有效的排序选项包括 name （asc）、name：asc 或 name：desc。 |
|
|
权威
|
authority | string |
仅获取具有特定机构的域。 |
|
|
搜寻
|
search | string |
按给定的部分或完整名称搜索域。 不支持通配符。 |
|
|
包括子帐户
|
include_subaccounts | boolean |
搜索属于此帐户下的任何子帐户的每个域。 默认值：false。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
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 |
如果 True Mailgun 仅通过 TLS 连接发送消息 |
|
skip_verification
|
items.skip_verification | boolean |
如果 True 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 |
要发布到的每个成功传递邮件的副本的 URL |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
如果此域的传入消息为 true，则会加密 |
|
message_ttl
|
items.message_ttl | integer |
指定用于检索传入和传出消息的生存时间（TTL），以秒为单位 |
获取域详细信息
提取域的 JSON 表示形式，其中包含有关域的状态和设置的详细信息。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
域名
|
name | True | string |
要提取的域的名称 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
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 |
如果 True Mailgun 仅通过 TLS 连接发送消息 |
|
skip_verification
|
domain.skip_verification | boolean |
如果 True 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 |
要发布到的每个成功传递邮件的副本的 URL |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
如果此域的传入消息为 true，则会加密 |
|
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 |
DNS 记录的 Mailgun 缓存值列表 |
|
名字
|
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 |
DNS 记录的 Mailgun 缓存值列表 |
|
名字
|
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 记录的预期值 |
获取批量验证结果
检索以前提交的作业的批量验证作业状态和摘要结果。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
职位编号
|
list_id | True | string |
从批量验证请求返回的作业标识符。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
职位编号
|
id | string |
作业标识符 |
|
职位编号
|
list_id | string |
作业列表名称 |
|
作业状态
|
status | string |
当前作业状态 |
|
创建时间
|
created_at | integer |
创建作业时（Unix 时间戳） |
|
CSV 下载 URL
|
download_url.csv | string |
将所有结果下载为 CSV 文件的 URL |
|
特选 CSV 下载 URL
|
download_url.curated_csv | string |
将特选结果下载为 CSV 文件的 URL |
|
JSON 下载 URL
|
download_url.json | string |
将所有结果下载为 JSON 文件的 URL |
|
特选 JSON 下载 URL
|
download_url.curated_json | string |
将特选结果下载为 JSON 文件的 URL |
|
总量
|
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 |
没有预订数据的地址数 |
验证电子邮件
使用 Mailgun 的验证服务验证电子邮件地址并返回可交付结果。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
电子邮件地址
|
address | True | string |
要验证的电子邮件地址。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
电子邮件地址
|
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
|
result | string |
Mailgun 可交付结果（例如可交付结果或不可交付结果） |
|
根地址
|
root_address | string |
规范化根地址 |
|
显示名称
|
parts.display_name | string |
地址的显示名称部分 |
|
域名
|
parts.domain | string |
地址的域部分 |
|
本地部件
|
parts.local_part | string |
地址的本地部分 |