**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](https://papo.global/pt/docs), 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](/hc/papo/articles/como-usar-api-papo-formulario-registro-crm-automatico) · [Cómo usar la API de Papo para monitorear el consumo de créditos y facturas de la reventa white label](/hc/papo/articles/api-papo-monitorear-creditos-facturas-white-label)

---

**[Comience gratis en Papo Global →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=como-dar-primeros-pasos-api-papo-autenticacion-primera-llamada&utm_content=es)**

Primer usuario R$ 0, sin tarjeta. Obtenga más información en [papo.global](https://papo.global).