**Con l'API di Papo (https://papo.global/) automatizzi la creazione, l'invio e l'analisi delle campagne di email marketing direttamente dal tuo sistema, senza accedere manualmente al pannello. Gli endpoint di Email Marketing permettono di gestire campagne, template, audience e metriche di performance tramite chiamate REST, usando la stessa autenticazione con chiave segreta del resto dell'API.**

## Riepilogo delle operazioni via API

| Operazione | Cosa puoi fare programmaticamente |
| :--- | :--- |
| **Elenca campagne** | Ottenere l'elenco delle campagne con metriche (inviati, aperture, clic) per alimentare dashboard o report. |
| **Crea campagna come bozza** | Creare una nuova campagna email in stato di bozza, definendo audience, template, mittente e pianificazione. |
| **Avvia campagna** | Lanciare (inviare) una campagna già in bozza o in pausa, avviando gli invii reali. |
| **Invia email singola** | Inviare una singola email immediatamente, ideale per comunicazioni transazionali o test. |
| **Elenca template** | Recuperare i modelli email salvati nell'account per riutilizzarli nelle campagne. |
| **Elenca audience** | Ottenere le liste di contatti (audience) disponibili, incluse quelle dinamiche, per la segmentazione automatica. |

Tutte le operazioni seguono lo standard REST, con risposte in JSON e autenticazione via `Authorization: Bearer <secret_key>`. Come qualsiasi altro endpoint di Papo, hai bisogno di una chiave segreta (`sk_live_…`) generata nel pannello in **Developers**.

## Come funziona: automatizzare il ciclo completo di una campagna

### 1. Autenticati ed esplora gli endpoint

Prima di qualsiasi chiamata, ottieni la tua chiave segreta nel pannello di Papo (sezione **Developers**). La base URL è la stessa dell'API generale, e tutte le richieste devono includere l'header di autorizzazione. Con la chiave in mano, puoi elencare le audience e i template esistenti per pianificare la campagna.

### 2. Crea una campagna in modalità bozza

Usa l'endpoint di creazione della campagna email (modalità bozza) per preparare l'invio senza inviarlo immediatamente. Nella richiesta, specifichi:
- La credenziale di invio (casella email configurata).
- L'ID del template (o il payload del contenuto se crei inline).
- L'audience (ID della lista o un array di contatti).
- Configurazioni opzionali come data/ora di pianificazione e finestre di invio.

La risposta restituisce l'identificatore univoco della campagna, permettendoti di recuperarla in seguito.

### 3. Avvia la campagna o pianifica l'invio

Con l'ID della campagna in mano, puoi avviarla (lanciarla) con un'altra chiamata. Se preferisci la pianificazione automatica, basta includere i campi di data e ora al momento della creazione: la campagna resterà in bozza programmata e verrà inviata al momento definito.

### 4. Monitora le performance

Usa l'endpoint di elenco delle campagne per consultare le metriche in qualsiasi momento. Riceverai dati come totale inviati, tasso di apertura e numero di clic. Questi numeri possono essere importati in dashboard del tuo sistema (ad esempio Google Data Studio, Power BI o fogli di calcolo) usando chiamate periodiche o webhook.

## Casi d'uso tipici

- **Lead nurturing basato su eventi:** Un webhook del tuo ERP segnala che un lead ha raggiunto un determinato punteggio; il tuo sistema avvia automaticamente una campagna email via API, spostando il lead alla fase successiva.
- **Report aziendali unificati:** Il tuo strumento di BI consulta periodicamente le metriche delle campagne e le combina con i dati di vendita, il tutto in modo programmato.
- **Automazioni su n8n o Zapier:** Crea flussi che, alla ricezione di un nuovo contatto nel CRM, creano una bozza di campagna di benvenuto e la avviano senza intervento manuale.
- **Rivendita white label:** Integra la creazione e la gestione delle campagne nel tuo portale clienti, mantenendo l'identità visiva del tuo brand mentre usi l'infrastruttura di Papo.

## Per chi è questa soluzione

- Sviluppatori e team IT che desiderano integrare l'email marketing nei sistemi interni.
- Agenzie che devono generare campagne in blocco per decine di clienti senza accedere al pannello di ciascuno.
- Rivenditori white label che vogliono offrire l'invio di email come parte del proprio portafoglio, controllato via API.
- Aziende che utilizzano automazioni su n8n, Zapier o script personalizzati.

## Domande frequenti

### Serve una chiave API diversa per usare gli endpoint di Email Marketing?
No. Le stesse chiavi (pubblica e segreta) che già utilizzi per le altre risorse di Papo funzionano sugli endpoint email. L'autenticazione è la stessa, tramite header `Authorization: Bearer`.

### Posso inviare una singola email, come una notifica transazionale?
Sì. L'API permette invii individuali e immediati, senza dover creare una campagna. Basta indicare destinatario, oggetto, contenuto e credenziale di invio.

### Come faccio a sapere se la campagna è stata realmente avviata?
Quando chiami l'endpoint di lancio, l'API restituisce lo stato della campagna. Poi puoi consultare l'elenco delle campagne per verificare se lo stato è passato da "bozza" a "in invio" o "completata" e ottenere le metriche di avanzamento.

### Quali metriche restituisce l'API?
Le risposte includono almeno il totale delle email inviate, le aperture e i clic. I campi esatti disponibili sono documentati nell'endpoint di elenco, che può essere esplorato con strumenti come Postman o l'interfaccia di scoperta dell'API stessa.

### Posso creare template email tramite l'API?
L'attuale funzionalità di elenco dei template permette di recuperare i modelli già esistenti nell'account. La creazione di nuovi template può essere fatta dal pannello; verifica la documentazione aggiornata per confermare se la rotta di creazione è disponibile via API.

### È possibile pianificare una campagna per una data specifica?
Sì. Al momento della creazione della bozza, puoi indicare data e ora desiderate. La campagna rimarrà in questo stato e verrà inviata automaticamente al momento programmato, a meno che non venga manualmente messa in pausa.

## Leggi anche

- [Come usare l'API di Papo per gestire Sequenze di follow-up](/hc/papo/articles/come-usare-api-papo-per-gestire-sequenze-follow-up)
- [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 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-usare-api-papo-gestire-campagne-email-marketing&utm_content=it)**

Centralizza i canali, automatizza le risposte con l'IA e gestisci campagne email — tutto in un unico pannello, senza costi iniziali.