通过

Zoho Mail

Zoho Mail 是一种安全可靠的业务电子邮件解决方案。 Zoho Mail 连接器可帮助你管理电子邮件并执行作，例如将电子邮件另存为草稿、接收电子邮件，以及在新电子邮件到达时触发流。 Zoho Mail 连接器让你能够管理电子邮件并执行作，例如将电子邮件另存为草稿、接收电子邮件，并在新电子邮件到达时触发流。

此连接器在以下产品和区域中可用：

服务 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 Zoho Mail
URL https://www.zoho.com/mail/contact.html
Email zmintegration@zohomail.com
连接器元数据
发布者 佐浩公司私人有限公司
Website https://www.zoho.com/mail/
隐私策略 https://www.zoho.com/privacy.html
类别 Communication

Zoho Mail 是一种安全可靠的业务电子邮件解决方案。 Zoho Mail 连接器可帮助你管理电子邮件并执行作，例如将电子邮件另存为草稿、接收电子邮件，以及在新电子邮件到达时触发流。 Zoho Mail 连接器让你能够管理电子邮件并执行作，例如将电子邮件另存为草稿、接收电子邮件，并在新电子邮件到达时触发流。

发布者：Zoho Corporation

先决条件

已验证的 Zoho Mail 帐户。 单击此处创建第一个帐户。

如何获取凭据

创建新连接时，

  • 选择 Zoho 帐户所在的域。
  • 输入 Zoho Mail 凭据。
  • 即使 Power App 与另一个用户共享，他们也应该创建新的连接以开始使用它。

Zoho Mail API 使用 OAuth2.0 进行身份验证，因此在设置帐户后不需要辅助身份验证。

连接器入门

按照以下步骤连接到 Zoho Mail：

  • 登录到 Power Automate 帐户，然后单击左侧菜单中的“创建”。
  • 可以选择创建云流、桌面流或业务流。 若要连接到 Zoho Mail，请选择自动化云流。
  • 可以创建流/模板。
  • 为流/模板选择“发送邮件/发送模板邮件”。
  • 输入相应作的所需值。

已知问题和限制

  • 电子邮件总大小（包括电子邮件标头、正文内容、内联图像和附件）不应超过计划限制。
  • Zoho Mail 不能用于发送违反 Zoho Mail 使用策略的批量电子邮件和其他电子邮件。 单击此处了解更多详细信息。

常见错误和补救措施

若要避免身份验证错误，请选择托管 Zoho Mail 帐户的域。

FAQ

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

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
选择 Zoho 帐户数据所在的区域。 字符串 选择域。 True

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

保存草稿或模板

将电子邮件内容另存为草稿或模板
发送电子邮件

从指定的电子邮件地址发送新电子邮件
搜索电子邮件

此终结点根据搜索参数列出指定帐户 ID 的电子邮件，这些参数显示消息 ID、摘要、已发送、发件人名称和发件人姓名等信息。 用户按主题、电子邮件内容或发件人输入关键字作为指定帐户的搜索参数。
获取发件人列表

获取所有电子邮件发件人的列表
获取帐户详细信息

此终结点获取当前经过身份验证的用户的帐户详细信息，例如其帐户 ID 和帐户显示名称。 示例提示为“获取我的邮件帐户详细信息”（插件将响应检索到的帐户 ID 和帐户显示名称）。
获取文件夹

此终结点根据帐户 ID 获取指定用户帐户的所有文件夹的详细信息，例如文件夹 ID 和文件夹名称。 用户输入帐户 ID 作为输入。 示例提示“列出帐户 1234 的所有文件夹”，作将检索与帐户 1234 关联的所有文件夹。
获取标签

此终结点根据帐户 ID 获取指定用户帐户的所有标签的详细信息，例如标签 ID 和标签名称。 用户输入帐户 ID 作为输入。 提示“显示帐户 1234 的所有标签”，作将检索与帐户 1234 关联的所有标签。
获取电子邮件详细信息

此终结点基于帐户 ID 和邮件 ID（如邮件 ID、摘要、电子邮件内容、发送者姓名和发件人）获取电子邮件详细信息。 该作将消息 ID 和帐户 ID 作为输入。 示例提示“获取帐户 4567 的邮件 ID 1234 的电子邮件详细信息”
获取电子邮件附件信息

