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

# 联系人属性设置

联系人属性用于存储联系人的基本信息、来源、标签及互动状态。通过联系人属性，您可以在联系人列表和联系人详情中查看客户信息，并使用属性进行筛选、细分和跟进操作。

联系人属性包括 **系统属性** 和 **自定义属性**：

* 系统属性：由 YCloud 自动生成或更新，例如昵称、电话号码、来源、创建时间以及上次联系时间。
* 自定义属性：由团队成员根据业务需求创建，例如客户等级、购买意向、门店位置或业务类型。

### 常用系统属性

常用联系人属性包括：

<table><thead><tr><th width="153.89453125">属性</th><th>描述</th></tr></thead><tbody><tr><td>昵称</td><td>联系人的原始昵称，通常从 WhatsApp 个人资料信息中同步。</td></tr><tr><td>电话号码</td><td>联系人的主电话号码，通常从 WhatsApp 同步或手动输入。</td></tr><tr><td>邮箱</td><td>联系人的邮箱地址。</td></tr><tr><td>国家 / 地区</td><td>与联系人关联的国家或地区，通常根据电话号码或个人资料信息识别。</td></tr><tr><td>来源</td><td>联系人来源，用于表明联系人是来自消息、链接、导入、API、广告还是其他入口。</td></tr><tr><td>来源 ID</td><td>联系人来源的唯一标识符，通常用于记录原始广告来源或渠道来源。</td></tr><tr><td>来源 URL</td><td>与联系人来源关联的原始 URL，例如广告、营销活动或入口链接。</td></tr><tr><td>标签</td><td>分配给联系人的标签，用于分类、筛选和跟进操作。</td></tr><tr><td>负责人</td><td>负责管理该联系人的团队成员邮箱地址。</td></tr><tr><td>创建时间</td><td>联系人首次在系统中创建的时间。</td></tr><tr><td>上次联系时间</td><td>与该联系人发生互动的最近时间。</td></tr><tr><td>上次连通号码</td><td>最近用于与该联系人沟通的 WhatsApp Business 号码或渠道号码。</td></tr></tbody></table>

<Info>
  标记为 System 的属性为系统属性。它们通常由 YCloud 根据联系人信息、来源、对话、导入或集成数据自动生成或更新。
</Info>

#### 来源

来源（也称为联系人来源）是联系人最常用的系统属性之一。它指明了联系人首次进入 YCloud 的渠道，可用于识别获客渠道、分析广告效果或筛选来自不同入口的联系人。

来源可能包括以下枚举值：

<table><thead><tr><th width="154.671875">来源</th><th>描述</th></tr></thead><tbody><tr><td>Inbound message</td><td>联系人通过发送入站消息与您的 WhatsApp 号码建立联系。</td></tr><tr><td>Link / QR Code</td><td>联系人通过链接或二维码与您的 WhatsApp 号码建立联系。</td></tr><tr><td>Manually added</td><td>联系人由团队成员手动添加。</td></tr><tr><td>File import</td><td>联系人通过文件导入添加。</td></tr><tr><td>Shopify</td><td>联系人通过 <a href="/zh/documentation/integrations/e-commerce/shopify/confirm-cod-orders">Shopify 集成</a> 从您的 Shopify 店铺同步到 YCloud。</td></tr><tr><td>API added</td><td>联系人通过 <a href="/api-reference/contacts/create-a-contact">YCloud API</a> 与您的 WhatsApp 号码建立联系。</td></tr><tr><td>AD</td><td>联系人通过 Meta Click-to-WhatsApp 广告流量与您的 WhatsApp 号码建立联系。了解更多关于 <a href="/zh/documentation/ctwa-click-to-whatsapp-ad/ctwa-introduction">Meta CTWA 广告</a>。</td></tr><tr><td>TikTok AD</td><td>联系人通过 TikTok 消息广告与您的 WhatsApp 号码建立联系。了解更多关于 <a href="/zh/documentation/ctwa-click-to-whatsapp-ad/tiktok-messaging-ad/index">TikTok 消息广告</a>。</td></tr><tr><td>Post</td><td>联系人通过 Facebook 帖子或类似入口与您的 WhatsApp 号码建立联系。</td></tr><tr><td>Calling</td><td>联系人通过 WhatsApp 通话与您的 WhatsApp 号码建立联系。</td></tr><tr><td>WhatsApp Business App</td><td>联系人通过 WhatsApp Business App 与您的 WhatsApp 号码建立联系。</td></tr><tr><td>Unknown</td><td>系统无法识别联系人如何与您的 WhatsApp 号码建立联系，或者历史数据中未记录来源。</td></tr></tbody></table>

例如，如果您想查看通过 TikTok 广告生成的联系人，可以按“TikTok AD”进行筛选。如果您想查看通过 Shopify 同步或创建的联系人，可以按“Shopify”进行筛选。

<Frame caption="Filter contacts by Source. This example selects Tiktok AD; the demo account has no matching contacts.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/contact-source-filter-context.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=310821a3f082afaf2e0d735ffe6cf920" alt="打开来源筛选器并选中 Tiktok AD 的完整联系人列表。" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/contact-source-filter-context.png" />
</Frame>

### 添加自定义属性

如果系统属性无法满足您的业务管理需求，您可以添加自定义属性。

1. 登录您的 [YCloud 账户](https://www.ycloud.com)。
2. 前往 **设置 > 联系人 > 属性**。
3. 点击 **添加属性**。&#x20;

<Frame caption="Define the attribute name, unique key, description, and format, then select Add.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/contact-attribute-create-context.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=2b032fef30edb623352472e60627b6d8" alt="位于添加新属性表单后方的完整设置属性页面。" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/contact-attribute-create-context.png" />
</Frame>

4. 输入属性 **名称** 和唯一的 **键**。可选填写 **描述**，然后选择 **格式**。
5. 点击 **添加** 完成。

<Frame caption="The saved attribute appears in the list with its format and description.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/contact-attribute-list-context.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=2eb89f36e37f32096cf1a8ae713ed3fc" alt="完整设置属性页面中已保存的自定义文本属性。" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/contact-attribute-list-context.png" />
</Frame>

### 编辑或删除属性

成功添加属性后，您可以在 **设置 > 联系人 > 属性** 页面查看它。您还可以根据需要进行编辑或删除。

<Frame caption="Use the pencil icon to edit an attribute, or open its actions menu to find Delete.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/contact-attribute-actions-context-annotated.svg?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=c13d5a0d2ac467de5271c48d0d07a511" alt="带有编辑图标和已展开删除菜单的属性行。" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/contact-attribute-actions-context-annotated.svg" />
</Frame>

在编辑或删除属性之前，请检查该属性是否正用于联系人筛选器、分群、自动化工作流或其他业务场景中，以避免影响现有的联系人管理流程。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.