Con la API REST de Papo, puedes automatizar la administración de equipos sin abrir el panel: listar equipos, crear equipos, listar miembros de un equipo, agregar usuarios a un equipo y listar o crear bandejas de entrada. Es la forma programática de mantener la estructura de atención sincronizada con sistemas externos, grandes operaciones y reventas white label.
La API de Papo expone recursos de equipos y bandejas con la misma autenticación que los demás endpoints de la plataforma. Con ellos, tu equipo puede aprovisionar nuevas estructuras, auditar quién forma parte de cada grupo y preparar el enrutamiento de conversaciones sin intervención manual en el panel.
Resumen de las operaciones de equipos y miembros vía API
| Operación | Qué hace | Cuándo usar |
|---|---|---|
| Listar equipos | Devuelve los equipos registrados en la cuenta. | Auditar la estructura antes de crear un nuevo equipo. |
| Crear equipo | Crea un equipo con nombre y descripción opcional. | Aprovisionar un nuevo equipo vía script, ERP o CRM. |
| Listar miembros de un equipo | Devuelve los usuarios que forman parte de ese equipo. | Verificar quién está incluido y evitar accesos incorrectos. |
| Agregar usuarios al equipo | Incluye uno o más usuarios informando los IDs separados por coma. | Sincronizar el equipo con la plantilla actual de agentes. |
| Listar bandejas | Devuelve las bandejas con el canal, en la vista de administrador. | Verificar los canales disponibles y cómo están organizados. |
| Crear bandeja de entrada | Crea una nueva bandeja de entrada. | Aprovisionar nuevos canales junto con la estructura de equipos. |
Cómo funciona la autenticación de la API
Las operaciones de escritura, incluidas las de equipos y miembros, 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.
Paso a paso para gestionar equipos y miembros vía API
- 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 si quieres validación adicional.
- En cada solicitud, autentícate con la clave secreta como token Bearer. Si refuerzas la validación, envía la clave pública en el encabezado indicado en la documentación.
- Lista los equipos existentes para mapear la estructura actual antes de crear nuevos.
- Crea un equipo enviando un payload JSON con nombre y, si es necesario, descripción. Consulta la documentación oficial para el formato exacto.
- Lista los miembros del equipo para auditar quién ya está incluido y evitar duplicidad.
- Agrega usuarios al equipo informando los IDs separados por coma. Este paso sincroniza el equipo con la plantilla actual de agentes.
- Lista las bandejas de entrada con la vista de administrador para verificar los canales existentes y usar la API también para crear bandejas cuando sea necesario.
Como la API es REST y utiliza JSON, cualquier lenguaje con soporte HTTP puede usarse para integrar equipos y miembros a 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
- Operaciones grandes que necesitan crear y ajustar equipos con frecuencia sin abrir el panel manualmente.
- Equipos de TI y automatización que sincronizan la estructura de agentes con directorios, RR. HH. o sistemas internos.
- Reventas white label que aprovisionan cuentas de clientes de forma estandarizada, reutilizando la misma lógica de equipos y bandejas.
- Empresas que ya usan la API de Papo para contactos y conversaciones y desean completar el flujo con la administración de equipos.
La API gestiona la estructura de equipos y la inclusión de miembros. Las funciones de usuario, como Agente o Administrador, y los permisos granulares siguen definiéndose en el panel. Al agregar un usuario a un equipo y conectarlo a las bandejas de entrada relevantes, controlas el acceso operativo a las conversaciones.
Preguntas frecuentes
¿La API de Papo define la función del usuario, como Agente o Administrador?
No. La API de equipos y miembros concentra la creación de equipos, el listado de miembros y la inclusión de usuarios. La definición de función y permisos de cada usuario se realiza en el panel. Al incluir un usuario en un equipo y en las bandejas correctas, restringes el acceso a las conversaciones operativas.
¿Puedo crear un equipo sin agregar miembros en el mismo paso?
Sí. La API permite crear un equipo con nombre y descripción opcional, sin incluir usuarios inmediatamente. Después, puedes agregar miembros usando la operación de inclusión en lote.
¿Cómo identifica la API la cuenta en las solicitudes?
Por la clave secreta enviada como token Bearer. La clave pública es opcional y, si se envía, debe corresponder a la misma cuenta de la clave secreta.
¿Esta API funciona para reventa white label?
Sí. Los revendedores pueden usar la API para aprovisionar equipos y miembros en las cuentas de los clientes de forma estandarizada, reduciendo la configuración manual y manteniendo la consistencia entre las operaciones.
¿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 equipos, miembros y demás recursos.
Lea también
- Cómo usar la API de Papo para crear y gestionar etiquetas (tags)
- Cómo gestionar los usuarios y permisos dentro de tu plataforma white label
Comienza gratis y automatiza equipos y miembros vía API →
El primer usuario es gratis para siempre, así que puedes validar la integración antes de estructurar tu operación.