> ## 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.

# Salesforce

> 将 Wave 联系人同步到 Salesforce 的 Leads 或 Contacts

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

Salesforce 集成将 Wave 联系人同步到 Salesforce，可选择同步为 Leads 或 Contacts。Wave 使用自定义外部 ID 字段进行 upsert 操作，即使记录已存在也能防止重复创建。支持生产环境和沙盒环境的 Salesforce。

## 连接方式

<Steps>
  <Step title="打开集成">
    前往 **集成 → Salesforce**。
  </Step>

  <Step title="选择记录类型">
    选择将联系人同步为 **Leads** 还是 **Contacts**。
  </Step>

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

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

Wave 请求离线访问权限（保持连接活跃，无需重复登录）以及读写权限，以在 Salesforce 中创建和更新记录。

## 同步内容

| Wave 字段 | Salesforce 字段                 | Leads | Contacts |
| ------- | ----------------------------- | :---: | :------: |
| 名字      | `FirstName`                   |   是   |     是    |
| 姓氏      | `LastName`                    |   是   |     是    |
| 主邮箱     | `Email`                       |   是   |     是    |
| 主电话     | `Phone`                       |   是   |     是    |
| 职位      | `Title`                       |   是   |     是    |
| 公司      | `Company`                     | 是（必填） |     -    |
| 联系人备注   | `Description`                 |   是   |     是    |
| 线索来源    | `LeadSource` = "Wave Connect" |   是   |     -    |
| 分配的团队成员 | `OwnerId`（通过邮箱匹配）             |   是   |     是    |

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

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

## 功能特点

* **Leads 或 Contacts**：选择适合您工作流程的 Salesforce 记录类型。
* **沙盒支持**：可连接到 Salesforce 沙盒环境进行测试。
* **连接时自动同步**：首次连接时导入所有现有 Wave 联系人。
* **去重**：自动创建自定义外部 ID 字段（`WaveConnectId__c`）并用于 upsert 操作，重新同步时不会创建重复记录。
* **所有者分配**：联系人将分配给邮箱与 Wave 团队成员匹配的 Salesforce 用户。

## 手动添加外部 ID 字段

Wave 在连接时通常会自动创建 `WaveConnectId__c` 外部 ID 字段。仅当您**使用非 Salesforce 管理员账户连接**时（因为创建自定义字段需要管理员权限），才需要执行此步骤。此时，请让您的 Salesforce 管理员手动添加该字段。

<Steps>
  <Step title="打开 Lead 对象">
    在 Salesforce **Setup** 中，打开 **Object Manager** 并选择 **Lead** 对象。
  </Step>

  <Step title="检查字段是否存在">
    在 **Fields & Relationships** 下，检查 `WaveConnectId__c` 是否已存在。
  </Step>

  <Step title="创建字段">
    如果不存在，点击 **New**，选择 **Text** 作为字段类型，并将其命名为 `WaveConnectId__c`。
  </Step>

  <Step title="设置字段级安全性">
    确认 **Standard User** 对该字段具有读写访问权限。
  </Step>

  <Step title="添加到页面布局并保存">
    将字段添加到相关页面布局，然后保存。
  </Step>
</Steps>

<Note>
  如果字段已存在，请打开该字段并选择 **Set Field-Level Security**，确认 **Standard User** 具有读写访问权限。详情请参阅 [Salesforce 设置指南](https://support.wavecnct.com/en/articles/10492839-salesforce)。
</Note>

## 限制与要求

* 自定义字段 `WaveConnectId__c` 会自动在您的 Salesforce 账户中创建，请勿删除或重命名，该字段用于去重。
* 对于 Leads，Salesforce 要求 `Company` 字段为必填。如果 Wave 联系人没有公司，默认填写 `N/A`。
* 如果 Salesforce 通过重复规则检测到重复项，Wave 会覆盖该规则并保存记录。
* 所有者匹配通过邮箱进行。如果找不到匹配的 Salesforce 用户，联系人将在没有所有者的情况下保存。

## 断开连接

前往 **集成 → Salesforce** 并点击 **断开连接**。这将移除集成并撤销 Wave 的访问权限。已同步到 Salesforce 的记录不会被删除。