Para comenzar a usar la API de Papo Global (https://papo.global/), necesita generar una clave secreta en el panel, autenticar las solicitudes con el encabezado Authorization y realizar llamadas REST a la base https://app.papo.global/api/v1. La primera prueba práctica es listar contactos del Extrator con un simple comando cURL.
La API de Papo es REST, usa JSON y acepta solicitudes de cualquier origen (CORS liberado). Con ella, conecta CRMs, plataformas de automatización (como n8n), ERPs o su propio backend al ecosistema de atención, ventas e IA de Papo.
Resumen de los elementos esenciales
| Elemento | Descripción |
|---|---|
Clave pública (pk_live_…) |
Identificador fijo de su cuenta, puede exponerse en el front-end |
Clave secreta (sk_live_…) |
Token de autenticación, debe mantenerse en secreto y usarse solo en el servidor |
| Autenticación | Encabezado Authorization: Bearer sk_live_... (o X-Papo-Secret-Key) en todas las llamadas excepto GET /api/v1 |
| Base URL | https://app.papo.global/api/v1 |
| Endpoint de ejemplo | GET /api/v1/contacts — lista contactos extraídos (Extrator), con paginación |
Paso a paso para la primera llamada
1. Cree sus claves de API
Acceda a la página de desarrolladores en el panel de Papo (disponible en app.papo.global/developers). Allí puede generar una clave secreta nombrada — por ejemplo, “primer-test” — y copiarla inmediatamente. La clave se muestra una única vez; después de eso, solo podrá revocarla y crear otra.
La clave pública (pk_live_…) es fija por cuenta y permanece visible en esa misma página en cualquier momento. Aunque es opcional en las solicitudes, si la envía, debe estar asociada a la misma cuenta de la clave secreta.
2. Elija el endpoint
Para esta guía, usaremos GET /api/v1/contacts, que lista los leads extraídos por el módulo Extrator. Puede paginar los resultados con los parámetros page (predeterminado 1) y per_page (1 a 100, predeterminado 20). También se acepta una consulta de texto con q para buscar por empresa, teléfono o correo electrónico.
3. Realice la llamada con cURL
Con la clave secreta en mano, arme la solicitud. El siguiente ejemplo lista hasta 20 contactos:
curl "https://app.papo.global/api/v1/contacts?page=1&per_page=20" \
-H "Authorization: Bearer sk_live_…"
Reemplace sk_live_… por su clave secreta. Si desea usar el encabezado alternativo, haga:
curl "https://app.papo.global/api/v1/contacts" \
-H "X-Papo-Secret-Key: sk_live_…"
La respuesta es un JSON con success: true y los datos dentro del objeto data. Si hay un error, el JSON traerá success: false y un objeto error con código y mensaje explicativos.
A partir de aquí, puede explorar otros endpoints documentados en la página de la API, como envío de mensajes (POST /api/v1/messages), detalles de la cuenta (GET /api/v1/me) o completar textos con la IA (POST /api/ai/v1/complete).
Para quién es esta guía
Este contenido está dirigido a desarrolladores que desean integrar Papo con sistemas externos — CRMs, herramientas de automatización (n8n, por ejemplo) o aplicaciones propias. Si usted es un usuario final que solo quiere conectar canales y atender, la Central de Ayuda ofrece otros artículos más adecuados.
Preguntas frecuentes
¿Necesito enviar la clave pública en todas las llamadas?
No. La clave pública es opcional. Si opta por enviarla, debe coincidir con la cuenta de la clave secreta utilizada.
¿La clave secreta expira?
No expira automáticamente. Puede revocarla en cualquier momento desde el panel y crear una nueva, si sospecha de un filtrado.
¿Puedo probar la API con una cuenta gratuita?
Sí. El primer usuario de Papo es gratuito y puede generar claves para explorar la API. Los accesos a módulos como Extrator pueden consumir saldo según el uso, pero la creación de claves y las llamadas básicas de lectura se pueden probar sin costo adicional.
¿Qué hacer si pierdo la clave secreta?
Cree una nueva clave nombrada en el panel de desarrolladores. La clave anterior no podrá recuperarse; solo revocarse por seguridad.
¿Puedo usar la API para enviar mensajes masivos?
Sí, el endpoint POST /api/v1/messages permite enviar mensajes de texto. Sin embargo, respete las políticas de consentimiento y los términos de uso de la plataforma.
¿La API lista solo contactos del Extrator?
El endpoint GET /api/v1/contacts devuelve los contactos extraídos. Para gestionar la base unificada del CRM (buscar, crear y actualizar cualquier contacto), puede consultar la documentación completa de la API.
Lea también: Cómo usar la API de Papo para crear un formulario de registro y poblar el CRM automáticamente · Cómo usar la API de Papo para monitorear el consumo de créditos y facturas de la reventa white label
Comience gratis en Papo Global →
Primer usuario R$ 0, sin tarjeta. Obtenga más información en papo.global.