# 注册 WhatsApp 电话号码

要让客户接收 WhatsApp 消息，他们必须拥有一个有效的电话号码，并在 Pushwoosh 中注册为 WhatsApp 平台订阅者。

此外，WhatsApp 要求企业在向客户发送消息前必须获得他们的选择性加入同意。有关获取同意的指南，请参阅 [WhatsApp 选择性加入最佳实践](https://business.whatsapp.com/policy#best_practices)。

## 注册 WhatsApp 订阅者的方法
<Aside type="caution" icon="setting" title="需要开发者协助">
****
 您需要开发团队的帮助，以使用 Pushwoosh SDK 和 API 注册 WhatsApp 联系人。请务必与他们分享以下链接以获取详细指导。
</Aside>

注册电话号码为 WhatsApp 订阅者主要有三种方法：

* 使用 Pushwoosh SDK。 [了解更多](/zh/developer/first-steps/subscribe-users#register-a-whatsapp-number)

* 使用 Pushwoosh API。 [了解更多](/zh/developer/first-steps/subscribe-users#whatsapp)

* 从 CSV 文件导入 WhatsApp 联系人

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

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

### 准备您的 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>


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

- **姓名** – 用户的名字或全名。
- **位置** – 指定用户的城市、州或国家。可用于发送基于位置的促销活动（例如，*今天在我们洛杉矶的商店享受 20% 的折扣！*）。
- **生日** – 可用于发送带有特别折扣的生日消息（例如，*生日快乐，Sarah！这是专为您准备的 10% 折扣！*）。可以触发自动化的生日营销活动。
- **语言** – 存储用户的语言偏好（例如，英语、西班牙语、法语）。有助于以接收者的语言发送消息，以提高参与度。
- **客户类型** – 识别用户是**新客户、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. 前往 **Campaigns** > **WhatsApp messages** > **Upload contacts**。

![Upload WhatsApp contacts](/whatsapp-messages-register-phone-numbers-for-whatsapp.webp)

或者，前往 **Audience > Import CSV > Import WhatsApp contacts > Upload CSV**。

<img src="/whatsapp-messages-register-phone-numbers-for-whatsapp-1.webp" alt=""/>

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

3. 映射列：
* **CSV 中的 WhatsApp 联系人列：** 选择包含格式为 `whatsapp:+` 的电话号码的列。
* **CSV 中的用户 ID 列：** 选择包含唯一用户标识符的列（例如，电子邮件或姓名）。

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

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

* 从您的 CSV 中选择一个**列名**。
* 为其分配一个**标签**，以将其与系统中的用户数据关联。
* 点击 **\+ Add Column** 以包含更多属性。
4\. 点击 **Start Import** 开始处理文件。

<img src="/whatsapp-messages-register-phone-numbers-for-whatsapp-2.webp" alt=""/>

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

然后，您可以使用这些数据来创建分段和个性化的 WhatsApp 营销活动。

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