Come integrare Mailrelay nel tuo plugin, CRM o APP? E offri più opzioni ai tuoi utenti.

Se stai sviluppando un CRM, APP, plug-in o un altro tipo di plug-in, l'integrazione di Mailrelay può essere un'opzione molto interessante per evidenziare il tuo prodotto o servizio.

I vantaggi sono molti:

Questa integrazione è, infatti, un processo molto semplice, grazie all'API Mailrelay.

Tuttavia, per rendere ancora più semplice il tuo lavoro, oggi vedremo un tutorial che chiarirà tutti i dubbi che potresti avere nel processo di integrazione di Mailrelay con il tuo sistema.

Iniziamo!

Di quali funzioni API Mailrelay avremo bisogno durante il processo di integrazione?

In questo articolo vedremo un esempio di integrazione di base, ovvero come sincronizzare gli utenti del tuo CRM, APP o plugin con Mailrelay, in modo che i tuoi clienti abbiano i loro contatti disponibili sul proprio account e possano inviare loro delle newsletter.

Integrare Mailrelay in questo modo è molto semplice.

Inoltre, ci sono opzioni avanzate, come l'invio di campagne e-mail dalla tua APP, CRM, ecc. Ma questo richiede già un ulteriore sviluppo e, sebbene il processo sia lo stesso, aumenterebbe leggermente la portata di questo articolo.

Ad ogni modo, se pensi che possa essere interessante, puoi lasciare un commento, e cercheremo di preparare un altro post in futuro su questo.

Ora, per l'integrazione di cui abbiamo parlato, avremo bisogno di queste funzioni API:

Nient'altro, con queste funzioni possiamo integrare il software, e vedremo come farlo.

► Qual è il processo che devi seguire per integrare gli abbonati con Mailrelay?

È molto facile, passo dopo passo, quello che faremo è:

Vediamo il processo passo dopo passo.

1) Verificare che l'abbonato esista già

La prima cosa è verificare se il contatto esiste già, perché se non esiste può essere aggiunto, in quanto non è possibile avere email duplicate su Mailrelay.

Per verificarlo, utilizzeremo getSubscribers.

Nella descrizione dell'API, puoi vedere un esempio del codice che puoi utilizzare, che è qualcosa del genere:

È il codice di base per verificare se esiste già un contatto, la query verrà eseguita utilizzando l'indirizzo email.

Se il contatto esiste, il sistema restituirà un array con tutte le informazioni sull'abbonato come nome, email, gruppi in cui è registrato, ecc.

E anche, l' ID abbonato:

Vettore
(
[0] => Oggetto stdClass
(
[id] => 2
[nome] =>

…

E nel caso il contatto non esistesse?

In questo caso, la funzione restituisce un array vuoto.

Vettore
(
)

Poiché è vuoto, saprai che questa email non esiste nel sistema e puoi aggiungerla.

Finora, l'integrazione di Mailrelay con qualsiasi software sembra molto semplice, non è vero? Beh, non preoccuparti, non sarà complicato.

2)Aggiungi un nuovo iscritto

Se l'abbonato non esiste, possiamo aggiungerlo, anche se di sicuro ti chiederai cosa succede se proviamo ad aggiungere un abbonato che esiste già? Beh, niente di serio, il sistema ti avvertirebbe semplicemente che non si può fare:

E quindi non lo aggiungerebbe.

In questo caso, per aggiungere un sottoscrittore, utilizzeremo la funzione addSubscriber Con un codice simile al seguente:

I parametri di base e obbligatori sono:

Importante: Il contatto sarà già attivo e non avrà bisogno di essere confermato via email, perché sta importando da un sistema CRM, e-commerce, ecc. E quindi il contatto dovrebbe essere già stato convalidato prima di essere registrato sul nostro software.

Se necessario, il contatto può essere disattivato e può essere attivato tramite un'e-mail di conferma, ad esempio, ma per impostazione predefinita, resta inteso che l'utilizzo dell'API è solo per la migrazione dei dati precedentemente convalidati.

Cosa restituirebbe questa chiamata?

Se la chiamata viene effettuata positivamente, ciò che ritornerebbe sarebbe qualcosa come:

oggetto(stdClass)#1 (2) {
[“stato”] =>
intero(1)
[“dati”] =>
intero(9)
}

Dovremmo prestare attenzione al fatto che restituirà l'ID dell'abbonato (nell'esempio sarebbe 9).

Bene, finora sono stati eseguiti due processi, abbiamo controllato per assicurarci che l'abbonato esista e, se non esiste, lo abbiamo aggiunto. Il passaggio successivo consiste nell'aggiornare un abbonato già esistente.

3) Aggiorna un abbonato esistente

Questo è un caso normale, dopo aver eseguito il primo passaggio, possiamo aggiornare il sottoscrittore utilizzando la funzione updateSubscriber:

Se la funzione funziona, restituisce:

bool (vero)

Anche questo codice è semplice, ma ci sono alcuni punti da tenere in considerazione:

Quest'ultimo punto è essenziale perché lo sottolinei.

Questa funzione richiede che tutti i dati dell'abbonato siano informati. Ad esempio, se l'abbonato appartiene già al gruppo 1 e nei gruppi di array si indica il valore 3, l'abbonato apparterrebbe solo al gruppo 3.

Se si desidera che l'abbonato sia registrato per il gruppo 1 e il gruppo 3, è necessario indicare entrambi i valori nell'array.

Lo stesso accade con i campi personalizzati (customFields), se non sono indicati, i campi personalizzati saranno vuoti. Dovrai indicare tutti i dati che vuoi aggiungere per l'iscritto.

Non è un problema.

Perché nel passaggio 1, con getSubscribers, tutti i dati erano già stati ottenuti.

4) annullare l'iscrizione ed eliminare l'iscritto

Queste due funzioni, unsubscribe e deleteSubscriber possono essere utilizzate senza alcun problema, basta inserire l'indirizzo email dell'abbonato.

Qual è la differenza?

Opt-out, unsubscribe, consente all'abbonato di iscriversi nuovamente in futuro, mentre se viene eliminato, non può essere aggiunto di nuovo.

Questa è la differenza. Ci sono più funzioni nell'API Mailrelay per creare un'e-mail, ottenere statistiche, importare un database, ecc.

Tuttavia, in questo breve tutorial, ho voluto spiegare solo le funzioni che consentono di integrare Mailrelay con vari tipi di software, come APP, plugin, CRM, ecc.

E comunque l'utilizzo delle API è molto semplice ed intuitivo, compresi esempi di utilizzo in PHP per la maggior parte delle funzioni.

Motivi per integrare Mailrelay nel tuo CRM, APP, plugin o qualsiasi altro software.

Le ragioni per integrare Mailrelay sono molte, da un lato Mailrelay è uno dei principali strumenti di email marketing. Ciò significa che un gran numero di utenti utilizza il nostro software e il processo di integrazione sarà ancora più redditizio.

Mailrelay è anche un software utilizzato da grandi aziende, blogger e innumerevoli piccole imprese e PMI, con il più grande account gratuito:

Pertanto, l'integrazione può anche aiutare a ottenere visibilità.

Inoltre, l'integrazione di Mailrelay è molto semplice grazie all'API per sviluppatori, ed è qualcosa che diverse aziende hanno già fatto, come ad esempio:

Offrono già funzionalità extra ai loro utenti.