Zoho郵件

Zoho Mail 是一種安全可靠的商業電子郵件解決方案。 Zoho Mail 連接器可協助您管理電子郵件並執行動作，例如將電子郵件儲存為草稿、接收電子郵件，以及在新電子郵件到達時觸發流程。 Zoho Mail 連接器使您能夠管理電子郵件並執行操作，例如將它們另存為草稿、接收它們以及在新電子郵件到達時觸發流程。

此連接器適用於以下產品和區域：

服務	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）

連絡人
名稱	Zoho郵件
URL	https://www.zoho.com/mail/contact.html
Email	zmintegration@zohomail.com

連接器中繼資料
Publisher	Zoho Corporation 私人有限公司
網站	https://www.zoho.com/mail/
隱私策略	https://www.zoho.com/privacy.html
類別	Communication

發行商： Zoho Corporation

先決條件

已驗證的 Zoho Mail 帳戶。點擊此處建立您的第一個帳戶。

如何取得認證

當您建立新連線時，

選取您的 Zoho 帳戶所在的網域。
輸入您的 Zoho Mail 認證。
即使 Power App 與其他使用者共用，他們也應該建立新的連線才能開始使用它。

Zoho Mail API 使用 OAuth2.0 進行身份驗證，因此一旦設置帳戶，就不需要二次身份驗證。

開始使用連接器

請依照以下步驟連線到 Zoho Mail：

登入您的 Power Automate 帳戶，然後按一下左側功能表中的 [建立]。
您可以選擇建立雲端流程、桌面流程或商務流程。若要連線至 Zoho Mail，請選擇自動化雲端流程。
您可以建立流程/範本。
為您的流程/範本選擇 Send mail/Send template mail（傳送範本郵件）。
輸入相應動作所需的值。

已知問題和限制

電子郵件總大小，包括電子郵件標頭、內文內容、內嵌影像和附件，不應超過方案限制。
Zoho Mail 不能用於發送大量電子郵件和其他違反 Zoho Mail 使用政策的電子郵件。點擊此處了解更多詳情。

常見錯誤和補救措施

若要避免驗證錯誤，請選擇託管 Zoho Mail 帳戶的網域。

FAQ

https://help.zoho.com/portal/en/kb/mail

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
選取您的 Zoho 帳戶資料所在的區域。	字串	選取網域。	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

傳送電子郵件	從指定的電子郵件地址傳送新電子郵件
儲存草稿或範本	將電子郵件內容儲存為草稿或範本
取得寄件者清單	取得所有電子郵件寄件者的清單
取得帳戶詳細資料	此端點會取得目前已驗證使用者的帳戶詳細資料，例如其帳戶識別碼和帳戶顯示名稱。範例提示為「取得我的郵件帳戶詳細資料」（外掛程式會以擷取的帳戶 ID 和帳戶顯示名稱回應）。
取得標籤	此端點會根據帳戶 ID 取得指定使用者帳戶的所有標籤的詳細資訊，例如標籤 ID 和標籤名稱。使用者輸入帳戶 ID 作為輸入。提示「顯示帳戶 1234 的所有標籤」，操作會擷取與帳戶 1234 關聯的所有標籤。
取得資料夾	此端點會根據帳戶識別碼取得指定使用者帳戶所有資料夾的詳細資料，例如資料夾識別碼和資料夾名稱。使用者輸入帳戶 ID 作為輸入。範例提示「列出帳戶 1234 的所有資料夾」，作業會擷取與帳戶 1234 相關聯的所有資料夾。
取得電子郵件詳細資料	此端點會根據帳戶識別碼和訊息識別碼取得電子郵件詳細資料，例如訊息識別碼、摘要、電子郵件內容、傳送者、寄件者名稱和寄件者。此作業會採用訊息 ID 和帳戶 ID 作為輸入。範例提示「取得帳戶 4567 的訊息 ID 1234 的電子郵件詳細資料」
取得電子郵件附件內容	擷取電子郵件中附件的內容，並根據帳戶 ID、訊息 ID 和附件 ID 下載檔案。
取得電子郵件附件資訊	根據帳戶 ID 和郵件 ID 擷取特定電子郵件的附件資訊
搜尋電子郵件	此端點會根據搜尋參數列出指定帳戶 ID 的電子郵件，這些參數會顯示訊息 ID、摘要、傳送者、寄件者名稱和寄件者等資訊。使用者依主旨、電子郵件內容或寄件者輸入關鍵字，作為指定帳戶的搜尋參數。

傳送電子郵件

作業識別碼：: Send_Mail

從指定的電子郵件地址傳送新電子郵件

參數

