Con l'API REST di Papo, 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
- Accedi all'area sviluppatore del pannello di Papo e genera una chiave segreta. Copia anche la chiave pubblica dell'account.
- 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.
- 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.
- 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.
- Per creare un'azienda, invia un payload JSON con il nome obbligatorio. Dominio e descrizione possono essere inclusi come dati opzionali.
- Per aggiornare un'azienda, invia i nuovi valori di nome, dominio o descrizione nell'endpoint di aggiornamento.
- 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
- Come usare l'API di Papo per gestire gli attributi personalizzati dei contatti
Inizia gratis e gestisci le Aziende nel CRM tramite API → Il primo utente di Papo è gratuito per sempre, senza carta.