跳到主要内容

配置步骤

按照以下步骤在 Perfex CRM 的邮箱模块中设置您的个人收件箱连接。

每个员工只能配置自己的收件箱连接，该连接将绑定到用于登录管理区域的邮箱地址。 出于安全和隔离目的，请确保每个员工都设置自己的邮箱账户。

认证方式​

邮箱模块支持两种认证方式：

  1. OAuth2 认证（推荐用于 Gmail 和 Outlook）- 免密码、安全连接
  2. 密码认证 - 传统的 IMAP 密码连接

方案 A：OAuth2 认证（Gmail/Outlook）​

OAuth2 是 Gmail 和 Outlook/Microsoft 365 账户的推荐方式。它提供安全的免密码认证，并且是许多现代邮箱提供商所要求的。

Gmail 用户​

  1. 管理员设置（一次性，由管理员完成）：

    • 前往 Setup → Settings → Mailbox Settings
    • 滚动到 OAuth Settings 部分
    • 输入您的 Gmail OAuth Client ID 和 Client Secret
    • 点击 Save

  2. 员工设置（每个员工）：

    • 导航到 Mailbox → Emails（或 Profile → Mailbox Config）
    • 选择 OAuth 作为认证方式
    • 点击 Connect Gmail 按钮
    • 在弹出窗口中授权应用
    • 您的 Gmail 账户将自动连接
提示

有关 Gmail OAuth 设置的详细说明，请参阅 Gmail OAuth 设置。

Outlook/Microsoft 365 用户​

  1. 管理员设置（一次性，由管理员完成）：

    • 前往 Setup → Settings → Mailbox Settings
    • 滚动到 OAuth Settings 部分
    • 输入您的 Outlook OAuth Client ID、Client Secret 和 Tenant ID
    • 点击 Save

  2. 员工设置（每个员工）：

    • 导航到 Mailbox → Emails（或 Profile → Mailbox Config）
    • 选择 OAuth 作为认证方式
    • 点击 Connect Outlook 按钮
    • 在弹出窗口中授权应用
    • 您的 Outlook 账户将自动连接
提示

有关 Outlook OAuth 设置的详细说明，请参阅 Outlook OAuth 设置。

信息

OAuth 令牌会在过期前自动刷新。您只需授权一次。

方案 B：密码认证​

对于不支持 OAuth2 的邮箱提供商，或者如果您更喜欢基于密码的认证：

1. 输入您的邮箱账户信息​

通过在左侧 "Mailbox" 菜单下选择 "Emails" 导航到 邮箱配置设置 部分。

输入与您邮箱地址关联的 IMAP 账户用户名 和 密码（例如，如果您以 [email protected] 登录，请将 [email protected] 设置为您的收件箱），并可选添加您的签名。

出于安全目的，[email protected] 不能在自己的 CRM 账户中为 [email protected] 设置连接。要设置 [email protected]，请在 Perfex CRM 中创建一个 George 员工账户，然后从他的用户资料中配置 George 的邮箱收件箱。这确保每个员工的邮件通信被正确隔离并安全地链接到他们自己的用户账户。

输入您的邮箱账户凭据和（可选）您的签名后，按 Save 完成连接。

2. 设置 IMAP 服务器详情​

您可以通过两种方式配置 IMAP 设置：

方式 1：每个员工的 IMAP 配置（推荐）

每个员工可以配置自己的 IMAP 服务器设置：

  1. 导航到 Mailbox → Emails（或 Profile → Mailbox Config）
  2. 滚动到 IMAP Server Configuration 部分
  3. 输入您的 IMAP Server（例如，imap.gmail.com）
  4. 选择 Encryption Method（SSL、TLS 或无）
  5. IMAP Port 将根据加密方式自动更新（SSL 为 993，TLS 为 143）
  6. 配置 文件夹映射：
    • Folder to Scan（通常为 "INBOX"）
    • Sent Folder（例如，"Sent"、"Sent Items"）
    • Drafts Folder（例如，"Drafts"）
    • Trash Folder（例如，"Trash"、"Deleted Items"）
    • Spam Folder（例如，"Spam"、"Junk"）
    • Archive Folder（例如，"Archive"）
  7. 点击 Save
提示

如果文件夹映射留空，模块将尝试自动检测。

方式 2：全局 IMAP 设置（备用）

如果未配置每个员工的设置，模块将使用全局设置：

  1. 点击 Perfex 的 Setup 菜单并找到 Settings 部分
  2. 然后向下滚动找到 Mailbox Settings
  3. 点击它并根据您的邮箱提供商设置填写所需详情。

所需的必填详情：

  • IMAP Server（例如，imap.gmail.com）
  • Encryption Method（通常为 SSL）
  • Folder（用于监控的文件夹——通常为 "Inbox"）
  • Check Every（邮件获取任务的频率，以分钟为单位）

您还可以在同一页面上更改一些用于模块操作的直观选项。请确保使用提供商的正确设置——不正确的详情将阻止成功连接。

3. 配置个人偏好​

在您的 Mailbox Config 页面中，您还可以配置：

  • 仅导入未读邮件：启用以仅获取未读邮件（同步更快）
  • 启用 HTML 渲染：启用以带格式显示 HTML 邮件
  • 预览时自动标记为已读：在预览面板或单独视图中查看邮件时自动标记为已读
  • 将已读状态同步到邮件服务器：将已读状态同步回您的 IMAP 服务器（保持 Gmail/Outlook 同步，但速度较慢）
信息

"将已读状态同步到邮件服务器"在您希望 Gmail/Outlook 收件箱与 Perfex 保持同步时很有用。启用后，在 Perfex 中阅读邮件会将其在邮件服务器上标记为已读。

4. 设置完成！​

保存设置后，只要 Perfex CRM 的 cron 任务正常运行，邮箱模块就会尝试连接您的收件箱。

提示

您可以通过检查计划任务执行或模块同步活动来验证 cron 是否正常工作。您也可以使用 Settings → Mailbox Settings 中的 Manual Sync 按钮立即测试连接。

重要说明​

  • 首次连接时，如果您的收件箱包含大量 未读邮件，所有邮件都将被导入到模块中并存储在您的 Perfex 数据库中。
  • 这是完全正常的——但初始同步可能需要几分钟。
  • 如果您的服务器资源有限，在同步过程中可能导致临时超时。只需等待并稍后刷新即可。
  • OAuth 用户：您的 OAuth 令牌会在过期前自动刷新。如果看到连接错误，请尝试断开并重新连接您的 OAuth 账户。
  • 密码用户：对于 Gmail 和 Outlook，如果启用了双因素认证，您可能需要使用 应用专用密码 而不是常规密码。详情请参阅故障排除部分。