**Per gestire Sequenze di follow-up tramite API in [Papo](https://papo.global/), puoi elencare le cadenze disponibili, iscrivere contatti e mettere in pausa la partecipazione di un lead usando l'aggiornamento di attributi personalizzati — tutto tramite richieste autenticate, senza aprire il pannello. È il modo per integrare la nutrizione dei lead con CRM, ERP e flussi di automazione esterni.**

## Riepilogo delle operazioni tramite API

| Operazione | Descrizione | Come viene eseguita dall'API |
| :--- | :--- | :--- |
| **Elencare sequenze** | Ottenere tutte le cadenze di follow-up dell'account, con nome, identificatore e stato (attivo/inattivo). | Richiesta GET autenticata all'endpoint dei flows, filtrando per il tipo "sequence". |
| **Iscrivere contatto** | Inserire un contatto esistente in una sequenza attiva, avviando il percorso di messaggi. | POST con l'ID del contatto e l'ID della sequenza all'endpoint di iscrizione. |
| **Mettere in pausa la cadenza per un contatto** | Interrompere temporaneamente gli invii per un lead senza rimuoverlo dalla sequenza. | Aggiornamento dell'attributo personalizzato del contatto (es.: `status_pausa`) tramite API dei contatti, combinato con una condizione nel Flow. |

## Come funzionano l'autenticazione e gli endpoint

Tutte le operazioni usano l'API REST di Papo, autenticata con la **chiave segreta** dell'account (token Bearer). L'URL di base è `https://app.papo.global/api/v1`. Le chiavi vengono generate nel pannello, nell'area sviluppatori.

Le risorse delle sequenze sono raggruppate negli endpoint dei **flows**. L'API permette di elencare tutti i flows, inclusi quelli di tipo "sequence", e anche di attivare/disattivare un intero flow. Per iscrivere un contatto, esiste un endpoint specifico che riceve l'identificatore del contatto e quello del flow.

I dettagli esatti di ogni endpoint (parametri, payload ed esempi) sono disponibili nella documentazione ufficiale dell'API di Papo. Qui ci concentriamo sul flusso di lavoro per gestire sequenze di follow-up.

## Passo a passo: elencare, iscrivere e mettere in pausa

### 1. Elencare le sequenze disponibili

Prima di iscrivere lead, devi sapere quali sequenze esistono e i loro identificatori. La chiamata di elenco restituisce un elenco con nome, ID e stato (attivo/inattivo). Solo le sequenze attive accettano nuove iscrizioni.

Con la lista a disposizione, il tuo sistema esterno può mappare quale sequenza usare per ogni lead.

### 2. Iscrivere un contatto a una sequenza

Con l'ID del contatto (ottenuto tramite ricerca o creazione con l'API dei contatti) e l'ID della sequenza attiva, invii una richiesta per inserirlo all'inizio del percorso. Il contatto deve esistere nel CRM di Papo; in caso contrario, crealo prima usando l'endpoint dei contatti.

L'iscrizione avvia immediatamente l'invio dei messaggi programmati, rispettando gli intervalli configurati nel Flow. La cronologia del contatto viene preservata.

### 3. Mettere in pausa la cadenza per un contatto specifico

L'API di Papo non ha un comando diretto per "mettere in pausa" la partecipazione di un contatto a una sequenza. Tuttavia, puoi ottenere lo stesso effetto combinando l'API dei contatti con una condizione nel Flow.

