**Para integrar tu cuenta con sistemas externos como CRMs, ERPs o plataformas de automatización (n8n, Zapier), Papo (https://papo.global/) ofrece claves de API (Application Programming Interface) que pueden ser generadas y gestionadas directamente en tu panel. Estas claves funcionan como credenciales seguras que autorizan a otros softwares a acceder y ejecutar acciones en tu cuenta Papo de forma programática.** La API de Papo te permite construir ecosistemas de trabajo conectados, automatizando tareas que van desde el envío de mensajes de WhatsApp hasta la extracción de leads cualificados. Para garantizar la seguridad, Papo utiliza un sistema de dos claves: una pública, para identificación, y una secreta, para autenticación. | Tipo de Clave | Descripción | Nivel de Seguridad | Ejemplo de Uso | | :--- | :--- | :--- | :--- | | **Clave Pública (`pk_live_...`)** | Un identificador único y fijo para tu cuenta Papo. | Bajo. Puede ser expuesta públicamente. | Identificar tu cuenta en un script en el frontend de tu sitio web. | | **Clave Secreta (`sk_live_...`)** | Una "contraseña" para la API. Autentica tus solicitudes y concede permiso para actuar en nombre de tu cuenta. | Alto. Debe mantenerse en secreto absoluto. | Autenticar una llamada de API desde tu servidor (backend) para enviar un mensaje. | ## Cómo generar y encontrar tus claves de API Las claves de API se gestionan en un área específica de tu cuenta Papo. Sigue los pasos a continuación para acceder a ellas. 1. Accede a tu panel de Papo y navega hasta **Configuración**. 2. En el menú de configuración, busca la sección de **Desarrolladores** o **API**. 3. En esta página, encontrarás tu **Clave Pública (`pk_live_...`)**, que es fija y puede copiarse en cualquier momento. 4. Para la **Clave Secreta**, necesitarás generar una nueva. Haz clic en el botón para crear una nueva clave. 5. Asigna un nombre descriptivo a la clave, indicando dónde se utilizará (ej: "Integración CRM", "Automatización N8N"). Esto ayuda a identificar y revocar claves específicas si es necesario. 6. Después de la creación, la **Clave Secreta (`sk_live_...`) se mostrará una única vez**. Cópiala y guárdala en un lugar seguro, como un gestor de contraseñas o una variable de entorno en tu servidor. Por razones de seguridad, Papo no almacena el valor original de la clave y no podrá mostrarla de nuevo. Si pierdes una clave secreta o sospechas que se ha filtrado, revócala inmediatamente en el panel y crea una nueva. ## Cómo usar las claves para autenticarse en la API Toda comunicación con la API de Papo que involucre acciones o acceso a datos privados debe ser autenticada. Esto se hace enviando la clave secreta en un encabezado HTTP. La URL base para todas las llamadas de API es: `https://app.papo.global/api/v1` Para autenticarte, incluye tu clave secreta en el encabezado `Authorization` de tu solicitud, precedida por la palabra `Bearer`. **Ejemplo de solicitud con `curl` para obtener datos de tu cuenta:** ```bash curl https://app.papo.global/api/v1/me \ -H "Authorization: Bearer sk_live_TU_CLAVE_SECRETA_AQUI" ``` En este ejemplo: * `sk_live_TU_CLAVE_SECRETA_AQUI` debe ser reemplazada por tu clave secreta real. * El endpoint `/me` devuelve información sobre la cuenta autenticada, sirviendo como una buena prueba para verificar si tu clave está funcionando. La clave pública (`pk_live_...`) puede enviarse opcionalmente en el encabezado `X-Papo-Public-Key` como una verificación adicional, pero la autenticación principal siempre se realiza mediante la clave secreta. ## ¿Qué puedes hacer con la API de Papo? La API abre un abanico de posibilidades para automatizar e integrar tus operaciones. Aquí tienes algunos ejemplos de lo que puedes hacer: * **Enviar mensajes de WhatsApp:** Crea scripts para enviar notificaciones, alertas o mensajes transaccionales a través de uno de tus números conectados. * **Buscar contactos del Extractor:** Accede a la lista de leads que has extraído con el Extractor de CNPJ para sincronizarlos con tu CRM principal. * **Gestionar instancias:** Lista y verifica el estado de tus conexiones de WhatsApp. * **Utilizar la Inteligencia Artificial:** Envía textos al motor de IA de Papo y recibe respuestas generadas en base a tus prompts configurados. * **Sincronizar datos:** Mantén tus sistemas internos (ERP, BI) actualizados con los datos generados en Papo. ## Preguntas Frecuentes (FAQ) ### ### ¿Dónde encuentro la documentación completa de la API? La documentación técnica detallada, con todos los endpoints, parámetros y ejemplos de código en diferentes lenguajes (JavaScript, Python), está disponible públicamente en **papo.global/pt/docs**. ### ### Mi clave secreta se ha filtrado. ¿Qué hago? Si sospechas que tu clave secreta ha sido comprometida, accede inmediatamente al área de desarrolladores en tu panel de Papo, encuentra la clave filtrada en la lista y haz clic para **revocarla**. Una vez revocada, ya no podrá usarse para autenticar solicitudes. Luego, genera una nueva clave para reemplazar la antigua en tus integraciones. ### ### ¿Cuántas claves secretas puedo crear? Puedes crear múltiples claves secretas. Es una buena práctica de seguridad generar una clave diferente para cada sistema o entorno que integres (ej: una para tu CRM, otra para tu sistema de automatización, una para el entorno de pruebas, etc.). Esto permite revocar el acceso de un sistema específico sin afectar a los demás. ### ### ¿Puedo usar la clave pública en el frontend de mi sitio web? Sí, la clave pública (`pk_live_...`) está diseñada para ser segura para su uso en entornos públicos, como el código JavaScript de tu sitio web. Su función es solo identificar tu cuenta, no autenticar acciones. La clave secreta, por otro lado, nunca debe exponerse en el código del lado del cliente. ### ### ¿Cuál es la diferencia entre la API de Papo y un Webhook? La principal diferencia radica en quién inicia la comunicación. Con la **API**, tu sistema inicia la acción: tú "pides" (pull) datos de Papo o "mandas" (push) a Papo hacer algo, como enviar un mensaje. Con un **Webhook**, Papo inicia la acción: "empuja" (push) datos a tu sistema automáticamente cuando ocurre un evento específico (ej: un contacto llega a una etapa de un Flow). ### ### ¿Cuál es la diferencia entre la API de Papo y la API Oficial de WhatsApp? La API Oficial de WhatsApp se centra exclusivamente en las funcionalidades del canal de WhatsApp. La API de Papo es una capa de abstracción más amplia y potente: te permite controlar no solo WhatsApp, sino también otros módulos de la plataforma, como el CRM, el Extractor de Leads y el motor de Inteligencia Artificial, todo con un único conjunto de claves y de forma simplificada. ## Lee también * [Cómo usar la acción de Webhook en los Flows de Automatización para integrar con otros sistemas](/hc/papo/articles/como-usar-accion-webhook-flows-automatizacion-integrar-sistemas) * [¿Puedo usar el mismo número de WhatsApp Business App en la API Oficial de Papo?](/hc/papo/articles/puedo-usar-el-mismo-numero-de-whatsapp-business-app-en-la-api-oficial-de-papo) --- **[Empieza a integrar gratis →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=como-generar-y-usar-claves-de-api-para-integrar-sistemas&utm_content=es)** El primer usuario es gratis para que pruebes las automatizaciones e integraciones en tu número.