**Per integrare il tuo account con sistemi esterni come CRM, ERP o piattaforme di automazione (n8n, Zapier), Papo (https://papo.global/) offre chiavi API (Application Programming Interface) che possono essere generate e gestite direttamente nel tuo pannello. Queste chiavi funzionano come credenziali sicure che autorizzano altri software ad accedere ed eseguire azioni sul tuo account Papo in modo programmatico.** L'API di Papo ti permette di costruire ecosistemi di lavoro connessi, automatizzando attività che vanno dall'invio di messaggi WhatsApp all'estrazione di lead qualificati. Per garantire la sicurezza, Papo utilizza un sistema a due chiavi: una pubblica, per l'identificazione, e una segreta, per l'autenticazione. | Tipo di Chiave | Descrizione | Livello di Sicurezza | Esempio di Utilizzo | | :--- | :--- | :--- | :--- | | **Chiave Pubblica (`pk_live_...`)** | Un identificatore unico e fisso per il tuo account Papo. | Basso. Può essere esposta pubblicamente. | Identificare il tuo account in uno script nel frontend del tuo sito. | | **Chiave Segreta (`sk_live_...`)** | Una "password" per l'API. Autentica le tue richieste e concede il permesso di agire per conto del tuo account. | Alto. Deve essere mantenuta in segreto assoluto. | Autenticare una chiamata API dal tuo server (backend) per inviare un messaggio. | ## Come generare e trovare le tue chiavi API Le chiavi API sono gestite in un'area specifica del tuo account Papo. Segui i passaggi seguenti per accedervi. 1. Accedi al tuo pannello Papo e vai su **Impostazioni**. 2. Nel menu delle impostazioni, cerca la sezione **Sviluppatori** o **API**. 3. In questa pagina, troverai la tua **Chiave Pubblica (`pk_live_...`)**, che è fissa e può essere copiata in qualsiasi momento. 4. Per la **Chiave Segreta**, dovrai generarne una nuova. Clicca sul pulsante per creare una nuova chiave. 5. Dai un nome descrittivo alla chiave, indicando dove verrà utilizzata (es: "Integrazione CRM", "Automazione N8N"). Questo aiuta a identificare e revocare chiavi specifiche se necessario. 6. Dopo la creazione, la **Chiave Segreta (`sk_live_...`) verrà visualizzata una sola volta**. Copiala e conservala in un luogo sicuro, come un gestore di password o una variabile d'ambiente sul tuo server. Per motivi di sicurezza, Papo non memorizza il valore originale della chiave e non potrà visualizzarla nuovamente. Se perdi una chiave segreta o sospetti che sia stata compromessa, revocala immediatamente nel pannello e creane una nuova. ## Come usare le chiavi per autenticarsi all'API Tutte le comunicazioni con l'API di Papo che coinvolgono azioni o accesso a dati privati devono essere autenticate. Ciò avviene inviando la chiave segreta in un'intestazione HTTP. L'URL base per tutte le chiamate API è: `https://app.papo.global/api/v1` Per autenticarti, includi la tua chiave segreta nell'intestazione `Authorization` della tua richiesta, preceduta dalla parola `Bearer`. **Esempio di richiesta con `curl` per ottenere i dati del tuo account:** ```bash curl https://app.papo.global/api/v1/me \ -H "Authorization: Bearer sk_live_SUA_CHAVE_SECRETA_AQUI" ``` In questo esempio: * `sk_live_SUA_CHAVE_SECRETA_AQUI` deve essere sostituita con la tua chiave segreta reale. * L'endpoint `/me` restituisce informazioni sull'account autenticato, fungendo da buon test per verificare se la tua chiave funziona. La chiave pubblica (`pk_live_...`) può essere inviata opzionalmente nell'intestazione `X-Papo-Public-Key` come verifica aggiuntiva, ma l'autenticazione principale è sempre effettuata tramite la chiave segreta. ## Cosa puoi fare con l'API di Papo? L'API apre un ventaglio di possibilità per automatizzare e integrare le tue operazioni. Ecco alcuni esempi di ciò che puoi fare: * **Inviare messaggi WhatsApp:** Crea script per inviare notifiche, avvisi o messaggi transazionali tramite uno dei tuoi numeri connessi. * **Cercare contatti dall'Estrattore:** Accedi all'elenco dei lead che hai estratto con l'Estrattore di CNPJ per sincronizzarli con il tuo CRM principale. * **Gestire istanze:** Elenca e verifica lo stato delle tue connessioni WhatsApp. * **Utilizzare l'Intelligenza Artificiale:** Invia testi al motore AI di Papo e ricevi risposte generate in base ai tuoi prompt configurati. * **Sincronizzare i dati:** Mantieni i tuoi sistemi interni (ERP, BI) aggiornati con i dati generati su Papo. ## Domande Frequenti (FAQ) ### Dove trovo la documentazione completa dell'API? La documentazione tecnica dettagliata, con tutti gli endpoint, i parametri e gli esempi di codice in diverse lingue (JavaScript, Python), è disponibile pubblicamente su **papo.global/pt/docs**. ### La mia chiave segreta è stata compromessa. Cosa devo fare? Se sospetti che la tua chiave segreta sia stata compromessa, accedi immediatamente all'area sviluppatori nel tuo pannello Papo, trova la chiave compromessa nell'elenco e clicca per **revocarla**. Una volta revocata, non potrà più essere utilizzata per autenticare le richieste. Successivamente, genera una nuova chiave per sostituire quella vecchia nelle tue integrazioni. ### Quante chiavi segrete posso creare? Puoi creare più chiavi segrete. È una buona pratica di sicurezza generare una chiave diversa per ogni sistema o ambiente che integri (es: una per il tuo CRM, un'altra per il tuo sistema di automazione, una per l'ambiente di test, ecc.). Ciò consente di revocare l'accesso a un sistema specifico senza influenzare gli altri. ### Posso usare la chiave pubblica nel frontend del mio sito? Sì, la chiave pubblica (`pk_live_...`) è stata progettata per essere sicura per l'uso in ambienti pubblici, come il codice JavaScript del tuo sito. La sua funzione è solo quella di identificare il tuo account, non di autenticare le azioni. La chiave segreta, d'altra parte, non dovrebbe mai essere esposta nel codice lato client. ### Qual è la differenza tra l'API di Papo e un Webhook? La differenza principale sta in chi avvia la comunicazione. Con l'**API**, il tuo sistema avvia l'azione: tu "chiedi" (pull) dati a Papo o "ordini" (push) a Papo di fare qualcosa, come inviare un messaggio. Con un **Webhook**, Papo avvia l'azione: "spinge" (push) i dati al tuo sistema automaticamente quando si verifica un evento specifico (es: un contatto raggiunge una fase di un Flow). ### Qual è la differenza tra l'API di Papo e l'API Ufficiale di WhatsApp? L'API Ufficiale di WhatsApp è focalizzata esclusivamente sulle funzionalità del canale WhatsApp. L'API di Papo è uno strato di astrazione più ampio e potente: ti permette di controllare non solo WhatsApp, ma anche altri moduli della piattaforma, come il CRM, l'Estrattore di Lead e il motore di Intelligenza Artificiale, tutto con un unico set di chiavi e in modo semplificato. ## Leggi anche * [Come usare l'azione Webhook nei Flow di Automazione per integrare con altri sistemi](/hc/papo/articles/come-usare-l-azione-webhook-nei-flow-di-automazione-papo) * Posso usare lo stesso numero di WhatsApp Business App nell'API Ufficiale di Papo? --- **[Inizia a integrare gratuitamente →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-generare-e-usare-chiavi-api-integrazione-altri-sistemi&utm_content=it)** Il primo utente è gratuito per testare le automazioni e le integrazioni sul tuo numero.