Per generare le chiavi API di Papo (https://papo.global/), accedi al pannello e vai su Impostazioni > Sviluppatori (o API). Lì trovi la tua chiave pubblica fissa e puoi creare chiavi segrete con nome, che vengono mostrate una sola volta e devono essere conservate in un luogo sicuro, come un gestore di password o variabili d'ambiente sul server.
L'API di Papo utilizza una coppia di chiavi per identificare e autenticare il tuo account nelle integrazioni con CRM, ERP, piattaforme di automazione (n8n, Zapier) e sistemi proprietari. Capire la differenza tra queste chiavi e sapere come generarle e proteggerle è il primo passo per costruire automazioni affidabili.
| Tipo di chiave | Formato | Funzione | Livello di esposizione |
|---|---|---|---|
| Chiave pubblica | pk_live_... |
Identifica il tuo account Papo in modo univoco. | Può essere esposta nel frontend o in script pubblici. |
| Chiave segreta | sk_live_... |
Autentica le richieste e autorizza azioni sul tuo account. | Riservata – non deve mai essere condivisa o versionata nel codice. |
Come generare le chiavi API
- Accedi al pannello di Papo e vai su Impostazioni.
- Nel menu laterale, individua la sezione Sviluppatori o API.
- La pagina mostrerà la tua Chiave pubblica (
pk_live_...). È fissa e può essere copiata in qualsiasi momento. - Per ottenere una Chiave segreta, fai clic sul pulsante per creare una nuova chiave.
- Assegna un nome descrittivo (es.: “Integrazione CRM”, “Automazione n8n”) per facilitare la gestione futura.
- La chiave segreta (
sk_live_...) sarà mostrata una sola volta. Copiala immediatamente e conservala in un luogo sicuro.
⚠️ Per sicurezza, Papo archivia solo l'hash della chiave segreta. Se perdi il valore originale, non sarà possibile recuperarlo. In tal caso, revoca la chiave compromessa e generane una nuova.
Come conservare le chiavi in modo sicuro
- Mai inserire la chiave segreta direttamente nel codice sorgente, in repository Git o in messaggi.
- Usa variabili d'ambiente sul tuo server (es.:
PAPO_SECRET_KEY) e richiamale nel codice. - Conserva la chiave in un gestore di password (come 1Password, Bitwarden o il vault del tuo provider cloud) per consultazioni future.
- Se la chiave trapela o sospetti una compromissione, accedi alla stessa pagina sviluppatori, individua la chiave nell'elenco e revocala immediatamente. Poi creane una nuova e aggiorna le tue integrazioni.
A cosa servono queste chiavi?
Le chiavi vengono usate in tutte le chiamate all'API di Papo che richiedono autenticazione. La chiave segreta viene inviata nell'header Authorization come token Bearer. La chiave pubblica può essere inviata nell'header X-Papo-Public-Key come verifica aggiuntiva, ma l'autenticazione principale dipende sempre da quella segreta.
Con le chiavi a disposizione, puoi, ad esempio:
- Inviare messaggi WhatsApp tramite API.
- Consultare i contatti estratti da Extrator.
- Attivare l'intelligenza artificiale di Papo dal tuo sistema.
- Sincronizzare dati con il tuo CRM o ERP.
Domande frequenti
Dove trovo la chiave pubblica del mio account?
La chiave pubblica (pk_live_...) è visibile nella pagina Impostazioni > Sviluppatori (o API). È fissa e può essere copiata ogni volta che serve.
Posso avere più di una chiave segreta?
Sì. Puoi generare più chiavi segrete, ciascuna con un nome diverso (es.: “Produzione”, “Test”, “n8n”). Questo aiuta a isolare gli accessi e a revocare una chiave specifica senza influire sulle altre.
Ho perso la mia chiave segreta. Cosa fare?
La chiave segreta non può essere recuperata. Accedi alla pagina sviluppatori, revoca la chiave persa e creane una nuova. Aggiorna le tue integrazioni con il nuovo valore.
Serve la chiave pubblica per autenticarsi?
Non necessariamente. L'autenticazione avviene tramite la chiave segreta. La chiave pubblica è opzionale e serve come identificatore aggiuntivo, ma non sostituisce quella segreta.
Come revocare una chiave segreta?
Nell'elenco delle chiavi della pagina sviluppatori, individua la chiave che desideri disattivare e fai clic sull'opzione per revocarla. Da quel momento, qualsiasi richiesta che utilizzi quella chiave verrà rifiutata.
Posso usare le chiavi in strumenti come n8n o Zapier?
Sì. Le chiavi API di Papo sono compatibili con qualsiasi strumento che supporti l'autenticazione tramite Bearer token. È sufficiente inserire la chiave segreta nel campo di autorizzazione dello strumento.
Leggi anche
Crea il tuo account gratuito su Papo e ottieni accesso immediato alle chiavi API per integrare i tuoi sistemi.