Come integrare SendPulse con la tua piattaforma utilizzando l'API

L'API consente a servizi e applicazioni di scambiare dati in modo rapido e preciso, il che attira l'attenzione non solo degli sviluppatori web, ma anche degli specialisti senza un forte background tecnico. Gli esperti di marketing apprezzano la capacità di un'API di trovare la combinazione più efficace di piattaforme senza preoccuparsi dei problemi di compatibilità.

In questo articolo, spiegheremo come utilizzare l'API del servizio di posta elettronica SendPulse. Riceverai anche la nostra guida passo passo su come creare una campagna e-mail e ottenere statistiche su di essa.

Che cos'è un'API?

API è l'acronimo di Application Programming Interface. È un'interfaccia in cui le applicazioni interagiscono nel processo di completamento di un determinato compito comune.

L'API è stata progettata per consentire lo scambio di dati tra applicazioni e servizi. Questo è il motivo per cui non ha un'interfaccia comune con varie icone e pulsanti, a differenza delle interfacce progettate per gli utenti delle applicazioni. L'API è rappresentata da un insieme di classi, funzioni, procedure, strutture e costanti già pronte.

In effetti, lo usi quotidianamente: trasferisci informazioni da un'app all'altra o imposta attività sull'accoppiamento automatico dei sistemi. Ad esempio, l'API viene utilizzata quando i servizi online ti consentono di accedere con il tuo account di social media invece di richiedere la registrazione.

In che modo l'API aiuta i marketer

I marketer devono essere flessibili mentre ottengono le informazioni necessarie. Di norma, raccolgono dati da più canali, che raramente suggeriscono un'interfaccia comune. Quando le informazioni vengono trasferite da un sistema a un altro tramite API, tali interfacce non hanno molta importanza. Ciò che conta è che entrambi i sistemi riconoscano parametri comuni di richieste e risposte. In questo modo, il trasferimento dei dati è rapido, essenziale per le attività che richiedono velocità e precisione.

Per avere un'idea di come un'API può essere utile per un esperto di marketing, dovrebbe scoprire quali dati sono disponibili tramite quell'API e come ottenerli. Chiedi a uno sviluppatore web di controllare l'API che ti interessa e discutere le possibili opzioni per l'integrazione.

Cosa puoi fare con l'API SendPulse?

Usa l'API di SendPulse per operazioni con mailing list, mittenti, campagne e modelli e-mail, nonché blacklist. Controlla il saldo del tuo account e ottieni informazioni sulle campagne.

Puoi trovare la documentazione completa dell'API SendPulse sul nostro sito web. Contiene i requisiti per gli sviluppatori che creano integrazioni.

Come utilizzare i servizi SendPulse tramite API

Abbiamo utilizzato uno strumento di test API chiamato Postman per illustrare esempi di flusso di lavoro. Questa applicazione è disponibile per Mac, Windows e Linux e non richiede la conoscenza di alcun linguaggio di programmazione. L'app funziona in modalità di avvio, test, documentazione e monitoraggio. Sentiti libero di utilizzare qualsiasi applicazione simile per i tuoi scopi.

Diamo un'occhiata a un esempio che mostra come creare una campagna email tramite API e come ottenere le sue statistiche.

1. Autorizza nel servizio

Ottieni il token di accesso personale applicando il metodo dalla documentazione di SendPulse. Utilizza i valori API ID e API Secret indicati nelle impostazioni del tuo account SendPulse.

Invia una richiesta API con questi valori per ottenere il token di accesso. Il servizio ti rimanderà il token e ne indicherà il tipo.

Avrai bisogno di questo token per firmare ogni richiesta API. Nota che il token è valido solo per un'ora e dopo la scadenza, richiede il rinnovo: in questo caso, dovresti ripetere il passaggio 1. Inoltre, per motivi di sicurezza, gli utenti possono aggiornare i valori dell'ID API e del segreto API nelle impostazioni dell'account SendPulse. Fatto ciò, genera un nuovo token di accesso.

2. Crea una rubrica

3. Ottieni l'ID della rubrica

Utilizza il metodo API per ottenere informazioni dettagliate sugli indirizzi e-mail dal libro. Si consiglia di salvare il valore dell'ID per poter identificare le rubriche in ulteriori operazioni.

4. Carica gli indirizzi email nella rubrica

Quando gli indirizzi e-mail vengono aggiunti alla rubrica, vengono trasferite anche le variabili corrispondenti, in questo caso la variabile {{Nome}} con il valore {{Elvira}}.

5. Carica il modello di email

Se hai già un modello, caricalo nel servizio utilizzando il metodo fornito nella documentazione di SendPulse.

Prima di creare una campagna, definisci l'ID del modello che hai caricato. Una volta ottenuto un elenco di tutti i modelli, identifica quello di cui hai bisogno con il nome.

Se non hai ancora un modello, creane uno con l'editor di trascinamento della selezione di SendPulse.

6. Crea una campagna da inviare a tutta la rubrica

Sostituisci il parametro "body" con il parametro "template_id" utilizzando il valore ID ottenuto nel passaggio precedente.

7. Recupera informazioni sulla campagna

È importante che i professionisti del marketing conoscano le informazioni sullo stato della campagna inviata e l'API SendPulse consente di ottenerle. Come illustrato di seguito, è possibile visualizzare i seguenti dati: il nome e l'indirizzo del mittente, l'oggetto e il contenuto dell'e-mail, il numero di e-mail nella campagna, il suo stato e la data di invio.

attraverso vari metodi API, abbiamo creato una campagna e-mail basata su un modello personalizzato e recuperato informazioni su di essa.

Statistiche dettagliate sulle campagne e-mail sono disponibili direttamente nel tuo account SendPulse.

8. Controlla come viene visualizzata l'e-mail nella casella di posta del destinatario

Come puoi vedere nell'illustrazione qui sotto, il nome dell'abbonato è apparso nell'intestazione: la variabile {{Nome}} è stata trasferita nell'intestazione quando abbiamo aggiunto i destinatari alla rubrica.

9. Possibilità di inviare una serie automatizzata di e-mail

Dopo aver aggiunto un template (Step 5), puoi inviare una serie di automazioni. Ad esempio, una data potrebbe essere selezionata come condizione iniziale della serie. Diciamo che scegliamo l'anniversario del primo ordine come data e un'e-mail con un'offerta speciale come primo elemento della serie automatizzata.

Dopo che questa e-mail è stata inviata nella data specificata, è disponibile un'opzione per inviare un webhook. In questo modo verrà aggiunta automaticamente una variabile speciale per l'abbonato alla mailing list, a seconda delle sue azioni con l'e-mail: potrebbe aprirla, cancellarla o contrassegnarla come spam.

In questo modo, puoi impostare il trasferimento dei dati sulle azioni dei tuoi iscritti con l'e-mail e inoltrarlo al tuo sistema. Questi risultati possono essere utilizzati nel tuo ulteriore lavoro con i clienti.

Cosa c'è nel risultato?

L'API semplifica la cooperazione complessa tra i sistemi. Un utente non deve elaborare un grande volume di dati per ogni sistema perché l'API consente ai sistemi di cooperare, facilitando il lavoro del marketer. Mostra questo articolo a uno sviluppatore web e inizia a integrare SendPulse con il tuo progetto tramite API.