Integrazione InfiniteCRM - MailUp La funzionalità della gestione delle campagne marketing di icrm è stata arricchita con la spedizione di email attraverso l integrazione con la piattaforma MailUp. Creando una nuova campagna dal modulo Campagne di icrm, è ora possibile selezionare come tipologia di campagna, la voce MailUp Fig.1 Al salvataggio verrà visualizzata la scheda per la configurazione tra la campagna icrm ed il messaggio email in MailUp Fig.2 2
La prima configurazione da effettuare è la selezione della Casella di posta da utilizzare. InfiniteCRM permette l integrazione con MailUp utilizzando profili differenti. In mancanza di caselle di posta di tipo MailUp configurate, è possibile settare una nuova casella con le credenziali MailUp a disposizione, oppure, se non si dispone di un account MailUp, è possibilie richiedere l attivazione di un account MailUp demo della durante di 30 giorni. La creazione della casella può essere effettuata direttamente dall interfaccia della campagna premendo il tasto nuovo situato nella parte destra della combobox casella di posta. Fig.3 Nella finestra di dettaglio della creazione della casella di posta, è necessario inserire il codice identificativo e descrizione per il riconoscimento in fase di scelta dalla campagna. E inoltre necessario settare la voce MailUp nel campo Trasporto ed il tipo Campagne del box Tipo. Fig.4 Al momento del salvataggio della nuova casella di posta, se in icrm non è mai stata richiesta prima la creazione di un account MailUp demo, sarà visualizzato il banner informativo per la creazione di un account demo. 3
Se si possiede già un account MailUp si può procedere con la scheda Configurazione Fig.5 Cliccando sul banner informativo, si accede al pannello di attivazione dell account demo; popolando i campi richiesti si riceverà, all indirizzo mail indicato, la mail con la conferma della creazione dell account demo con riportato lo username ed la password per accedere alla console MailUp. Fig.6 4
Al momento del salvataggio, se la richiesta è stata correttamente inoltrata a MailUp, verrà visualizzato il seguente messaggio di conferma Fig.7 Nel dettaglio della schermata di configurazione precedentemente incontrata, verrà visualizzato lo stato della richiesta di attivazione nel banner informativo: Fig.8 5
Verificando le mail ricevute all indirizzo email specificato in fase di richiesta, dovremmo trovare la seguente mail di confermca contenete le credenziali di accesso alla console web di MailUp. Fig.9 6
Configurazione Casella di Posta MailUp Dalla console di configurazione di MailUp posizionarsi su Configurazioni/Gestione Console/Avanzate/Web Service (fig.10) Selezionare WSMailImport, punto 1 Prendere nota dello username, punto 2 Impostare la password, punto 3 Abilitare il web service, punto 4 Fig. 10 7
Posizionarsi nel pannello amministrativo di icrm, creare una nuova casella di posta di tipo MailUp. Configurare i parametri della casella di posta infigura 2 come: ConsoleID: numero ottenuto dalla username (Figura 10) togliendo il carattere iniziale DefaultListID: opzionale,id Lista di default nel caso non sia specificata diversamente, lasciare vuota DefaultTemplateID: opzionale,id del template di default nel caso non sia selezionato Ftppassword: password da utilizzare per l ftp per avere gli esiti delle varie mail Ftppath: percorso dell ftp da richiamare per ottenere i file degli esiti Ftpusername:nome utente da utilizzare per l ftp Mboxaddress: mail utilizzata per la spedizione delle mail (verrà inserita nel from), configurazione opzionale nelle campagne. Password: stessa password inserita nella console MailUp (Figura 10 punto 3) Servername: opzionale, url di riferimento a mailup Username: vedi (Figura 10 punto 2) Fig. 11 Una volta configurata la casella di posta questa può essere utilizzata sia per spedire delle mail come casella di posta normale sia come provider per le Campagne. 8
Configurazione Servizio di lettura degli Esiti delle mail Per avere le informazioni riguardanti gli esiti delle mail è necessario configurare un servizio ad hoc, questo andrà a processare dei file che il servizio mailup propone contenenti le varie informazioni. Per impostarlo: - Dal pannello amministrativo del CRM inserire i dati che deve fornire MailUp ftppassword, ftppath e ftpusername per recurare le esportazioni CSV. - Impostare nel Configuration.XML di una CRMServer il servizio MailUp Import Service, ci sono i seguenti parametri da impostare: Informazioni di licenza SchemaPath: percorso dove si trova il file MailUpSchema.xml, solitamente nella folder XML ServerFilePath: Cartella di lavoro dove verranno posizionati i file prima di essere elaborati Backup: (0/1) indica se deve essere fatto un backup, normalmente a vero Impostare nel MailUpSchema.xml Inserire all interno nell attributo FolderPath i percorso di lavoro dove verranno posizionati i file (lo stesso presente nel parametro ServerFilePath ) Configurazione Campagna MailUp Creare una nuova Campagna, selezionare come tipo campagna MailUp Fig.12 9
Nella sezione MailUp selezionare come casella di posta il nuovo provider di tipo MailUp appena creato Selezionare la Lista di riferimento MailUp, se non è presente oppure se si vuole creare una nuova lista premere il bottone sulla destra. Verrà creata sulla console mailup una lista con la descrizione della campagna. Selezionare la Newsletter di riferimento MailUp, se non è presente oppure se si vuole creare una nuova Newsletter premere il bottone sulla destra. Verrà creata sulla console MailUp una nuova Newsletter associata alla lista selezionata (vedi sezione Creazione di una nuova Newsletter ). Alla selezione della casella, della Lista e della Newsletter sulla sinistra verrà caricato il preview della mail creato tramite l interfacia web di MailUp. Modificare se necessario il campo Formato indirizzo. Le parole dinamiche consentite sono: <Name>: Sostituito con il valore del campo Nome Mittente nel caso di compilazione del mittente della mail; e nome completo dell account/contatto nel caso di compilazione del destinatario della mail. <Mail>: Sostituito con il valore del campo Mail Mittente nel caso di compilazione del mittente della mail; e mail dell account/contatto nel caso di compilazione el destinatario della mail. Inserire in Nome Mittente e Mail Mittente, informazioni utilizzate per la compilazione del mittente della mail. Definire eventualemente l oggetto che si vuole impostare nella mail Creazione di una nuova Newsletter Fig.13 Inserire la descrizione della nuova Newsletter, come valore di default viene messa la descrizione della campagna. Selezionare il template della mail Se non si vedono template fare riferimento alla console mailup per creare un nuovo template della mail, vedi la sezione Preparare un Modello di Mail Alla selezione del template sul box a sinistra verrà visualizzato l immagine del template selezionato Nota Importante: Se l utente non vede la lista nella console MailUp in alto a sinistra andare sulla sezione di questa guida Permessi di visibilità delle liste. Una volta selezionato si salva e si continua con il resto della configurazione delle campagne mail standard. 10
Preparare un Modello di Mail Selezionare in alto a sinistra la lista corrispondente alla campagna mail sulla quale si vuole operare. Se non è presente la lista vedi Permessi e visibilità delle Liste Una volta selezionata la lista creare un nuova mail, inserire il contenuto della mail con eventuali campi dinamici (per dettagli vedi Configurazione Campi Dinamici ) e salvarla come modello. Riaprire il dettaglio della campagna ed il nuovo modello sarà disponibile nella lista a selezione singola con anche una anteprima della mail stessa. Configurazione Campi Dinamici Per configurare i campi dinamici è necessario cambiare i nomi dei campi nella console MailUp secondo lo stile dei campi dinamici del CRM, i nomi dei campi devono essere messi in minuscolo (vedi Figura 13). All interno della mail si possono fare riferimenti a questi campi dinamici scrivendo [customer.fullname] (senza i doppi apici). Nota: Questi campi possono essere utilizzati anche nell oggetto della mail scrivendo nella configurazione della campagna nel campo Oggetto i campi dinamici come [customer.fullname] Fig.14 Ci sono due campi dinamici speciali: L URL necessario per la compilazione del Survey Eventuali Link da inserire nella mail (anche dinamici) di cui si vuole tenere traccia all interno del CRM (avere le informazioni delle persone che cliccano il link) 11
Configurazione Survey Per la compilazione del Survey, dopo aver creato una campagna e selezionato il survey di riferimento Fig.15 E necessario inserire un campo dell anagrafica (Figura 15) con la stringa general.surveyopenurl, dopodichè creare un modello di mail che contenga il riferimento a questo campo dinamico (Figura 16) Fig.16 12
Configurazione e tracking dei Link Configurare i Link all interno della campagna nel CRM: Il campo dinamico di riferimento degli URL è general.campaignlink_+<id> Ad esempio, il primo link della figura ha il campo dinamico general.campaignlink_12 Per riportare questo link su MailUp: Inserire il campo dinamico nell anagrafica della console MailUp (vedi Figura 13) Inserire il campo nel modello della mail a cui si vuole fare riferimento (come per i survey, vedi Figura 14) Quando il link verra cliccato e mailup riporterà l informazione al CRM allora nell interfaccia del CRM comparirà anche l avvenuto click. Fig.17 Permessi e visibilità delle Liste Appena creata una lista nella console questa non è automaticamente selezionabile in alto a sinistra nella console MailUp. Per rendere visibile questa lista all utente configurare seguire i seguenti passi: Andare nella console MailUp Andare su Configurazione/Gestione Console/Gestione Permessi, identificare l utente e visualizzare le Liste Visualizzate Selezionare la checkbox corripondente alla lista appena creata da icrm o che si vuole visualizzare Premere su Salva 13
FAQ Ho cambiato il template della mail dopo che la campagna è stata avviata, le nuove mail mantengono però il layout vecchio, perchè? Una volta avviata la campagna viene creata una mail sul server MailUp che rappresenta la newsletter, che non può essere modificata. Per creare una nuova newsletter agendo dal CRM basta modificare nel dettaglio della campagna uno dei seguenti due campi: Campo di selezione della MailBox Campo dell oggetto della mail Alcuni campi dinamici non si valorizzano correttamente, perchè? I campi dinamici che vengono comunicati a MailUp non devono avere valori che contengono il carattere ; questo perchè viene utilizzato per la fruizione del servizio in base alle specifiche delle api. Requisiti minimi: Infinite CRM versione 2.26.0 Dal server in cui è installato icrm è necessario poter accedere ai seguenti servizi pubblici di MailUp: REST https://services.mailup.com/api/v1.1/rest/publicservice.svc/console/trialactivation https://services.mailup.com/api/v1.1/rest/publicservice.svc/console/trialactivationstatus SOAP https://wsvc.ss.mailup.it/mailupsend.asmx https://wsvc.ss.mailup.it/mailupmanage.asmx?wsdl Dal server in cui è installato il servizio CRM Server.NET è necessario poter accedere ai seguenti servizi pubblici di MailUp: SOAP https://wsvc.ss.mailup.it/mailupsend.asmx https://wsvc.ss.mailup.it/mailupmanage.asmx?wsdl Glossario Console MailUp: applicazione web che permette di configurare la parte di MaiUp Lista: all interno di MailUp viene considerata come una NewsLetter, nell integrazione ogni Lista equivale ad una campagna differente Modello: definire un template di mail da utilizzare all interno della campagna Campo Dinamico: informazione che cambia da mail a mail, all atto di spedire la mail il CRM fornisce i valori a MailUp e quest ultimo riempie la mail con i vari campi in base alla configurazione che è stata fatta nel modello. I campi sono tutti e soli quelli definiti nella lista della Figura 4. I campi devono sempre essere scritti in minuscolo. 14
15