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
- Come usare l'API di Papo per creare e aggiornare contatti in massa
Centralizza i canali, automatizza le risposte con l'IA e gestisci campagne email — tutto in un unico pannello, senza costi iniziali.