郵件表單 （預覽）
打印和郵寄信件和明信片的最簡單方法：USPS 頭等郵箱、認證郵箱、優先郵箱和優先特快專遞。
此連接器適用於以下產品和區域：
| 服務 | 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） |
| 連絡人 | |
|---|---|
| 名稱 | 郵件支持 |
| URL | https://help.mailform.io |
| support@mailform.io |
| 連接器中繼資料 | |
|---|---|
| Publisher | 郵箱公司 |
| 網站 | https://www.mailform.io |
| 隱私權原則 | https://www.mailform.io/privacy |
| 服務條款 | https://www.mailform.io/terms |
| 類別 | 商業管理;行銷 |
Mailform 連接器允許 Power Automate 環境中的流程傳送實體郵件：提供 PDF 校訂和一些列印規格，例如彩色/黑白列印或單面/雙面列印，Mailform 會列印符合規格的文件，將其塞進適當的信封中，添加郵資並將其移交給 USPS （很快， FedEx）代表您。 聯結器提供單一、簡單的方法來執行此操作：例如，您可以有一個流程，透過向新使用者傳送行銷文件來回應新使用者註冊，或在訂單出貨 30 天後向客戶發送帶有優惠券的明信片。
先決條件
您將需要以下內容才能繼續：
- 具有有效、非零信用帳戶的郵件表單帳戶（用於支付您的列印和郵件工作費用）。 在 Mailform 免費註冊
如何取得認證
若要取得認證：
- 在 Mailform 登錄您的 Mailform 帳戶
- 前往 [郵件表單計費] 前往 [計費設定]
- 按一下「 購買帳戶信用額 度」按鈕，然後按一下 $25.00 選項，將最低信用額度新增至您的帳戶。
- 完成付款流程：這將創建一個信用帳戶並將信用添加到您的帳戶中。
- 按一下「API 存取」標籤或造訪「郵件表單 API 存取」，前往 API 存取設定
- 按一下 [新增 API 權杖 ] 按鈕，然後為權杖提供標籤 （例如 Power Automate 測試）。 在測試時，您可以啟用此金鑰的測試模式：所有 API 請求都會被接受並驗證，但不會傳送實際的郵件。 測試模式的訂單將被接受然後立即取消，並且不會影響您的信用餘額。
- 將顯示新的 API 令牌：請將其複製下來，因為它將 不再 顯示。 請注意，測試模式 API 權杖永遠無法切換出測試模式：當您準備好上線時，您需要建立新的 API 權杖。
開始使用連接器
為了演示 Mailform 的使用，我們將創建一個流程，在我的生日那天發送帶有優惠券代碼的傳單。 在 Power Automate 編輯器中：
- 按一下 建立 按鈕，建立新流程。
- 選取排程的雲端流程選項。
- 命名流程，並設定日期和頻率 （在此案例中為 2023 年 12 月 27 日每 12 個月一次）。
- 按一下 建立 按鈕。
- 按一下加號圖示，然後按一下新增動作。
- 在對話方塊中，搜尋 [郵件表單]，然後選取 [使用郵件表單列印並郵寄信件或明信片] 動作。
- 填寫收件人和寄件者地址。
- 填寫文件並列印規格：先點擊進階參數選項，然後選擇url，然後輸入值 https://www.mailform.io/samples/sampleflyer.pdf。 然後按一下 進階參數 選項，然後選取 顏色，然後選取 是。
- 點擊編輯器頂部的「儲存」按鈕，我們就完成了。 當流程執行時，訂單將下達在與 API 金鑰相關聯的 Mailform 帳戶中。
已知問題與限制
- 列印校樣必須小於40 MB：如果您郵寄的PDF檔案超過40 MB，則需要預先處理以減少檔案大小。
常見錯誤和補救措施
N/A
FAQ
N/A
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | 用於此連線的郵件表單 API 金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 使用郵件表單列印和郵寄信件或明信片 |
透過提供列印校樣以及訂單詳細資訊（服務等級、彩色/黑白、單面/雙面列印等）來建立新的郵件訂單 |
| 取得已驗證的使用者 |
擷取已驗證郵件表單使用者的相關資訊 |
| 取得現有訂單 |
擷取透過 API 建立的現有訂單 |
使用郵件表單列印和郵寄信件或明信片
透過提供列印校樣以及訂單詳細資訊（服務等級、彩色/黑白、單面/雙面列印等）來建立新的郵件訂單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
file | file |
要郵寄的 PDF 文件 |
|
|
URL
|
url | string |
將下載 PDF 中的 URL |
|
|
客戶參考
|
customer_reference | string |
要附加至訂單的選用客戶參考 |
|
|
送貨服務
|
service | True | string |
要使用的送貨服務。 必須是指定的值之一 |
|
通知 Webhook
|
webhook | string |
應接收此訂單訂單更新相關通知的 Webhook |
|
|
單面/雙面
|
simplex | boolean |
如果文件應列印一頁到一張紙上，則為 true，如果文件可以列印在紙張的兩面，則為 false |
|
|
顏色/黑白
|
color | boolean |
如果文件應以彩色列印，則為 true，如果文件應以黑白列印，則為 false |
|
|
包括平面信封
|
flat | boolean |
如果文件必須裝在扁平信封中郵寄，則為 True，如果可以接受將文件折疊郵寄，則為 false |
|
|
包括回郵信封
|
return_envelope | boolean |
如果文件必須與回郵信封一起郵寄，則為 True。 請勿指定是否不需要回郵信封 |
|
|
使用真實印章
|
stamp | boolean |
如果文件必須使用真實郵票，則為 true，如果可以使用計量郵資或壓印郵寄文件，則為 false |
|
|
明信片留言
|
message | string |
要列印在明信片非圖片面的訊息。 如果服務設定為USPS_POSTCARD |
|
|
收件者名稱
|
to.name | True | string |
此信封或明信片的收件人姓名 |
|
接收公司/組織
|
to.organization | string |
收款人的組織或公司 |
|
|
收件人街道地址
|
to.address1 | True | string |
收件人的街道號碼和姓名 |
|
收款套房/房間/樓層/單位編號
|
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 |
寄件人的街道號碼和姓名 |
|
寄件套房/房間/樓層/單位編號
|
from.address2 | string |
寄件人的套房或房間號碼 |
|
|
發送者城市
|
from.city | True | string |
寄件者的地址城市 |
|
寄件者州/地區
|
from.state | True | string |
寄件者的位址狀態 |
|
寄件者郵遞區號/郵遞區號
|
from.postcode | True | string |
寄件者的郵遞區號或郵遞區號 |
|
寄件者國家/地區
|
from.country | string |
寄件者的地址國家/地區 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
字碼
|
error.code | string |
錯誤碼 |
|
訊息
|
error.message | string |
錯誤訊息 |
|
details
|
details | string |
其他詳情 |
|
勝
|
success | boolean |
成功時的真實 |
|
識別碼
|
data.id | string | |
|
明細項目
|
data.lineitems | array of object | |
|
識別碼
|
data.lineitems.id | string | |
|
服務
|
data.lineitems.service | string |
取得已驗證的使用者
擷取已驗證郵件表單使用者的相關資訊
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string | |
|
電子郵件
|
string | ||
|
名稱
|
name | string | |
|
識別碼
|
balance.id | string | |
|
量
|
balance.amount | integer | |
|
貨幣
|
balance.currency | string |
取得現有訂單
擷取透過 API 建立的現有訂單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
郵件訂單 ID
|
id | True | string |
郵件訂單的 ID |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
字碼
|
error.code | string |
錯誤碼 |
|
訊息
|
error.message | string |
錯誤訊息 |
|
details
|
details | string |
其他詳情 |
|
勝
|
success | boolean |
成功時的真實 |
|
識別碼
|
data.id | string | |
|
明細項目
|
data.lineitems | array of object | |
|
識別碼
|
data.lineitems.id | string | |
|
服務
|
data.lineitems.service | string | |
|
tracking_number
|
data.lineitems.tracking_number | string |