Per archiviare conversazioni e contatti in massa in modo programmatico, utilizza l'API REST di Papo. Con gli endpoint di aggiornamento dei contatti e di applicazione di etichette alle conversazioni, puoi contrassegnare i record come archiviati, mantenendo la base sempre pulita senza intervento manuale — ideale per operazioni con grandi volumi di dati o per rivendite white label che gestiscono più clienti.
Papo non richiede un endpoint esclusivo di “archiviazione”. Invece, usi le operazioni già disponibili nell'API per modificare lo stato dei record: aggiornare un contatto (aggiungendo un'etichetta di archiviazione o un attributo personalizzato) e applicare un'etichetta a una conversazione. In questo modo, script o automazioni riescono a elaborare migliaia di elementi in batch e organizzare la base secondo le regole del tuo business.
Riepilogo del processo di archiviazione in massa via API
| Fase | Azione | Dettaglio importante |
|---|---|---|
| 1. Ottenere le chiavi | Generare la chiave segreta (sk_live_…) e copiare la chiave pubblica (pk_live_…) nel pannello di Papo. | La chiave segreta appare una sola volta; conservala in un luogo sicuro. |
| 2. Identificare cosa archiviare | Elencare contatti o conversazioni che devono essere archiviati (per data, stato, assenza di interazione ecc.). | Usa gli endpoint di elenco con filtri o esporta un CSV per alimentare lo script. |
| 3. Archiviare contatti | Per ogni contatto, inviare una richiesta di aggiornamento includendo l'etichetta “archiviato” o un attributo personalizzato. | L'endpoint di aggiornamento del contatto accetta i campi che desideri modificare. |
| 4. Archiviare conversazioni | Per ogni conversazione, applicare un'etichetta come “archiviato” usando l'endpoint delle etichette. | L'etichetta viene creata automaticamente nell'account se non esiste ancora. |
| 5. Verificare il risultato | Controllare se i record appaiono con la marcatura di archiviazione e se i filtri della piattaforma riflettono la nuova organizzazione. | Regola i filtri nel modulo Contatti o Conversazioni per nascondere gli elementi archiviati. |
Come funziona – passo passo
1. Autenticazione e chiavi
Ogni chiamata che modifica dati richiede la chiave segreta dell'account. Deve essere inviata come token Bearer nell'header Authorization (o nell'header X-Papo-Secret-Key). La chiave pubblica (fissa per account) può accompagnare la richiesta nell'header X-Papo-Public-Key — il suo uso è opzionale, ma se inviata deve corrispondere allo stesso account della chiave segreta.
Genera le chiavi nel pannello di Papo, nell'area sviluppatore. L'URL base dell'API è https://app.papo.global/api/v1. Consulta la documentazione ufficiale per vedere gli endpoint esatti, i parametri e gli esempi di payload.
2. Identificare i record da archiviare
Prima di avviare gli aggiornamenti, devi sapere quali contatti o conversazioni devono essere archiviati. L'API offre endpoint di elenco che restituiscono i dati necessari. Ad esempio, puoi:
- Elencare contatti (ricerca per nome, e-mail, telefono o filtri per data) per selezionare quelli senza interazione da X giorni.
- Elencare conversazioni e incrociare con criteri come stato o data dell'ultimo messaggio.
Con la lista in mano, uno script in Python, Node.js o un'automazione in n8n può scorrere ogni record ed eseguire l'azione di archiviazione.
3. Archiviare contatti in massa
L'API di Papo permette di aggiornare un contatto esistente. Per archiviarlo, puoi:
- Aggiungere un'etichetta (es.: “archiviato”) al contatto. L'endpoint di aggiornamento accetta l'inclusione di tag.
- Oppure aggiornare un attributo personalizzato (se hai creato un campo come “stato” o “archiviato”) con il valore desiderato.
L'importante è che, dopo l'aggiornamento, il contatto porti una marcatura che lo differenzi da quelli attivi. Poiché l'API elabora un contatto per richiesta, l'operazione in massa viene eseguita eseguendo più chiamate in sequenza. Esempi di codice in JavaScript e Python sono disponibili nella documentazione dell'API e possono essere adattati per l'endpoint di aggiornamento.
4. Archiviare conversazioni in massa
Per le conversazioni, l'API offre un endpoint che crea un'etichetta nell'account (se non esiste) e la applica al contatto e alla conversazione aperta. Così, puoi creare l'etichetta “archiviato” e applicarla a tutte le conversazioni che desideri rimuovere dalla vista principale.
Il flusso è simile a quello dei contatti: elenca le conversazioni, filtra quelle che devono essere archiviate e, per ciascuna, invia la richiesta di applicazione dell'etichetta. L'etichetta verrà creata automaticamente alla prima chiamata, se non esiste ancora.
5. Verificare l'archiviazione
Dopo che lo script è terminato, accedi ai moduli Contatti e Conversazioni nel pannello di Papo. Utilizza i filtri per etichetta per visualizzare solo gli elementi contrassegnati come “archiviato” — o, al contrario, per nasconderli e mantenere il focus sui record attivi. Se l'operazione non ha l'effetto desiderato, rivedi i payload e gli header di autenticazione.
Per chi è indicata questa automazione
- Operazioni con grandi volumi di contatti che necessitano di pulire la base periodicamente, rimuovendo dalla vista principale lead freddi o conversazioni chiuse.
- Rivendite white label che gestiscono decine di account clienti e desiderano offrire un servizio di organizzazione automatizzata via API.
- Team IT e sviluppatori che costruiscono integrazioni personalizzate per mantenere il CRM sempre snello, senza dipendere da azioni manuali.
- Aziende che hanno migrato dati da altri sistemi e ora vogliono archiviare record vecchi che non saranno più utilizzati quotidianamente.
Domande frequenti
L'API di Papo ha un endpoint specifico per archiviare?
Non è necessario un endpoint esclusivo. Utilizzi gli endpoint di aggiornamento del contatto e di applicazione di etichette alle conversazioni per contrassegnare i record come archiviati. La documentazione ufficiale dettaglia i parametri accettati.
Posso eliminare contatti o conversazioni invece di archiviarli?
L'API attuale non offre endpoint di eliminazione. La raccomandazione è usare l'archiviazione tramite etichette o attributi personalizzati, che mantiene i dati preservati, ma fuori dalla vista principale.
Come faccio ad autenticare le richieste?
Includi l'header Authorization: Bearer {la_tua_chiave_segreta} in tutte le chiamate di scrittura. La chiave segreta viene generata nel pannello di Papo, nella sezione sviluppatore.
È possibile archiviare migliaia di record in una sola volta?
Sì. Basta creare uno script che faccia un loop sulla lista di contatti o conversazioni e invii una richiesta per ciascuno. Strumenti come n8n possono anche orchestrare questo processo.
Le conversazioni archiviate scompaiono dalla casella di posta?
Continuano a esistere, ma applicando un'etichetta come “archiviato”, puoi filtrarle fuori dalla vista predefinita. Il modo di visualizzazione dipende dai filtri configurati nel modulo Conversazioni.
Dove trovo le chiavi API?
Nel pannello di Papo, accedi all'area sviluppatore o alle configurazioni API. La chiave segreta viene mostrata solo al momento della creazione; se persa, sarà necessario generarne una nuova.
Leggi anche
- Come usare l'API di Papo per elencare conversazioni e inviare messaggi programmatici
- Come usare l'API di Papo per gestire attributi personalizzati dei contatti
Inizia gratis e organizza la tua base con l'API →
Con il piano gratuito di Papo puoi già testare l'integrazione e archiviare contatti e conversazioni in massa senza costi iniziali.