**Prerequisito:** la sequenza deve essere stata costruita con un nodo di condizione che verifica un attributo personalizzato (es.: `status_pausa`). Se l'attributo è uguale a "pausado", la condizione blocca l'invio dei messaggi successivi; altrimenti lo consente. (Vedi l'articolo sulla pausa temporanea per i dettagli sulla costruzione del Flow.)

Con questa struttura nel Flow, la pausa viene eseguita in due passaggi tramite API:

1. **Identifica il contatto** tramite ID oppure cercalo per telefono/e-mail usando l'endpoint di elencazione dei contatti.
2. **Aggiorna l'attributo personalizzato** del contatto su "pausado" (o il valore che la tua condizione si aspetta). Usa l'endpoint di aggiornamento del contatto, inviando il campo personalizzato.

Da quel momento, quando il flusso raggiunge la condizione, identificherà il valore "pausado" e non invierà il messaggio. Per riprendere, basta aggiornare l'attributo a qualsiasi altro valore (es.: "ativo") o svuotarlo, e il contatto continuerà da dove si era fermato.

Questo metodo mantiene il contatto iscritto e il progresso nella cadenza, senza perdere la cronologia.

## A chi è utile questa integrazione

- **Operazioni SDR e vendite B2B** che avviano sequenze da eventi esterni (es.: un lead ha scaricato un materiale, un affare è stato creato nel CRM).
- **Rivenditori white label** che forniscono automaticamente percorsi di follow-up ai nuovi clienti, iscrivendo contatti iniziali senza intervento manuale.
- **Team di marketing e automazione** che usano strumenti come n8n o Zapier per collegare Papo a decine di sistemi e necessitano di controllo granulare sulle cadenze.
- **Aziende con processi di pausa condizionale**, in cui un lead chiede una pausa e il venditore vuole interrompere la sequenza senza perdere il punto della cadenza — tutto attivato da un pulsante nel CRM esterno.

## Domande frequenti

### Serve la chiave segreta per elencare le sequenze?

Sì. Ogni operazione che restituisce dati dell'account richiede autenticazione con la chiave segreta, inviata come token Bearer nell'header `Authorization`.

### Posso iscrivere un contatto che non esiste ancora in Papo?

No. Il contatto deve esistere nel CRM di Papo. Puoi crearlo prima tramite l'API dei contatti (con nome, telefono o e-mail) e poi iscriverlo alla sequenza.

### L'API permette di rimuovere un contatto dalla sequenza?

La rimozione (cancellazione dell'iscrizione) non è disponibile come endpoint specifico nella versione attuale. L'alternativa per interrompere gli invii è mettere in pausa tramite attributo personalizzato, come descritto, oppure disattivare l'intero flow, il che influisce su tutti i contatti.

### Come faccio a sapere se la pausa tramite attributo ha funzionato?

Dopo aver aggiornato l'attributo, la sequenza continuerà a elaborare i nodi di attesa. Quando raggiungerà la condizione, verificherà il valore. Se è "pausado", il messaggio non verrà inviato. Puoi confermare nel profilo del contatto, nel modulo Contatti, che rimane iscritto, ma i messaggi successivi non vengono inviati.

### Posso mettere in pausa l'intera sequenza tramite API?

Sì. L'API permette di cambiare lo stato di un flow in inattivo, mettendo in pausa la sequenza per tutti i contatti. Usa l'endpoint di attivazione/disattivazione del flow. Per riprendere, basta riattivarlo.

### Dove trovo gli endpoint esatti e gli esempi di codice?

La documentazione completa dell'API è disponibile su [https://papo.global/pt/docs](https://papo.global/pt/docs). Lì trovi gli endpoint dei flows, dei contatti e i formati di richiesta.

## Leggi anche

- [Come usare l'API di Papo per gestire Flows di automazione](/hc/papo/articles/come-usare-api-papo-gestire-flow-automazione)
- [Come usare l'API di Papo per creare e aggiornare contatti in massa](/hc/papo/articles/come-usare-api-papo-creare-aggiornare-contatti-massa)

---

**[Inizia gratis e automatizza le tue sequenze →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-usare-api-papo-per-gestire-sequenze-follow-up&utm_content=it)**

Con l'API di Papo, integri la nutrizione dei lead direttamente nel tuo stack, senza aprire il pannello — il primo utente è gratuito per provarla.