借助 Papo 的 REST API，你可以列出已有标签、创建新标签，并将标签应用到有打开对话的联系人——全部通过经过身份验证的请求完成，无需打开面板。这是从外部系统、CRM 或自动化工具中以编程方式自动化服务分类与组织的方式。
Papo API 公开了包含标签管理的对话资源。借助这些资源，你的团队可以保持一致分类体系，在活动前准备类别，并实时对联系人和对话进行分类，同时使用与平台其他端点相同的身份验证。
通过 API 进行标签操作的概览
| 操作 | 作用 | 何时使用 |
|---|---|---|
| 列出标签 | 返回账户中已注册的标签，包含名称和颜色以便视觉识别。 | 审核账户标准化情况，或将标签与另一工具同步。 |
| 创建标签 | 在账户中创建标签，但不将其应用到联系人。 | 在批量应用或自动化之前准备新类别。 |
| 将标签应用到联系人 + 对话 | 如果标签尚不存在则创建它，并将其应用到联系人和打开的对话。 | 在对话进入时自动进行分诊、资格认定或分类。 |
API 身份验证如何工作
所有写入路由，包括标签操作，都需要账户密钥。它必须作为 Bearer token 在授权标头中发送。账户公钥是可选的，但如果发送，则必须与密钥属于同一账户。
API 基础 URL 是 https://app.papo.global/api/v1。密钥在 Papo 面板的开发者区域生成。密钥在创建时只显示一次；请将其保存在安全位置，如有泄露嫌疑请撤销。
实际使用方法
- 在 Papo 面板中访问开发者/API 区域并生成密钥。同时复制账户公钥。
- 在每个请求中，使用密钥作为 Bearer token 进行身份验证。如果你想加强验证，请在文档指示的标头中发送公钥。
- 要列出标签，请调用 API 的标签列表端点。响应会返回已注册的标签，让你在创建新标签之前先了解已有内容。
- 要创建标签但不应用，请在创建端点中发送包含标签信息的 JSON payload。确切格式请查阅官方文档。
- 要将标签应用到有打开对话的联系人，请调用标签端点。如果标签尚不存在，它将自动创建并应用到联系人和打开的对话。
由于 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 批量分类旧对话吗？
平台中描述的标签应用资源作用于联系人和打开的对话。对于迁移或追溯分类等特定情况，最好查阅官方文档，并在流程允许时结合对话列表和顺序调用。
另请阅读
创建免费账户，将 WhatsApp、Instagram、电子邮件和 SMS 集中到一个收件箱中，并使用标签组织服务。