名稱	機碼	必要	類型	Description
Account	account_id	True	string	選擇使用者帳戶或指定帳戶 ID
寄件者	fromAddress	True	string	指定寄件者電子郵件地址
發往	toAddress	True	string	指定以逗號分隔的收件者電子郵件地址
CC	ccAddress		string	指定逗號分隔的抄送電子郵件地址
密件副本	bccAddress		string	指定逗號分隔的密件副本電子郵件地址
主旨	subject		string	指定電子郵件主旨
電子郵件內容	content		html	指定電子郵件內容
詢問收據	askReceipt		string	指電子郵件已讀回執
郵件格式	mailFormat		string	指定電子郵件格式
內容	attachmentContent		byte	檔案內容
名稱	attachmentName		string	輸入附件名稱

傳回

名稱	路徑	類型	Description
詢問收據	data.askReceipt	string	指電子郵件已讀回執
主旨	data.subject	string	電子郵件主旨
訊息 ID	data.messageId	string	電子郵件的唯一識別碼
寄件者	data.fromAddress	string	寄件者電子郵件地址
密件副本	data.bccAddress	string	以逗號分隔的密件副本電子郵件地址
郵件格式	data.mailFormat	string	電子郵件格式
發往	data.toAddress	string	逗號分隔的電子郵件地址
電子郵件內容	data.content	string	電子郵件內容
CC	data.ccAddress	string	以逗號分隔的抄送電子郵件地址

儲存草稿或範本

作業識別碼：: Save_Draft

將電子郵件內容儲存為草稿或範本

參數

名稱	機碼	必要	類型	Description
Account	account_id	True	string	選擇使用者帳戶或指定帳戶 ID
另存新檔	mode	True	string	選擇 [類型] 以儲存草稿或範本
寄件者	fromAddress	True	string	指定寄件者電子郵件地址
發往	toAddress	True	string	指定以逗號分隔的收件者電子郵件地址
CC	ccAddress		string	指定逗號分隔的抄送電子郵件地址
密件副本	bccAddress		string	指定逗號分隔的密件副本電子郵件地址
主旨	subject		string	指定電子郵件主旨
電子郵件內容	content		html	指定電子郵件內容
詢問收據	askReceipt		string	指電子郵件已讀回執
郵件格式	mailFormat		string	指定電子郵件格式
內容	attachmentContent		byte	指定電子郵件內容
名稱	attachmentName		string	指定附件的名稱

傳回

名稱	路徑	類型	Description
主旨	data.subject	string	電子郵件主旨
訊息 ID	data.messageId	string	電子郵件的唯一識別碼
寄件者	data.fromAddress	string	寄件者電子郵件地址
密件抄送	data.bccAddress	string	以逗號分隔的密件副本電子郵件地址
郵件格式	data.mailFormat	string	電子郵件格式
發往	data.toAddress	string	逗號分隔的電子郵件地址
郵件內文	data.content	string	電子郵件內容
CC	data.ccAddress	string	以逗號分隔的抄送電子郵件地址

取得寄件者清單

作業識別碼：: Get_Sender_Details

取得所有電子郵件寄件者的清單

參數

名稱	機碼	必要	類型	Description
Account	account_id	True	string	選擇使用者帳戶或指定帳戶 ID

傳回

名稱	路徑	類型	Description
發送郵件詳細資料	sendMailDetails	array of object	發送郵件詳細資料
發送郵件識別碼	sendMailDetails.sendMailId	string	發送郵件識別碼
顯示名稱	sendMailDetails.displayName	string	顯示名稱
已驗證	sendMailDetails.validated	boolean	已驗證
fromAddress	sendMailDetails.fromAddress	string	fromAddress
狀態	sendMailDetails.status	boolean	狀態

取得帳戶詳細資料

作業識別碼：: Get_Mail_Account

此端點會取得目前已驗證使用者的帳戶詳細資料，例如其帳戶識別碼和帳戶顯示名稱。範例提示為「取得我的郵件帳戶詳細資料」（外掛程式會以擷取的帳戶 ID 和帳戶顯示名稱回應）。

傳回

名稱	路徑	類型	Description
資料	data	array of object	資料
帳戶識別碼	data.accountId	string	帳戶的唯一識別碼
帳戶顯示名稱	data.accountDisplayName	string	帳戶的顯示名稱。

取得標籤

作業識別碼：: Get_All_Label

此端點會根據帳戶 ID 取得指定使用者帳戶的所有標籤的詳細資訊，例如標籤 ID 和標籤名稱。使用者輸入帳戶 ID 作為輸入。提示「顯示帳戶 1234 的所有標籤」，操作會擷取與帳戶 1234 關聯的所有標籤。

