Con la API REST de Papo, puedes listar las bandejas de entrada existentes y crear nuevas conexiones para canales como WhatsApp e Instagram —todo mediante solicitudes autenticadas, sin abrir el panel. Es la forma programática de aprovisionar canales de atención, integrar sistemas externos y mantener la operación multicanal alineada con la automatización.
La API de Papo expone recursos de bandejas de entrada que permiten consultar la configuración actual y añadir nuevos canales. Con esto, equipos de TI, integradores y revendedores white label pueden gestionar conexiones en lote, replicar configuraciones entre cuentas y automatizar la activación de canales sin depender de la interfaz.
Resumen de las operaciones de bandeja de entrada vía API
| Operación | Qué hace | Cuándo usar |
|---|---|---|
| Listar bandejas | Devuelve las bandejas de entrada de la cuenta, con el canal asociado (WhatsApp, Instagram, correo electrónico, etc.) y detalles de la configuración. | Auditar canales activos, sincronizar con sistemas de monitoreo o preparar migraciones. |
| Crear bandeja | Crea una nueva bandeja de entrada, definiendo el canal, nombre y agentes que tendrán acceso. | Aprovisionar canales automáticamente al integrar nuevos clientes, unidades o marcas. |
Cómo funciona la autenticación de la API
Todas las llamadas a la API, incluida la lista de bandejas, requieren la clave secreta de la cuenta. Debe enviarse como token Bearer en el encabezado Authorization. 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.
Para validar la autenticación, puedes llamar al endpoint GET /api/v1/me, que devuelve los datos de la cuenta. El patrón de autenticación es el mismo que se usa en todos los demás endpoints:
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_…" \
-H "X-Papo-Public-Key: pk_live_…"
Cómo gestionar bandejas de entrada en la práctica
- 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.
- 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
X-Papo-Public-Key. - Para listar las bandejas de entrada, llama al endpoint de listado de bandejas. La respuesta trae el identificador de cada bandeja, el canal configurado y otras propiedades, lo que permite mapear lo que ya existe antes de crear nuevas.
- Para crear una nueva bandeja, envía un payload JSON con la información del canal deseado —por ejemplo, WhatsApp (API oficial de Meta), Instagram, correo electrónico o Telegram. Incluye el nombre de la bandeja y los identificadores de los agentes que deben tener acceso. Consulta la documentación oficial para el formato exacto de los campos y valores aceptados.
- Tras la creación, la bandeja queda disponible inmediatamente en el panel y empieza a recibir mensajes en cuanto se complete la conexión del canal (en el caso de canales que requieren emparejamiento, como WhatsApp, la API devuelve las instrucciones necesarias).
Como la API es REST y utiliza JSON, cualquier lenguaje con soporte HTTP puede usarse para integrar la gestión de bandejas a scripts, herramientas de automatización (como n8n) o sistemas de aprovisionamiento. La documentación oficial en https://papo.global/pt/docs incluye los detalles de autenticación, parámetros, respuestas y ejemplos de código.
Para quién tiene sentido esta integración
- Equipos de TI que aprovisionan canales en lote para nuevas unidades, franquicias o marcas, sin necesidad de acceder al panel una por una.
- Revendedores white label que desean automatizar la creación de bandejas para cada nuevo cliente, manteniendo la configuración estandarizada.
- Operaciones que migran o replican configuraciones entre cuentas, usando el listado para auditar y la creación para replicar canales.
- Integradores que conectan Papo con sistemas externos de gestión de canales, garantizando que el entorno de atención refleje automáticamente los cambios.
Preguntas frecuentes
¿Necesito la clave secreta para listar las bandejas de entrada?
Sí. El listado de bandejas exige autenticación con la clave secreta de la cuenta, ya que devuelve información sensible de la configuración. El patrón es el mismo de las demás llamadas a la API: envía el token Bearer en el encabezado Authorization.
¿Puedo crear una bandeja de entrada para WhatsApp vía API?
Sí. Al crear una bandeja, indicas el tipo de canal deseado —incluido WhatsApp (API oficial de Meta) y otros canales compatibles. El payload debe seguir el formato esperado para el canal elegido, según la documentación oficial.
¿Es posible actualizar una bandeja de entrada existente mediante la API?
La API actual permite listar y crear bandejas de entrada. Para cambiar configuraciones de una bandeja ya existente (como cambiar agentes o renombrar), puedes usar el panel de Papo o, si es necesario, volver a crear la bandeja con los nuevos parámetros.
¿Cómo asocio agentes a una bandeja durante la creación?
En el payload de creación, puedes indicar los identificadores de los agentes que deben tener acceso a la bandeja. Esos IDs pueden obtenerse mediante la API de equipos y miembros. Consulta la documentación para el formato exacto.
¿La autenticación es la misma que se usa en otros endpoints de Papo?
Sí. Todas las llamadas que acceden a recursos de la cuenta utilizan la clave secreta 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 bandejas de entrada y demás recursos.
Lea también
- Cómo usar la API de Papo para gestionar equipos y miembros
- Cómo usar la API de Papo para crear y gestionar etiquetas (tags)
Empieza a automatizar tus conexiones ahora mismo →
Crea tu cuenta gratuita e integra canales vía API sin abrir el panel.