**Per iniziare a usare l'API di Papo Global (https://papo.global/), devi generare una chiave segreta nel pannello, autenticare le richieste con l'header Authorization e fare chiamate REST alla base `https://app.papo.global/api/v1`. Il primo test pratico è listare i contatti dell'Extrator con un semplice comando cURL.**

L'API di Papo è REST, usa JSON e accetta richieste da qualsiasi origine (CORS abilitato). Con essa puoi collegare CRM, piattaforme di automazione (come n8n), ERP o il tuo backend all'ecosistema di assistenza, vendite e IA di Papo.

## Riepilogo degli elementi essenziali

| Elemento | Descrizione |
|---|---|
| Chiave pubblica (`pk_live_…`) | Identificatore fisso del tuo account, può essere esposta nel front-end |
| Chiave segreta (`sk_live_…`) | Token di autenticazione, deve essere mantenuto segreto e usato solo sul server |
| Autenticazione | Header `Authorization: Bearer sk_live_...` (o `X-Papo-Secret-Key`) in tutte le chiamate tranne GET `/api/v1` |
| Base URL | `https://app.papo.global/api/v1` |
| Endpoint di esempio | `GET /api/v1/contacts` — elenca i contatti estratti (Extrator), con paginazione |

## Passo passo per la prima chiamata

### 1. Crea le tue chiavi API
Accedi alla pagina sviluppatori nel pannello di Papo (disponibile su `app.papo.global/developers`). Lì puoi generare una chiave segreta con nome — ad esempio, “primo-test” — e copiarla immediatamente. La chiave viene mostrata una sola volta; dopodiché potrai solo revocarla e crearne un'altra.

La chiave pubblica (`pk_live_…`) è fissa per account e rimane visibile in questa stessa pagina in qualsiasi momento. Sebbene opzionale nelle richieste, se la invii, deve essere associata allo stesso account della chiave segreta.

### 2. Scegli l'endpoint
Per questa guida, useremo `GET /api/v1/contacts`, che elenca i lead estratti dal modulo Extrator. Puoi paginare i risultati con i parametri `page` (predefinito 1) e `per_page` (da 1 a 100, predefinito 20). È accettata anche una query di testo con `q` per cercare per azienda, telefono o email.

### 3. Effettua la chiamata con cURL
Con la chiave segreta in mano, componi la richiesta. L'esempio seguente elenca fino a 20 contatti:

```
curl "https://app.papo.global/api/v1/contacts?page=1&per_page=20" \
  -H "Authorization: Bearer sk_live_…"
```

Sostituisci `sk_live_…` con la tua chiave segreta. Se vuoi usare l'header alternativo, fai:

```
curl "https://app.papo.global/api/v1/contacts" \
  -H "X-Papo-Secret-Key: sk_live_…"
```

La risposta è un JSON con `success: true` e i dati all'interno dell'oggetto `data`. In caso di errore, il JSON conterrà `success: false` e un oggetto `error` con codice e messaggio esplicativi.

Da qui, puoi esplorare altri endpoint documentati nella [pagina API](https://papo.global/pt/docs), come invio messaggi (`POST /api/v1/messages`), dettagli account (`GET /api/v1/me`) o completare testi con l'IA (`POST /api/ai/v1/complete`).

## A chi è rivolto questo guida
Questo contenuto è rivolto agli sviluppatori che desiderano integrare Papo con sistemi esterni — CRM, strumenti di automazione (n8n, ad esempio) o applicazioni proprie. Se sei un utente finale che vuole solo connettere canali e assistere, la Centro Assistenza offre altri articoli più adatti.

## Domande frequenti

### Devo inviare la chiave pubblica in tutte le chiamate?
No. La chiave pubblica è opzionale. Se scegli di inviarla, deve corrispondere all'account della chiave segreta utilizzata.

### La chiave segreta scade?
Non scade automaticamente. Puoi revocarla in qualsiasi momento dal pannello e crearne una nuova, se sospetti una fuga.

### Posso testare l'API con un account gratuito?
Sì. Il primo utente di Papo è gratuito e puoi generare chiavi per esplorare l'API. Gli accessi a moduli come Extrator possono consumare credito in base all'uso, ma la creazione delle chiavi e le chiamate di lettura di base sono testabili senza costi aggiuntivi.

### Cosa fare se perdo la chiave segreta?
Crea una nuova chiave con nome nel pannello sviluppatori. La chiave precedente non potrà essere recuperata; solo revocata per sicurezza.

### Posso usare l'API per inviare messaggi in massa?
Sì, l'endpoint `POST /api/v1/messages` permette di inviare messaggi di testo. Tuttavia, rispetta le politiche di consenso e i termini di utilizzo della piattaforma.

### L'API elenca solo i contatti dell'Extrator?
L'endpoint `GET /api/v1/contacts` restituisce i contatti estratti. Per gestire la base unificata del CRM (cercare, creare e aggiornare qualsiasi contatto), puoi consultare la documentazione completa dell'API.

Leggi anche: [Come usare l'API di Papo per creare un modulo di registrazione e popolare automaticamente il CRM](/hc/papo/articles/come-usare-api-papo-modulo-registrazione-crm-automatico) · [Come usare l'API di Papo per monitorare il consumo di crediti e le fatture della rivendita white label](/hc/papo/articles/api-papo-monitorare-consumo-crediti-fatture-rivendita-white-label)

---

**[Inizia gratis su Papo Global →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-muovere-primi-passi-api-papo-autenticazione-prima-chiamata&utm_content=it)**

Primo utente R$ 0, senza carta. Scopri di più su [papo.global](https://papo.global).