參數

名稱	機碼	必要	類型	Description
Account	account_id	True	string	選擇使用者帳戶或指定帳戶 ID

傳回

名稱	路徑	類型	Description
資料	data	array of object	資料
標籤 ID	data.labelId	string	標籤的唯一識別碼
標籤名稱	data.displayName	string	標籤的名稱。

取得資料夾

作業識別碼：: Get_All_Folder

此端點會根據帳戶識別碼取得指定使用者帳戶所有資料夾的詳細資料，例如資料夾識別碼和資料夾名稱。使用者輸入帳戶 ID 作為輸入。範例提示「列出帳戶 1234 的所有資料夾」，作業會擷取與帳戶 1234 相關聯的所有資料夾。

參數

名稱	機碼	必要	類型	Description
Account	account_id	True	string	選擇使用者帳戶或指定帳戶 ID

傳回

名稱	路徑	類型	Description
資料	data	array of object	資料
資料夾名稱	data.folderName	string	資料夾的名稱
資料夾 ID	data.folderId	string	資料夾的唯一識別碼

取得電子郵件詳細資料

作業識別碼：: Get_Email_Content

此端點會根據帳戶識別碼和訊息識別碼取得電子郵件詳細資料，例如訊息識別碼、摘要、電子郵件內容、傳送者、寄件者名稱和寄件者。此作業會採用訊息 ID 和帳戶 ID 作為輸入。範例提示「取得帳戶 4567 的訊息 ID 1234 的電子郵件詳細資料」

參數

名稱	機碼	必要	類型	Description
Account	account_id	True	string	選擇使用者帳戶或指定帳戶 ID
訊息 ID	message_id	True	string	電子郵件的唯一識別碼

傳回

名稱	路徑	類型	Description
總結	data.summary	string	在電子郵件清單中顯示電子郵件摘要
發送	data.sentDateInGMT	string	電子郵件的傳送時間（GMT）
主旨	data.subject	string	電子郵件主旨
訊息 ID	data.messageId	string	電子郵件的唯一識別碼
Priority	data.priority	string	為電子郵件設定的優先順序
有內聯	data.hasInline	string	電子郵件有內嵌
發往	data.toAddress	string	以逗號分隔的收件者電子郵件地址
資料夾 ID	data.folderId	string	資料夾的唯一識別碼
CC	data.ccAddress	string	以逗號分隔的副本電子郵件地址
有依戀	data.hasAttachment	string	電子郵件有附件
大小	data.size	string	電子郵件總大小
寄件者名稱	data.sender	string	傳送者
接收時間	data.receivedTime	string	電子郵件的接收時間
寄件者	data.fromAddress	string	寄件者電子郵件地址
讀取狀態	data.status	string	電子郵件的已讀或未讀狀態
電子郵件內容	data.content	string	電子郵件內容

取得電子郵件附件內容

作業識別碼：: Get_Email_Attachment_Content

擷取電子郵件中附件的內容，並根據帳戶 ID、訊息 ID 和附件 ID 下載檔案。

參數

名稱	機碼	必要	類型	Description
Account	account_id	True	string	選擇使用者帳戶或指定帳戶 ID
訊息 ID	message_id	True	string	電子郵件的唯一識別碼
附件 ID	attachment_id	True	string	指定附件 ID

傳回

檔案內容

檔案: binary

取得電子郵件附件資訊

作業識別碼：: Get_Email_Attachment_Info

根據帳戶 ID 和郵件 ID 擷取特定電子郵件的附件資訊

參數

名稱	機碼	必要	類型	Description
Account	account_id	True	string	選擇使用者帳戶或指定帳戶 ID
訊息 ID	message_id	True	string	電子郵件的唯一識別碼

傳回

名稱	路徑	類型	Description
attachments	data.attachments	array of object
附件尺寸	data.attachments.attachmentSize	integer	附件的大小（以位元組為單位）
附件名稱	data.attachments.attachmentName	string	附件名稱
附件 ID	data.attachments.attachmentId	string	附件的唯一識別碼
訊息 ID	data.messageId	string	電子郵件的唯一識別碼

搜尋電子郵件

作業識別碼：: Search_Mail

此端點會根據搜尋參數列出指定帳戶 ID 的電子郵件，這些參數會顯示訊息 ID、摘要、傳送者、寄件者名稱和寄件者等資訊。使用者依主旨、電子郵件內容或寄件者輸入關鍵字，作為指定帳戶的搜尋參數。

參數

