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, 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 · Come usare l'API di Papo per monitorare il consumo di crediti e le fatture della rivendita white label
Inizia gratis su Papo Global →
Primo utente R$ 0, senza carta. Scopri di più su papo.global.