# 注册 Viber 联系人

为了让客户能够接收 Viber 消息，他们必须拥有一个有效的电话号码，并在 Pushwoosh 中注册为 Viber 平台订阅者。本指南将说明如何通过导入 CSV 文件来注册联系人。

<Aside type="note" title="自动注册">
当联系人首次向您的 Viber Business 账户发送消息时，Pushwoosh 会自动将其电话号码注册为 Viber 订阅者。
</Aside>

## 如何从 CSV 文件导入 Viber 联系人

要导入 Viber 联系人，请上传一个包含联系人列表的 CSV 文件。导入的号码将被注册为 Viber 订阅者，从而实现个性化消息发送和受众细分。

### 准备您的 CSV 文件

#### CSV 格式规则

##### 通用结构
- 第一行必须包含列标题，用于描述每列中的数据。
- 随后的每一行代表一个联系人，其值与标题相对应。
- 值必须用逗号分隔。
- 文件必须以 UTF-8 编码保存，以确保字符正确显示。
- 允许的最大文件大小为 100 MB。

##### 必填列
- **电话号码：** 必须采用 [**E.164**](https://en.wikipedia.org/wiki/e.164) 格式，包括 `+` 号和国家代码。
- **用户 ID：** 用户的唯一标识符（例如，姓名或电子邮件）。

<Aside type="note">
您 CSV 文件中的列名不必与这些完全匹配。在导入过程中，您可以将现有的列名映射到系统中的正确字段。例如，如果您的 CSV 文件中有一列名为 *Mobile* 而不是 *Phone Number*，您可以在导入时手动将其分配给 **Phone Number** 字段。
</Aside>

##### 可选列
添加可选列可以在您的 Viber 营销活动中实现更高级的细分和个性化。

- **姓名：** 用户的名字或全名。
- **位置：** 指定用户的城市、州或国家。可用于发送基于位置的促销活动（例如，*今天在我们洛杉矶的商店享受八折优惠！*）。
- **生日：** 可以发送带有特别折扣的生日消息（例如，*Sarah，生日快乐！这是专为您准备的九折优惠！*）。可以触发自动生日营销活动。
- **语言：** 存储用户的语言偏好（例如，英语、西班牙语、法语）。有助于以接收者的语言发送消息，以提高参与度。
- **客户类型：** 识别用户是**新客户、VIP 还是非活跃客户**。可以实现有针对性的消息发送（例如，*专为您准备的独家 VIP 优惠！*）。
- **自定义标签：** 与您的营销活动相关的任何其他数据（例如，用户偏好、购买历史）。这些可以映射到系统标签，并在 Pushwoosh 中用于细分。

##### CSV 文件示例

以下示例展示了一个格式正确的 CSV 文件：

```csv
Phone Number,User ID,Name,Location
+1XXXXXXXXXX,john.doe@email.com,John Doe,New York
+1XXXXXXXXXX,jane.smith@email.com,Jane Smith,Los Angeles
```

### 上传 CSV 文件

1. 前往 **Audience > Import CSV > Import Viber Contacts**。

<img src="/viber-register-viber-contacts-1.webp" alt="“受众”部分中的“导入 CSV”菜单，显示用于上传 Viber 订阅者电话号码的“导入 Viber 联系人”选项"/>

2. 从您的计算机中选择 CSV 文件。

3. 映射列：

   * **CSV 中的 Viber 联系人列：** 选择包含 E.164 格式电话号码的列（例如，`+1XXXXXXXXXX`）。Pushwoosh 会在内部将它们注册为 `viber:+` 订阅者。
   * **CSV 中的用户 ID 列：** 选择包含唯一用户标识符的列（例如，电子邮件或姓名）。

<img src="/viber-register-viber-contacts-2.webp" alt="导入 Viber 联系人映射步骤，其中包含用于 CSV 映射的 Viber 联系人列和用户 ID 列下拉菜单"/>

4. 添加额外数据（可选）

   如果您想包含用于细分的额外详细信息：

   * 从您的 CSV 中选择一个**列名**。
   * 为其分配一个**标签**，以将其与系统中的用户数据关联起来。
   * 点击 **+ 添加列**以包含更多属性。

<img src="/viber-register-viber-contacts-3.webp" alt="Viber CSV 导入可选标签映射，其中包含列名和标签下拉菜单以及添加列链接"/>

5. 点击**开始导入**以开始处理文件。

CSV 导入完成后，这些联系人将作为新的细分出现在[细分列表](/zh/product/audience-data-and-segmentation/segmentation/)中，并且也可以在[用户浏览器](/zh/product/audience-data-and-segmentation/user-explorer/)中查看。

然后，您可以使用这些数据通过 Customer Journey 创建细分和个性化的 Viber 营销活动。

<LinkCard title="了解有关发送 Viber 消息的更多信息" href="/product/messaging-channels/viber/send-viber-messages/" />