名稱	機碼	必要	類型	Description
Account	account_id	True	string	選擇使用者帳戶或指定帳戶 ID
開始搜尋	start	True	integer	郵件搜尋開始於
搜尋限制	limit	True	integer	擷取郵件的限制
整封電子郵件	entire		string	在電子郵件的任何部分指定搜尋字詞
電子郵件內容	content		string	在核心電子郵件內容中指定搜尋字詞
寄件者	sender		string	指定搜尋字詞或電子郵件地址
發往	to		string	指定搜尋字詞或電子郵件地址
CC	cc		string	指定搜尋字詞或電子郵件地址
主旨	subject		string	在電子郵件主旨中指定搜尋字詞
附件名稱	fileName		string	在附件名稱中指定搜尋字詞
附件內容	fileContent		string	在附件內容中指定搜尋字詞
從日期開始	fromDate		date	搜尋指定日期的電子郵件
迄今為止	toDate		date	搜尋指定日期之前的電子郵件
小組結果	groupResult		boolean	指定是否應將相同交談的電子郵件分組。
資料夾	in		string	選擇資料夾或指定資料夾 ID 以搜尋電子郵件。
標籤	label		string	選擇標籤或指定標籤 ID 以搜尋電子郵件。

傳回

名稱	路徑	類型	Description
回應碼	status.code	integer	成功和失敗 API 請求的回應代碼。
資料	data	array of object	資料
總結	data.summary	string	在電子郵件清單中顯示電子郵件摘要
發送	data.sentDateInGMT	string	電子郵件的傳送時間（GMT）
主旨	data.subject	string	電子郵件主旨
訊息 ID	data.messageId	string	電子郵件的唯一識別碼
有內聯	data.hasInline	string	電子郵件有內嵌
發往	data.toAddress	string	以逗號分隔的收件者電子郵件地址
資料夾 ID	data.folderId	string	資料夾的唯一識別碼
CC	data.ccAddress	string	以逗號分隔的副本電子郵件地址
有依戀	data.hasAttachment	string	電子郵件有附件
大小	data.size	string	電子郵件總大小
寄件者名稱	data.sender	string	寄件者的名稱。
接收時間	data.receivedTime	string	電子郵件的接收時間
寄件者	data.fromAddress	string	寄件者電子郵件地址
讀取狀態	data.status	string	電子郵件的已讀或未讀狀態

觸發程序

依條件取得新郵件	當符合指定條件時接收新的電子郵件通知。
從指定用戶獲取郵件通知	接收來自指定使用者的新電子郵件通知。

依條件取得新郵件

作業識別碼：: NEW_CONDITIONAL_MAIL

當符合指定條件時接收新的電子郵件通知。

參數

名稱	機碼	必要	類型	Description
Account	accId	True	string	已設定的使用者帳戶
選擇條件	lhs	True	string	選擇欄位
選擇運運算元	operator	True	string	操作員
輸入值	rhs	True	string	要檢查的值

傳回

名稱	路徑	類型	Description
總結	summary	string	在電子郵件清單中顯示電子郵件摘要
發送	sentDateInGMT	integer	電子郵件的傳送時間（GMT）
主旨	subject	string	電子郵件主旨
訊息 ID	messageId	integer	電子郵件的唯一識別碼
發往	toAddress	string	以逗號分隔的收件者電子郵件地址
CC	ccAddress	string	以逗號分隔的抄送電子郵件地址
大小	size	integer	電子郵件大小
寄件者	sender	string	電子郵件寄件者的名稱
接收時間	receivedTime	integer	電子郵件的接收時間
寄件者	fromAddress	string	寄件者電子郵件地址
身體	html	string	電子郵件內容

從指定用戶獲取郵件通知

作業識別碼：: New_Mail_Trigger

接收來自指定使用者的新電子郵件通知。

參數

名稱	機碼	必要	類型	Description
Account	accId	True	string	已設定的使用者帳戶
傳送者	criterias	True	string	指定寄件者電子郵件地址

傳回

名稱	路徑	類型	Description
總結	summary	string	在電子郵件清單中顯示電子郵件摘要
發送	sentDateInGMT	integer	電子郵件的傳送時間（GMT）
主旨	subject	string	電子郵件主旨
訊息 ID	messageId	integer	電子郵件的唯一識別碼
發往	toAddress	string	以逗號分隔的收件者電子郵件地址
CC	ccAddress	string	以逗號分隔的抄送電子郵件地址
大小	size	integer	電子郵件大小
寄件者	sender	string	電子郵件寄件者的名稱
接收時間	receivedTime	integer	電子郵件的接收時間
寄件者	fromAddress	string	寄件者電子郵件地址
身體	html	string	電子郵件內容

定義

二進位

這是基本數據類型『binary』。

共用方式為