**借助 [Papo](https://papo.global/) 的 REST API，你可以列出已有标签、创建新标签，并将标签应用到有打开对话的联系人——全部通过经过身份验证的请求完成，无需打开面板。这是从外部系统、CRM 或自动化工具中以编程方式自动化服务分类与组织的方式。**

Papo API 公开了包含标签管理的对话资源。借助这些资源，你的团队可以保持一致分类体系，在活动前准备类别，并实时对联系人和对话进行分类，同时使用与平台其他端点相同的身份验证。

## 通过 API 进行标签操作的概览

| 操作 | 作用 | 何时使用 |
| :--- | :--- | :--- |
| 列出标签 | 返回账户中已注册的标签，包含名称和颜色以便视觉识别。 | 审核账户标准化情况，或将标签与另一工具同步。 |
| 创建标签 | 在账户中创建标签，但不将其应用到联系人。 | 在批量应用或自动化之前准备新类别。 |
| 将标签应用到联系人 + 对话 | 如果标签尚不存在则创建它，并将其应用到联系人和打开的对话。 | 在对话进入时自动进行分诊、资格认定或分类。 |

## API 身份验证如何工作

所有写入路由，包括标签操作，都需要账户密钥。它必须作为 Bearer token 在授权标头中发送。账户公钥是可选的，但如果发送，则必须与密钥属于同一账户。

API 基础 URL 是 `https://app.papo.global/api/v1`。密钥在 Papo 面板的开发者区域生成。密钥在创建时只显示一次；请将其保存在安全位置，如有泄露嫌疑请撤销。

## 实际使用方法

1. 在 Papo 面板中访问开发者/API 区域并生成密钥。同时复制账户公钥。
2. 在每个请求中，使用密钥作为 Bearer token 进行身份验证。如果你想加强验证，请在文档指示的标头中发送公钥。
3. 要列出标签，请调用 API 的标签列表端点。响应会返回已注册的标签，让你在创建新标签之前先了解已有内容。
4. 要创建标签但不应用，请在创建端点中发送包含标签信息的 JSON payload。确切格式请查阅官方文档。
5. 要将标签应用到有打开对话的联系人，请调用标签端点。如果标签尚不存在，它将自动创建并应用到联系人和打开的对话。

由于 API 是 REST 并使用 JSON，任何支持 HTTP 的语言都可以用来将标签集成到脚本、ERP、CRM 或自动化工具中。官方文档位于 `https://papo.global/pt/docs`，其中包含身份验证、参数、响应和代码示例的详细信息。

## 这种集成适合谁

- **使用外部自动化来分类对话的团队**，无需打开 Papo 界面。
- **需要在活动前或实施新服务分类体系时批量创建标签的运营团队**。
- **将 Papo 连接到客户系统并希望在账户之间保持一致分类的集成商和 white label 经销商**。
- **已经使用 Papo API 处理联系人和消息，并希望用标签完善流程的企业**。

## 常见问题

### 通过 API 应用之前需要先创建标签吗？

不需要。API 有一个资源会在标签尚不存在时在账户中创建它，并直接应用到联系人和打开的对话。也可以选择只创建标签，而不将其应用到任何联系人。

### 通过 API 应用的标签对联系人和对话都有效吗？

是的。标签资源会将标签应用到联系人和打开的对话，帮助对线索历史记录和进行中的服务进行分类。

### 身份验证与 Papo 其他端点使用的相同吗？

是的。写入路由需要账户密钥，并作为 Bearer token 发送。公钥是可选的，如果发送，则必须属于同一账户。

### 在哪里可以找到确切的路径和 payload 格式？

在官方 API 文档中，地址为 `https://papo.global/pt/docs`。那里有标签及其他资源的身份验证、参数、响应和代码示例的详细信息。

### 我可以使用 API 批量分类旧对话吗？

平台中描述的标签应用资源作用于联系人和打开的对话。对于迁移或追溯分类等特定情况，最好查阅官方文档，并在流程允许时结合对话列表和顺序调用。

## 另请阅读

- [如何使用 Papo API 批量创建和更新联系人](/hc/papo/articles/how-to-use-papo-api-create-update-contacts-bulk-zh)
- [如何使用 Papo API 发送 WhatsApp 消息模板（HSM）](/hc/papo/articles/papo-api-send-whatsapp-hsm-message-templates)

---

**[免费开始 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=papo-api-create-manage-tags-zh&utm_content=zh_CN)**

创建免费账户，将 WhatsApp、Instagram、电子邮件和 SMS 集中到一个收件箱中，并使用标签组织服务。