电子邮件连接器允许您包含 发送电子邮件 命令 以将电子邮件作为链的一部分发送。此命令使用简单邮件传输协议 (SMTP) 发送电子邮件。身份验证可以使用基本身份验证或 OAuth2 身份验证。该电子邮件可以包含来自链中先前命令的更多上下文,以实现更强大的自动化。
SMTP 先决条件
要使用电子邮件连接器,您的组织需要有关其电子邮件提供商(例如 Gmail® 或 Microsoft® Office 365®)的 SMTP 服务器的详细信息。
要设置连接器,您需要:
- SMTP服务器的主机名
- SMTP 服务器用于发送电子邮件的端口
- 如果 SMTP 服务器需要,则需要 HELO 域
- 如果 SMTP 服务器需要身份验证,则连接器应使用集成用户的用户名和密码进行身份验证。
OAuth2 先决条件
在使用 OAuth2 安全性之前,必须具备并实施以下各项。
Azure Elements
您必须具备:
- 既有Microsoft Azure帐户,也有 Azure 帐户密钥。
- 在 Azure 中设置 授权码流 。
- 在 Azure 中配置了 Exchange Online 服务 。
-
在 Azure 中设置授权码流程时,请设置正确的 重定向 URI 。
环境 重定向 URI 亚太地区产品 https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback 欧盟产品 https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback 美国产品 https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
有关获取和实施这些先决条件的说明,请参阅 Microsoft Azure 文档 。
Workiva元素
设置电子邮件连接器
注意: 要使连接器可在您组织的链中使用, 组织安全管理员必须从配置启用它。
- 从 链构建器中,单击 连接,然后单击右上角的 创建 。
- 在 连接器连接下,选择 电子邮件 和默认的 CloudRunner。
- 请输入唯一的名称 和描述 以帮助识别连接。
-
在 属性下,输入连接的详细信息:
摘要信息 详细信息 主机名 请输入SMTP服务器的主机名:
- 对于 Gmail,这
通常是 smtp.gmail.com。 - 对于 Microsoft 365,这
通常是 smtp.office365.com。 - 对于 Mailgun,这
通常是 smtp.mailgun.org。
港口 输入服务器运行的端口。
默认的 SMTP 端口通常是587,但也可能是25。已启用 TLS 如果使用需要通过传输层进行加密通信的安全 SMTP 服务器,请将安全/安全套接字层 (TLS/SSL) 设置为 已启用。 HELO 域 如果 SMTP 服务器要求,请输入用于确保成功握手的 HELO 域。 注意:所有敏感凭证均使用高级加密标准 (AES ) -256 加密自动加密
并存储。 - 对于 Gmail,这
-
在 身份验证下,选择要使用的身份验证类型,并输入验证 API 调用所需的信息。所需信息取决于您选择的身份验证类型。
基本身份验证
摘要信息 详细信息 用户名 如果 SMTP 服务器使用基本身份验证,请输入连接器集成用户的用户名。 密码 如果 SMTP 服务器需要基本身份验证,请输入与用户名关联的密码。 适用于 Microsoft Office 365 电子邮件 OAuth2
摘要信息 详细信息 用户名 这是用于访问 SMTP 服务器的用户名。 租户 ID 这是您的 Microsoft 租户的 ID 字符串。 客户ID 这是您希望 API 使用的密钥的客户端 ID。 客户机密 这是 API 使用的密钥的客户端密钥。 - 点击 连接。
- 选择要使用连接的环境,然后单击 保存。
- 要测试连接, 创建并运行一个链 使用 连接器的“发送电子邮件”命令向您自己的电子邮件地址发送电子邮件,并验证它是否返回有效输出。
疑难解答
如果连接器无法发送电子邮件:
- 请确认您的电子邮件服务提供商的 SMTP 服务器的主机名和端口是否正确。
- 请确认 SMTP 服务器域类型是否正确(TLS 或 HELO)。
- 如果使用基本身份验证,请验证用户名和密码是否正确。
- 如果使用 OAuth2 身份验证,请验证:
- ClientID 和 Client Secret 的值是正确的。
- 在 Azure 中生成客户端 ID 和客户端密钥值时, 重定向 URI 是正确的。
- 请验证为 发送电子邮件 命令的 收件人、 抄送和 密送 输入的收件人电子邮件地址是否正确。