**Con la API REST de [Papo](https://papo.global/), puedes listar las etiquetas existentes, crear nuevas etiquetas y aplicar una etiqueta a un contacto con conversación abierta — todo por solicitudes autenticadas, sin abrir el panel. Es la forma programática de automatizar la categorización y la organización de la atención desde sistemas externos, CRMs o herramientas de automatización.**

La API de Papo expone recursos de Conversaciones que incluyen la gestión de etiquetas. Con ellos, tu equipo puede mantener una taxonomía consistente, preparar categorías antes de campañas y clasificar contactos y conversaciones en tiempo real, usando la misma autenticación de los demás endpoints de la plataforma.

## Resumen de las operaciones de etiqueta vía API

| Operación | Qué hace | Cuándo usarla |
| :--- | :--- | :--- |
| Listar etiquetas | Devuelve las etiquetas registradas en la cuenta, con nombre y color para identificación visual. | Auditar la estandarización de la cuenta o sincronizar etiquetas con otra herramienta. |
| Crear etiqueta | Crea una etiqueta en la cuenta sin aplicarla a un contacto. | Preparar nuevas categorías antes de aplicarlas en masa o en automatizaciones. |
| Aplicar etiqueta a contacto + conversación | Crea la etiqueta si aún no existe y la aplica al contacto y a la conversación abierta. | Automatizar el triaje, la calificación o la clasificación tan pronto como entra la conversación. |

## Cómo funciona la autenticación de la API

Todas las rutas de escritura, incluidas las operaciones de etiquetas, requieren la clave secreta de la cuenta. Debe enviarse como token Bearer en el encabezado de autorización. La clave pública de la cuenta es opcional, pero, si se envía, debe corresponder a la misma cuenta de la clave secreta.

La URL base de la API es `https://app.papo.global/api/v1`. Las claves se generan en el área de desarrollador del panel de Papo. La clave secreta aparece una única vez en la creación; guárdala en un lugar seguro y revócala si sospechas de una filtración.

## Cómo usarla en la práctica

1. Accede al área de desarrollador/API en el panel de Papo y genera una clave secreta. Copia también la clave pública de la cuenta.
2. En cada solicitud, autentícate con la clave secreta como token Bearer. Si quieres reforzar la validación, envía la clave pública en el encabezado indicado en la documentación.
3. Para listar etiquetas, llama al endpoint de listado de etiquetas de la API. La respuesta trae las etiquetas registradas, lo que permite mapear lo que ya existe antes de crear nuevas.
4. Para crear una etiqueta sin aplicarla, envía un payload JSON con la información de la etiqueta en el endpoint de creación. Consulta la documentación oficial para el formato exacto.
5. Para aplicar una etiqueta a un contacto con conversación abierta, llama al endpoint de etiquetado. Si la etiqueta aún no existe, se creará automáticamente y se aplicará al contacto y a la conversación abierta.

Como la API es REST y utiliza JSON, cualquier lenguaje con soporte HTTP puede usarse para integrar etiquetas en scripts, ERPs, CRMs o herramientas de automatización. La documentación oficial en `https://papo.global/pt/docs` trae los detalles de autenticación, parámetros, respuestas y ejemplos de código.

## Para quién tiene sentido esta integración

- **Equipos que usan automatizaciones externas** para clasificar conversaciones sin abrir la interfaz de Papo.
- **Operaciones que necesitan crear etiquetas en lote** antes de campañas o al implementar una nueva taxonomía de atención.
- **Integradores y revendedores white label** que conectan Papo a sistemas de clientes y quieren mantener una categorización consistente entre las cuentas.
- **Empresas que ya usan la API de Papo** para contactos y mensajes y desean completar el flujo con etiquetas.

## Preguntas frecuentes

### ¿Necesito crear la etiqueta antes de aplicarla vía API?

No. La API tiene un recurso que crea la etiqueta en la cuenta, si aún no existe, y ya la aplica al contacto y a la conversación abierta. También existe la opción de solo crear la etiqueta, sin aplicarla a ningún contacto.

### ¿La etiqueta aplicada vía API vale para el contacto y para la conversación?

Sí. El recurso de etiquetado aplica la etiqueta al contacto y a la conversación abierta, ayudando a clasificar tanto el historial del lead como la atención en curso.

### ¿La autenticación es la misma que se usa en otros endpoints de Papo?

Sí. Las rutas de escritura requieren la clave secreta de la cuenta, enviada como token Bearer. La clave pública es opcional y, si se envía, debe corresponder a la misma cuenta.

### ¿Dónde encuentro las rutas exactas y el formato del payload?

En la documentación oficial de la API, disponible en `https://papo.global/pt/docs`. Allí están los detalles de autenticación, parámetros, respuestas y ejemplos de código para etiquetas y demás recursos.

### ¿Puedo usar la API para clasificar conversaciones antiguas en masa?

El recurso de aplicación descrito en la plataforma actúa sobre el contacto y la conversación abierta. Para casos específicos de migración o clasificación retroactiva, lo ideal es consultar la documentación oficial y combinar el listado de conversaciones con llamadas en secuencia, cuando el flujo lo permita.

## Lee también

- [Cómo usar la API de Papo para crear y actualizar contactos en masa](/hc/papo/articles/como-usar-la-api-de-papo-para-crear-y-actualizar-contactos-en-masa)
- [Cómo usar la API de Papo para enviar plantillas de mensaje de WhatsApp (HSM)](/hc/papo/articles/como-usar-api-papo-enviar-plantillas-whatsapp-hsm)

---

**[Comenzar gratis →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=como-usar-api-papo-crear-gestionar-etiquetas&utm_content=es)**

Crea tu cuenta gratuita y centraliza WhatsApp, Instagram, correo electrónico y SMS en una sola bandeja de entrada, con etiquetas para organizar la atención.