请输入
菜单

邮箱通道

NXLINK 支持基于IMAP和SMTP协议的邮件服务器,如基于传统帐号密码(或者Gmail授权码)和OAuth2.0 (微软Office365),本文主要是针对Google GMail和微软Office365的配置方式介绍如何配置配置。

一、Gmail邮箱

1、登录GMAIL邮箱,点击:头像。

2、选择:管理您的 Google 账号。

3、选择:安全性。

4、点击:两步验证,并开启两步验证。

5、开启两步验证后,进入两步验证。搜索应用专用密码,点击进入设置。

6、选择应用专用密码。

7、输入专用密码名称,点击创建生成。

8、复制生成的专用密码。

9、回到 Gmail 页面,点击:设置,选择查看所有设置。

10、选择:转发和POP/IMAP。

11、启用:启用IMAP。

12、点击保存。

13、请回到NXLink系统,输入第8步生成的专用密码即可。

除了邮件地址,发件人邮箱,密码/邮箱授权码之外,还需要填写处理该邮箱分配的坐席组。

二、微软Office365邮箱

微软Office 365邮箱支持基于OAuth 2.0的认证协议连接SMTP/IMAP实现邮件的首发功能,官方详细的OAuth 配置文档请参考微软官方文档:

https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth

  1. 在 Azure 门户创建注册应用
    • 登录Microsoft Entra Admin Center: https://entra.microsoft.com/#home

   可以获取租户ID(Tenant ID)信息,NXLINK需要配置租户ID。

    • 创建注册新应用(一个租户创建一个即可,多帐号可以共享一个应用)

需要创建和记录Application(Client)ID 和 Client Crendential, 在NXLINK创建邮件渠道需要使用。

点击Client Crendential,可以建立多个密钥,只有在创建密钥的时候才可以看到完整的密钥,需要在当时就保存下来在配置的时候使用,密钥是下图的Value(不是Secret ID), 如果丢失了密钥可以重新创建。要注意有效期,在过期前需要重新建立一个的Client Secret。

2. 添加IMAP/SMTP API的权限

在App Registrations - 新建应用 - API Permissions,需要给新建立的应用赋予IMAP和SMTP的访问权限。

IMAP.AccessAsApp和SMTP.AccessAsApp的权限是需要企业邮箱服务器管理员权限来授权才可以使用,需要企业邮件管理员登陆到Azure门户找到相应的应用并授权。

3. 在Exchange 中注册服务主体

租户管理员同意Microsoft Entra应用程序后,必须通过 Exchange Online PowerShell 在 Exchange 中注册 Entra 应用程序的服务主体。 此注册由 New-ServicePrincipal cmdlet 启用。(需要安装power shell, 并进入pwsh)

若要使用 New-ServicePrincipal cmdlet,请安装 ExchangeOnlineManagement 并连接到租户,如以下代码片段所示:

Install-Module -Name ExchangeOnlineManagement
Import-module ExchangeOnlineManagement 

用租户管理员的账号登陆, 赋予相关需要用IMAP/SMTP接收和发送邮件的权限。

# 1. Connect to Exchange Online
Connect-ExchangeOnline -UserPrincipalName admin@xxx.com

# 2. Register the Service Principal
# Replace <OBJECT_ID> with the Enterprise Application Object ID from Step 1
#New-ServicePrincipal -AppId <APPLICATION_ID> -ObjectId <OBJECT_ID> 
New-ServicePrincipal -AppId "c765b7e6-XXXX-XXXX-XXXX-09b8a81c4f0a" -ObjectId "50b86ffa-XXXX-XXXX-XXXX-347beb41cfd7" -DisplayName "Office365 Mail Service"

# 3. Get the Service Principal Identity
Get-ServicePrincipal | fl

# 4. Grant mailbox access (use the Identity from step 4)
# Add-MailboxPermission -Identity "john.smith@contoso.com" -User 
<SERVICE_PRINCIPAL_ID> -AccessRights FullAccess
Add-MailboxPermission -Identity "xxx@xxx.com" -User "50b86ffa-XXXX-XXXX-XXXX-347beb41cfd7" -AccessRights FullAccess

# 6. Verify
Get-MailboxPermission -Identity "xxx@xxx.com"

# 7. Disconnect
Disconnect-ExchangeOnline -Confirm:$false

<OBJECT_ID>和<SERVICE_PRINCIPAL_ID>是企业应用程序节点的“概述”页中的对象 ID, (Azure 门户) 应用程序注册。 它不是 “应用注册”节点的“概述”页中的“对象 ID”。 使用不正确的对象 ID 将导致身份验证失败。

通过Azure Entra admin Center -> Enterprise apps-> All applications,找到之前配置的应用,可以获取相应的Object ID.

当以上操作执行完成之后就可以进入NXLINK 配置邮件渠道了。

4. 登录NXLINK 系统配置电子邮件渠道

根据前面步骤配置获得的租户ID、应用程序ID和客户端密钥配置到相关设置里即可,同时选择需要处理电电子邮件的坐席组。

上一个
如何集成Messenger
下一个
在线聊天渠道
最近修改: 2026-04-17