根据帐户 ID 和邮件 ID 检索特定电子邮件的附件信息
获取电子邮件附件内容

检索电子邮件中附件的内容，并根据帐户 ID、邮件 ID 和附件 ID 下载文件。

保存草稿或模板

操作 ID:
Save_Draft

将电子邮件内容另存为草稿或模板

参数

名称 密钥 必需 类型 说明
帐户
 account_id True string

选择用户帐户或指定帐户 ID
另存为
 mode True string

选择类型以保存草稿或模板
来自
 fromAddress True string

指定发件人电子邮件地址
到
 toAddress True string

指定逗号分隔的收件人电子邮件地址
CC
 ccAddress string

指定逗号分隔的抄送电子邮件地址
BCC
 bccAddress string

指定逗号分隔的密件抄送电子邮件地址
Subject
 subject string

指定电子邮件主题
电子邮件内容
 content html

指定电子邮件内容
询问回执
 askReceipt string

指已读回执的电子邮件
邮件格式
 mailFormat string

指定电子邮件格式
内容
 attachmentContent byte

指定电子邮件内容
姓名
 attachmentName string

指定附件的名称

返回

名称 路径 类型 说明
Subject
 data.subject string

电子邮件主题
消息 ID
 data.messageId string

电子邮件的唯一标识符
来自
 data.fromAddress string

发件人电子邮件地址
Bcc
 data.bccAddress string

逗号分隔的密件抄送电子邮件地址
邮件格式
 data.mailFormat string

电子邮件格式
到
 data.toAddress string

逗号分隔的电子邮件地址
邮件正文
 data.content string

电子邮件内容
CC
 data.ccAddress string

逗号分隔的抄送电子邮件地址

发送电子邮件

操作 ID:
Send_Mail

从指定的电子邮件地址发送新电子邮件

参数

名称 密钥 必需 类型 说明
帐户
 account_id True string

选择用户帐户或指定帐户 ID
来自
 fromAddress True string

指定发件人电子邮件地址
到
 toAddress True string

指定逗号分隔的收件人电子邮件地址
CC
 ccAddress string

指定逗号分隔的抄送电子邮件地址
BCC
 bccAddress string

指定逗号分隔的密件抄送电子邮件地址
Subject
 subject string

指定电子邮件主题
电子邮件内容
 content html

指定电子邮件内容
询问回执
 askReceipt string

指已读回执的电子邮件
邮件格式
 mailFormat string

指定电子邮件格式
内容
 attachmentContent byte

文件的内容
姓名
 attachmentName string

输入附件名称

返回

名称 路径 类型 说明
询问回执
 data.askReceipt string

指已读回执的电子邮件
Subject
 data.subject string

电子邮件主题
消息 ID
 data.messageId string

电子邮件的唯一标识符
来自
 data.fromAddress string

发件人电子邮件地址
BCC
 data.bccAddress string

逗号分隔的密件抄送电子邮件地址
邮件格式
 data.mailFormat string

电子邮件格式
到
 data.toAddress string

逗号分隔的电子邮件地址
电子邮件内容
 data.content string

电子邮件内容
CC
 data.ccAddress string

逗号分隔的抄送电子邮件地址

搜索电子邮件

操作 ID:
Search_Mail

此终结点根据搜索参数列出指定帐户 ID 的电子邮件，这些参数显示消息 ID、摘要、已发送、发件人名称和发件人姓名等信息。 用户按主题、电子邮件内容或发件人输入关键字作为指定帐户的搜索参数。

参数

名称 密钥 必需 类型 说明
帐户
 account_id True string

选择用户帐户或指定帐户 ID
开始搜索
 start True integer

邮件搜索从
搜索限制
 limit True integer

要提取的邮件限制
整个电子邮件
 entire string

在电子邮件的任何部分指定搜索词
电子邮件内容
 content string

在核心电子邮件内容中指定搜索词
来自
 sender string

指定搜索词或电子邮件地址
到
 to string

指定搜索词或电子邮件地址
CC
 cc string

指定搜索词或电子邮件地址
Subject
 subject string

在电子邮件主题中指定搜索词
附件名称
 fileName string

在附件名称中指定搜索词
附件内容
 fileContent string

在附件内容中指定搜索词
从日期起
 fromDate date

