> ## 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 批量 API 导入所有现有联系人。
* **去重**：联系人通过 Wave 特定的扩展属性标识，更新时不会创建重复条目。

## 限制与要求

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

## 断开连接

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