> ## Documentation Index
> Fetch the complete documentation index at: https://wavecnct.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook 联系人

> 将 Wave 联系人（含照片）保存到 Microsoft Outlook

<Info>
  适用于 **Pro**、**Teams** 和 **Enterprise** 计划。
</Info>

Outlook 联系人集成将 Wave 联系人（含联系人照片）同步到 Microsoft Outlook / Microsoft 365 联系人中。支持两种模式：**个人**（您的个人 Outlook 账户）和**组织**（管理员连接，自动将同步的联系人推送到每位团队成员的 Outlook）。

## 连接方式

### 个人（个人 Outlook）

<Steps>
  <Step title="打开集成">
    前往 **集成 → Outlook 联系人**。
  </Step>

  <Step title="启用自动同步（可选）">
    开启 **自动同步** 可立即导入所有现有 Wave 联系人。
  </Step>

  <Step title="连接 Outlook">
    点击 **连接** 并使用您的 Microsoft 账户登录。
  </Step>
</Steps>

### 组织（所有团队成员的 Outlook）

<Steps>
  <Step title="以管理员身份打开集成">
    管理员前往 **集成 → Outlook 联系人**。
  </Step>

  <Step title="以组织身份连接">
    点击 **以组织身份连接** 并使用 Azure AD 管理员账户登录。
  </Step>

  <Step title="授予管理员同意">
    授予管理员同意，以便 Wave 将联系人同步到每位团队成员的 Outlook。
  </Step>
</Steps>

Wave 请求离线访问权限（保持连接活跃）以及读写权限，以在 Outlook 中创建和更新联系人。

## 同步内容

| Wave 字段       | Outlook 字段          |
| ------------- | ------------------- |
| 名字            | `givenName`         |
| 姓氏            | `surname`           |
| 显示名称          | `displayName`       |
| 职位            | `jobTitle`          |
| 公司            | `companyName`       |
| 主电话（手机）       | `mobilePhone`       |
| 工作电话          | `businessPhones`    |
| 其他电话          | `homePhones`        |
| 最多 3 个邮箱      | `emailAddresses`    |
| 街道、城市、省、邮编、国家 | `businessAddress`   |
| 网站            | `businessHomePage`  |
| 联系人备注         | `personalNotes`     |
| 联系人照片         | Outlook 联系人照片（JPEG） |

**同步方向**：Wave → Outlook（仅出站）

**同步时机**：联系人创建、更新或删除时实时同步

## 功能特点

* **组织模式**：单次管理员连接可将联系人同步到所有符合条件的团队成员的 Outlook（邮箱存在于已连接 Azure AD 租户中的用户）。
* **联系人照片**：个人资料照片会同步并转换为 JPEG 格式以兼容 Outlook。
* **连接时自动同步**：首次连接时使用 Microsoft Graph Batch API 导入所有现有联系人。
* **去重**：联系人通过 Wave 特有的扩展属性识别，更新时不会创建重复记录。

## 限制与要求

* Outlook 限制联系人最多 3 个邮箱地址，主邮箱始终排在首位。
* 在组织模式下，只有邮箱存在于已连接 Azure AD 租户中的用户才能收到同步的联系人。
* 组织模式需要 Azure AD 管理员同意。

## 断开连接

前往 **集成 → Outlook 联系人** 并点击 **断开连接**。这将移除集成。已同步到 Outlook 的联系人不会被删除。