邮件窗体 （预览版）
打印和邮寄信件和明信片的最简单方法：USPS 一流、认证、优先级和优先级快速邮件。
此连接器在以下产品和区域中可用：
| 服务 | 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） |
| 联系人 | |
|---|---|
| Name | 邮件窗体支持 |
| URL | https://help.mailform.io |
| support@mailform.io |
| 连接器元数据 | |
|---|---|
| 发布者 | Mailform， Inc. |
| Website | https://www.mailform.io |
| 隐私策略 | https://www.mailform.io/privacy |
| 服务条款 | https://www.mailform.io/terms |
| 类别 | 业务管理;营销 |
Mailform 连接器允许 Power Automate 环境中的流发送物理邮件：提供 PDF 校对和一些打印规格，如颜色/黑白打印或 simplex/双面打印，Mailform 将打印文档以规格，在适当的信封中的东西，添加邮资并将其移交给 USPS（不久， FedEx 代表你。 连接器提供了一种简单的方法来执行此作：例如，可以通过向其发送营销文档来响应新用户注册的流程，或者在订单发货 30 天后向客户发送带有优惠券的明信片。
先决条件
需要满足以下条件才能继续作：
- 具有有效、非零信用额度的 Mailform 帐户（用于支付打印作业和邮件作业的费用）。 在 Mailform 免费注册
如何获取凭据
若要获取凭据，请执行以下作：
- 在 Mailform 中登录到 Mailform 帐户
- 通过访问 Mailform Billing 转到计费设置
- 单击“ 购买帐户信用额度 ”按钮，然后单击 $25.00 选项，将最低额度添加到帐户。
- 完成付款过程：这将创建信用帐户并将信用额度添加到你的帐户。
- 单击“API 访问”选项卡或访问 Mailform API 访问，转到 API 访问设置
- 单击 “新建 API 令牌 ”按钮，然后为令牌提供标签（如 Power Automate 测试）。 测试时，可以为此密钥启用测试模式：将接受和验证所有 API 请求，但不会发送实际邮件。 将接受测试模式订单，然后立即取消，并且不会影响信用余额。
- 将显示新的 API 令牌：请将其复制下来，因为它 不会 再次显示。 请注意，测试模式 API 令牌永远不能切换到测试模式：准备好上线时，需要创建新的 API 令牌。
连接器入门
为了演示如何使用 Mailform，我们将创建一个流，用于在生日时使用优惠券代码发送传单。 在 Power Automate 编辑器中：
- 单击“创建”按钮创建新流。
- 选择“计划云流”选项。
- 命名流，并设置日期和时间（在本例中，每 12 个月于 2023 年 12 月 27 日）。
- 单击“创建”按钮。
- 单击加号图标，然后单击“添加作”。
- 在对话框中，搜索 Mailform，然后使用 Mailform作选择“打印”和“邮寄信函”或“明信片”。
- 填写收件人和发件人地址。
- 填写文档并打印规范：首先单击“高级参数”选项，然后选择 URL，然后输入值 https://www.mailform.io/samples/sampleflyer.pdf。 然后单击“高级参数”选项，然后选择颜色，然后选择“是”。
- 单击编辑器顶部的“保存”按钮，然后完成作。 运行流时，订单将放置在与 API 密钥关联的 Mailform 帐户中。
已知问题和限制
- 打印校对必须小于 40 MB：如果要邮寄的 PDF 文档超过 40 MB，则需要对其进行预处理，以减少文件大小。
常见错误和补救措施
N/A
FAQ
N/A
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| API 密钥 | securestring | 要用于此连接的 Mailform API 密钥 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 使用 Mailform 打印和邮寄信函或明信片 |
通过提供打印校对和订单详细信息（服务类、颜色/黑白、单面/双面打印等）创建新的 Mailform 订单。 |
| 获取现有订单 |
检索通过 API 创建的现有订单 |
| 获取经过身份验证的用户 |
检索有关经过身份验证的邮件窗体用户的信息 |
使用 Mailform 打印和邮寄信函或明信片
通过提供打印校对和订单详细信息（服务类、颜色/黑白、单面/双面打印等）创建新的 Mailform 订单。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
file | file |
要邮寄的 PDF 文档 |
|
|
URL
|
url | string |
将从 PDF 下载 URL |
|
|
客户参考
|
customer_reference | string |
要附加到订单的可选客户引用 |
|
|
传递服务
|
service | True | string |
要使用的传递服务。 必须是指定值之一 |
|
通知 Webhook
|
webhook | string |
应接收有关此订单更新的通知的 Webhook |
|
|
单面/双面
|
simplex | boolean |
如此 如果文档应打印一页到工作表，则为 false（如果文档可以在工作表的两侧打印） |
|
|
颜色/黑色和白色
|
color | boolean |
如果文档应以颜色打印，则为 true;如果文档应以黑白打印，则为 false |
|
|
包括平面信封
|
flat | boolean |
如此 如果文档必须邮寄在平面信封中，则为 false（如果邮件折叠的文档是可以接受的） |
|
|
包括返回信封
|
return_envelope | boolean |
如此 如果文档必须用寄信信封邮寄。 请勿指定是否需要寄信封 |
|
|
使用实际标记
|
stamp | boolean |
如此 如果文档必须使用真实邮票，则为 false（如果可接受）使用按流量计费的邮资或印记邮件文档 |
|
|
明信片消息
|
message | string |
要打印在明信片的非图片端的消息。 如果服务设置为USPS_POSTCARD，则为必需 |
|
|
收件人姓名
|
to.name | True | string |
此信封或明信片收件人的姓名 |
|
收件人公司/组织
|
to.organization | string |
收件人的组织或公司 |
|
|
收件人街道地址
|
to.address1 | True | string |
收件人的街道号和名称 |
|
Recipient Suite/Room/Floor/Unit Number
|
to.address2 | string |
收件人的套件或房间编号 |
|
|
收件人城市
|
to.city | True | string |
收件人的地址城市 |
|
收件人状态/区域
|
to.state | True | string |
收件人的地址状态 |
|
收件人邮政编码/邮政编码
|
to.postcode | True | string |
收件人的邮政编码或邮政编码 |
|
收件人国家/地区
|
to.country | string |
收件人的地址国家/地区 |
|
|
发件人姓名
|
from.name | True | string |
发送方的名称 |
|
发件人公司/组织
|
from.organization | string |
发件人的组织或公司 |
|
|
发件人街道地址
|
from.address1 | True | string |
发件人的街道号和名称 |
|
Sender Suite/Room/Floor/Unit Number
|
from.address2 | string |
发件人的套件或房间编号 |
|
|
发送者城市
|
from.city | True | string |
发件人的地址城市 |
|
发送方状态/区域
|
from.state | True | string |
发件人的地址状态 |
|
发件人邮政编码/邮政编码
|
from.postcode | True | string |
发件人的邮政编码或邮政编码 |
|
发件人国家/地区
|
from.country | string |
发件人的地址国家/地区 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
代码
|
error.code | string |
错误代码 |
|
消息
|
error.message | string |
错误信息 |
|
详情
|
details | string |
其他详细信息 |
|
success
|
success | boolean |
成功时为 true |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
服务
|
data.lineitems.service | string |
获取现有订单
检索通过 API 创建的现有订单
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
邮件窗体订单 ID
|
id | True | string |
Mailform 订单的 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
代码
|
error.code | string |
错误代码 |
|
消息
|
error.message | string |
错误信息 |
|
详情
|
details | string |
其他详细信息 |
|
success
|
success | boolean |
成功时为 true |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
服务
|
data.lineitems.service | string | |
|
tracking_number
|
data.lineitems.tracking_number | string |
获取经过身份验证的用户
检索有关经过身份验证的邮件窗体用户的信息
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
id
|
id | string | |
|
电子邮件
|
string | ||
|
姓名
|
name | string | |
|
id
|
balance.id | string | |
|
量
|
balance.amount | integer | |
|
货币
|
balance.currency | string |