从指定日期搜索电子邮件
至今
 toDate date

在指定日期之前搜索电子邮件
分组结果
 groupResult boolean

指定是否应对同一对话的电子邮件进行分组。
文件夹
 in string

选择文件夹或指定要搜索电子邮件的文件夹 ID。
标签
 label string

选择标签或指定要搜索电子邮件的标签 ID。

返回

名称 路径 类型 说明
响应代码
 status.code integer

成功和失败 API 请求的响应代码。
数据
 data array of object

数据
概要
 data.summary string

在电子邮件列表中显示电子邮件摘要
发送日期
 data.sentDateInGMT string

电子邮件在 GMT 发送的时间
Subject
 data.subject string

电子邮件主题
消息 ID
 data.messageId string

电子邮件的唯一标识符
内联
 data.hasInline string

电子邮件内联
到
 data.toAddress string

逗号分隔的收件人电子邮件地址
文件夹 ID
 data.folderId string

文件夹的唯一标识符
CC
 data.ccAddress string

逗号分隔的 CC 电子邮件地址
具有附件
 data.hasAttachment string

电子邮件包含附件
尺寸
 data.size string

电子邮件总大小
发件人名称
 data.sender string

发件人的名称。
接收时间
 data.receivedTime string

电子邮件的接收时间
来自
 data.fromAddress string

发件人电子邮件地址
读取状态
 data.status string

电子邮件的已读或未读状态

获取发件人列表

操作 ID:
Get_Sender_Details

获取所有电子邮件发件人的列表

参数

名称 密钥 必需 类型 说明
帐户
 account_id True string

选择用户帐户或指定帐户 ID

返回

名称 路径 类型 说明
sendMailDetails
 sendMailDetails array of object

sendMailDetails
sendMailId
 sendMailDetails.sendMailId string

sendMailId
displayName
 sendMailDetails.displayName string

displayName
验证
 sendMailDetails.validated boolean

验证
fromAddress
 sendMailDetails.fromAddress string

fromAddress
状态
 sendMailDetails.status boolean

状态

获取帐户详细信息

操作 ID:
Get_Mail_Account

此终结点获取当前经过身份验证的用户的帐户详细信息，例如其帐户 ID 和帐户显示名称。 示例提示为“获取我的邮件帐户详细信息”（插件将响应检索到的帐户 ID 和帐户显示名称）。

返回

名称 路径 类型 说明
数据
 data array of object

数据
帐户 ID
 data.accountId string

帐户的唯一标识符
帐户显示名称
 data.accountDisplayName string

帐户的显示名称。

获取文件夹

操作 ID:
Get_All_Folder

此终结点根据帐户 ID 获取指定用户帐户的所有文件夹的详细信息，例如文件夹 ID 和文件夹名称。 用户输入帐户 ID 作为输入。 示例提示“列出帐户 1234 的所有文件夹”，作将检索与帐户 1234 关联的所有文件夹。

参数

名称 密钥 必需 类型 说明
帐户
 account_id True string

选择用户帐户或指定帐户 ID

返回

名称 路径 类型 说明
数据
 data array of object

数据
文件夹名称
 data.folderName string

文件夹的名称
文件夹 ID
 data.folderId string

文件夹的唯一标识符

获取标签

操作 ID:
Get_All_Label

此终结点根据帐户 ID 获取指定用户帐户的所有标签的详细信息，例如标签 ID 和标签名称。 用户输入帐户 ID 作为输入。 提示“显示帐户 1234 的所有标签”，作将检索与帐户 1234 关联的所有标签。

参数

名称 密钥 必需 类型 说明
帐户
 account_id True string

选择用户帐户或指定帐户 ID

返回

名称 路径 类型 说明
数据
 data array of object

数据
标签 ID
 data.labelId string

标签的唯一标识符
标签名称
 data.displayName string

标签的名称。

获取电子邮件详细信息

操作 ID:
Get_Email_Content

此终结点基于帐户 ID 和邮件 ID（如邮件 ID、摘要、电子邮件内容、发送者姓名和发件人）获取电子邮件详细信息。 该作将消息 ID 和帐户 ID 作为输入。 示例提示“获取帐户 4567 的邮件 ID 1234 的电子邮件详细信息”

参数

