**Con l'API REST di [Papo](https://papo.global/), puoi elencare, cercare, creare, aggiornare e collegare contatti alle Aziende del CRM — tutto tramite richieste autenticate, senza aprire il pannello. È il modo programmatico per mantenere la gestione dei clienti B2B sincronizzata con sistemi esterni, ERP, CRM o strumenti di automazione.** L'API di Papo espone le risorse del modulo Aziende affinché la tua operazione organizzi account B2B, consolidi i contatti collegati e monitori le conversazioni recenti di ogni azienda. Con autenticazione tramite chiave segreta e risposte in JSON, questi endpoint permettono di integrare la visione degli account con script, automazioni e rivendite white label. ## Riepilogo delle operazioni sulle Aziende tramite API | Operazione | Cosa fa | Quando usarla | | :--- | :--- | :--- | | Elencare aziende | Restituisce le aziende registrate nel CRM con nome, dominio e numero di contatti. | Verificare la base di account o sincronizzare le aziende con un altro sistema. | | Cercare per nome o dominio | Individua aziende specifiche nel CRM. | Trovare l'account B2B prima di aggiornare i dati o collegare contatti. | | Dettagliare azienda | Restituisce i dati di un'azienda tramite l'identificatore. | Consultare un account specifico durante un'integrazione. | | Creare azienda | Crea una nuova azienda; il nome è obbligatorio, mentre dominio e descrizione sono opzionali. | Registrare account B2B automaticamente da un ERP, sito o flusso esterno. | | Aggiornare azienda | Aggiorna nome, dominio e descrizione di un'azienda esistente. | Mantenere il CRM sempre allineato con la base di clienti B2B. | | Collegare contatto | Collega un contatto esistente del CRM a un'azienda. | Consolidare la relazione e la cronologia tra contatti e account. | | Elencare contatti e conversazioni | Mostra i contatti collegati all'azienda e le conversazioni recenti di questi contatti. | Avere la visione completa dell'account durante l'assistenza o il follow-up. | ## Come funziona l'autenticazione dell'API Tutte le rotte di scrittura, incluse le operazioni sulle Aziende, richiedono la chiave segreta dell'account. Deve essere inviata come token Bearer. La chiave pubblica dell'account è opzionale, ma, se inviata, deve corrispondere allo stesso account della chiave segreta. L'URL base dell'API è `https://app.papo.global/api/v1`. Le chiavi vengono generate nell'area sviluppatore del pannello di Papo. La chiave segreta appare una sola volta alla creazione; conservala in un luogo sicuro e revocala se sospetti una fuga di dati. Poiché l'API è REST e utilizza JSON, qualsiasi linguaggio con supporto HTTP può essere usato per integrare le Aziende con script, ERP, CRM o strumenti di automazione. La documentazione ufficiale su `https://papo.global/pt/docs` contiene i dettagli su autenticazione, parametri, risposte ed esempi di codice. ## Come gestire le Aziende tramite API in pratica 1. Accedi all'area sviluppatore del pannello di Papo e genera una chiave segreta. Copia anche la chiave pubblica dell'account. 2. In ogni richiesta, autenticati con la chiave segreta come token Bearer. Se vuoi rafforzare la validazione, invia la chiave pubblica nell'header indicato nella documentazione. 3. Per elencare le aziende del CRM, chiama l'endpoint di elenco delle Aziende. La risposta contiene nome, dominio e numero di contatti di ogni account. 4. Per individuare un'azienda specifica, usa l'endpoint di ricerca per nome o dominio. Così ottieni l'identificatore necessario per aggiornare i dati o collegare contatti. 5. Per creare un'azienda, invia un payload JSON con il nome obbligatorio. Dominio e descrizione possono essere inclusi come dati opzionali. 6. Per aggiornare un'azienda, invia i nuovi valori di nome, dominio o descrizione nell'endpoint di aggiornamento. 7. Per collegare un contatto esistente, usa l'identificatore del contatto e l'identificatore dell'azienda nell'operazione di collegamento. Poiché l'API elabora un'operazione per richiesta, la gestione in massa avviene eseguendo chiamate in sequenza. Uno script in Python, Node.js o un'automazione in strumenti come n8n può leggere account da un CSV o ERP, registrare aziende, collegare contatti e raccogliere le risposte per la gestione degli errori. ## Per chi ha senso questa integrazione - **Aziende B2B che mantengono account in un altro CRM o ERP** e vogliono sincronizzarsi automaticamente con il modulo Aziende di Papo. - **Team commerciali che lavorano con clienti account**, come agenzie, consulenze, SaaS e provider, e devono consolidare contatti e conversazioni per azienda. - **Operazioni che acquisiscono aziende da formulari, landing page o sistemi esterni** e desiderano crearle nel CRM senza lavoro manuale ripetuto. - **Rivendite white label e integratori** che collegano Papo a sistemi dei clienti e vogliono mantenere la gestione degli account coerente tra ambienti diversi. - **Team IT che costruiscono integrazioni personalizzate** usando l'API come ponte tra la base delle aziende e il resto dell'operazione. ## Domande frequenti ### Devo creare il contatto prima di collegarlo a un'Azienda? Sì. L'API collega un contatto che esiste già nel CRM. Per registrare un nuovo contatto, usa gli endpoint di creazione dei contatti e poi esegui il collegamento con l'azienda. ### Quali dati posso aggiornare in un'Azienda tramite API? È possibile aggiornare nome, dominio e descrizione dell'azienda. La creazione richiede il nome; dominio e descrizione sono opzionali. ### L'API permette di elencare le conversazioni di un'Azienda? Sì. Il modulo Aziende permette di elencare i contatti collegati a un'azienda e le conversazioni recenti di questi contatti, facilitando la visione dell'account durante l'assistenza. ### L'autenticazione è la stessa usata negli altri endpoint di Papo? Sì. Le rotte di scrittura richiedono la chiave segreta dell'account, inviata come token Bearer. La chiave pubblica è opzionale e, se inviata, deve corrispondere allo stesso account. ### Dove trovo i percorsi esatti e il formato del payload? Nella documentazione ufficiale dell'API, disponibile su `https://papo.global/pt/docs`. Lì trovi i dettagli su autenticazione, parametri, risposte ed esempi di codice per Aziende e altre risorse. ### Posso usare l'API per sincronizzare la base delle Aziende con il mio CRM attuale? Sì. Poiché l'API è REST e utilizza JSON, puoi automatizzare elenco, creazione, aggiornamento e collegamento dei contatti in sequenza, mantenendo i due sistemi allineati. ## Leggi anche - [Come usare il modulo Aziende nel CRM di Papo](/hc/papo/articles/come-usare-modulo-aziende-crm-papo) - Come usare l'API di Papo per gestire gli attributi personalizzati dei contatti --- **[Inizia gratis e gestisci le Aziende nel CRM tramite API →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-usare-api-papo-gestire-aziende-crm&utm_content=it)** Il primo utente di Papo è gratuito per sempre, senza carta.