Para generar las claves de API de Papo (https://papo.global/), accede al panel y ve a Configuración > Desarrolladores (o API). Allí encuentras tu clave pública fija y puedes crear claves secretas nombradas, que se muestran solo una vez y deben almacenarse en un lugar seguro, como un gestor de contraseñas o variables de entorno en el servidor.
La API de Papo utiliza un par de claves para identificar y autenticar tu cuenta en integraciones con CRMs, ERPs, plataformas de automatización (n8n, Zapier) y sistemas propios. Entender la diferencia entre ellas y saber cómo generarlas y protegerlas es el primer paso para construir automatizaciones confiables.
| Tipo de clave | Formato | Función | Nivel de exposición |
|---|---|---|---|
| Clave pública | pk_live_... |
Identifica tu cuenta de Papo de forma única. | Puede exponerse en el frontend o en scripts públicos. |
| Clave secreta | sk_live_... |
Autentica solicitudes y autoriza acciones en tu cuenta. | Confidencial – nunca debe compartirse ni versionarse en código. |
Cómo generar las claves de API
- Inicia sesión en el panel de Papo y accede a Configuración.
- En el menú lateral, localiza la sección Desarrolladores o API.
- La página mostrará tu Clave pública (
pk_live_...). Es fija y puedes copiarla en cualquier momento. - Para obtener una Clave secreta, haz clic en el botón para crear una nueva clave.
- Dale un nombre descriptivo (ej.: “Integración CRM”, “Automatización n8n”) para facilitar la gestión futura.
- La clave secreta (
sk_live_...) se mostrará una única vez. Cópiala de inmediato y guárdala en un lugar seguro.
⚠️ Por seguridad, Papo almacena solo el hash de la clave secreta. Si pierdes el valor original, no será posible recuperarlo. En ese caso, revoca la clave comprometida y genera una nueva.
Cómo almacenar las claves de forma segura
- Nunca coloques la clave secreta directamente en el código fuente, en repositorios Git ni en mensajes.
- Utiliza variables de entorno en tu servidor (ej.:
PAPO_SECRET_KEY) y referéncialas en el código. - Almacena la clave en un gestor de contraseñas (como 1Password, Bitwarden o el cofre de tu proveedor de nube) para consultarla en el futuro.
- Si la clave se filtra o hay sospecha de compromiso, accede a la misma página de desarrolladores, localiza la clave en la lista y revócala de inmediato. Después, crea una nueva y actualiza tus integraciones.
¿Para qué sirven estas claves?
Las claves se usan en todas las llamadas a la API de Papo que requieren autenticación. La clave secreta se envía en el encabezado Authorization como un token Bearer. La clave pública puede enviarse en el encabezado X-Papo-Public-Key como verificación adicional, pero la autenticación principal siempre depende de la secreta.
Con las claves en mano, puedes, por ejemplo:
- Enviar mensajes de WhatsApp vía API.
- Consultar contactos extraídos por el Extrator.
- Activar la inteligencia artificial de Papo desde tu sistema.
- Sincronizar datos con tu CRM o ERP.
Preguntas frecuentes
¿Dónde encuentro la clave pública de mi cuenta?
La clave pública (pk_live_...) está visible en la página Configuración > Desarrolladores (o API). Es fija y puedes copiarla siempre que sea necesario.
¿Puedo tener más de una clave secreta?
Sí. Puedes generar varias claves secretas, cada una con un nombre diferente (ej.: “Producción”, “Prueba”, “n8n”). Esto ayuda a aislar accesos y revocar una clave específica sin afectar las demás.
Perdí mi clave secreta. ¿Qué hacer?
La clave secreta no se puede recuperar. Accede a la página de desarrolladores, revoca la clave perdida y crea una nueva. Actualiza tus integraciones con el nuevo valor.
¿Necesito la clave pública para autenticar?
No necesariamente. La autenticación se realiza con la clave secreta. La clave pública es opcional y sirve como identificador adicional, pero no sustituye a la secreta.
¿Cómo revocar una clave secreta?
En la lista de claves de la página de desarrolladores, localiza la clave que deseas desactivar y haz clic en la opción de revocar. A partir de ese momento, cualquier solicitud que utilice esa clave será rechazada.
¿Puedo usar las claves en herramientas como n8n o Zapier?
Sí. Las claves de API de Papo son compatibles con cualquier herramienta que admita autenticación mediante Bearer token. Basta con insertar la clave secreta en el campo de autorización de la herramienta.
Lee también
Crea tu cuenta gratuita en Papo y obtén acceso inmediato a las claves de API para integrar tus sistemas.