名称 密钥 必需 类型 说明
帐户
 account_id True string

选择用户帐户或指定帐户 ID
消息 ID
 message_id True string

电子邮件的唯一标识符

返回

名称 路径 类型 说明
概要
 data.summary string

在电子邮件列表中显示电子邮件摘要
发送日期
 data.sentDateInGMT string

电子邮件在 GMT 发送的时间
Subject
 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

逗号分隔的 CC 电子邮件地址
具有附件
 data.hasAttachment string

电子邮件包含附件
尺寸
 data.size string

电子邮件总大小
发件人名称
 data.sender string

发送方
接收时间
 data.receivedTime string

电子邮件的接收时间
来自
 data.fromAddress string

发件人电子邮件地址
读取状态
 data.status string

电子邮件的已读或未读状态
电子邮件内容
 data.content string

电子邮件内容

获取电子邮件附件信息

操作 ID:
Get_Email_Attachment_Info

根据帐户 ID 和邮件 ID 检索特定电子邮件的附件信息

参数

名称 密钥 必需 类型 说明
帐户
 account_id True string

选择用户帐户或指定帐户 ID
消息 ID
 message_id True string

电子邮件的唯一标识符

返回

名称 路径 类型 说明
attachments
 data.attachments array of object
附件大小
 data.attachments.attachmentSize integer

附件的大小（以字节为单位）
附件名称
 data.attachments.attachmentName string

附件的名称
附件 ID
 data.attachments.attachmentId string

附件的唯一标识符
消息 ID
 data.messageId string

电子邮件的唯一标识符

获取电子邮件附件内容

操作 ID:
Get_Email_Attachment_Content

检索电子邮件中附件的内容，并根据帐户 ID、邮件 ID 和附件 ID 下载文件。

参数

名称 密钥 必需 类型 说明
帐户
 account_id True string

选择用户帐户或指定帐户 ID
消息 ID
 message_id True string

电子邮件的唯一标识符
附件 ID
 attachment_id True string

指定附件 ID

返回

文件的内容

文件
binary

触发器

从指定用户获取邮件通知

接收来自指定用户的新电子邮件通知。
按条件获取新邮件

满足指定条件时接收新的电子邮件通知。

从指定用户获取邮件通知

操作 ID:
New_Mail_Trigger

接收来自指定用户的新电子邮件通知。

参数

名称 密钥 必需 类型 说明
帐户
 accId True string

配置的用户帐户
发送方
 criterias True string

指定发件人电子邮件地址

返回

名称 路径 类型 说明
概要
 summary string

在电子邮件列表中显示电子邮件摘要
发送日期
 sentDateInGMT integer

电子邮件在 GMT 发送的时间
Subject
 subject string

电子邮件主题
消息 ID
 messageId integer

电子邮件的唯一标识符
到
 toAddress string

逗号分隔的收件人电子邮件地址
CC
 ccAddress string

逗号分隔的抄送电子邮件地址
尺寸
 size integer

电子邮件大小
发送方
 sender string

电子邮件发件人的名称
接收时间
 receivedTime integer

电子邮件的接收时间
来自
 fromAddress string

发件人电子邮件地址
Body
 html string

电子邮件内容

按条件获取新邮件

操作 ID:
NEW_CONDITIONAL_MAIL

满足指定条件时接收新的电子邮件通知。

参数

名称 密钥 必需 类型 说明
帐户
 accId True string

配置的用户帐户
选择条件
 lhs True string

选择字段
Choose 运算符
 operator True string

操作员
输入值
 rhs True string

要检查的值

返回

名称 路径 类型 说明
概要
 summary string

在电子邮件列表中显示电子邮件摘要
发送日期
 sentDateInGMT integer

电子邮件在 GMT 发送的时间
Subject
 subject string

电子邮件主题
消息 ID
 messageId integer

电子邮件的唯一标识符
到
 toAddress string

逗号分隔的收件人电子邮件地址
CC
 ccAddress string

逗号分隔的抄送电子邮件地址
尺寸
 size integer

电子邮件大小
发送方
 sender string

电子邮件发件人的名称
接收时间
 receivedTime integer

电子邮件的接收时间
来自
 fromAddress string

发件人电子邮件地址
Body
 html string

电子邮件内容

定义

二进制

这是基本数据类型“binary”。