Configurare l'invio di email transazionali

In questo articolo ti illustriamo i dati tecnici di connessione per configurare il servizio di invio tramite SMTP, ma se desideri una spiegazione non tecnica sulle email transazionali con esempi e buone pratiche, dai un’occhiata alla nostra guida. 

L’utilizzo di Acumbamail come  gateway SMTP ti permetterà di utilizzare i nostri server per recapitare in modo efficace ai tuoi utenti le email transazionali generate dalla tua piattaforma web. Inoltre, Acumbamail ti fornirà statistiche che ti consentiranno di conoscere il comportamento dei tuoi utenti nei confronti di queste email. Questo tipo di servizio può essere utilizzato solo con le tariffe email basate sul numero di email o con pacchetti di crediti prepagati e non con tariffe basate sul numero di iscritti.

Per attivare questo servizio, dovrai prima aver sottoscritto una tariffa basata sul numero di invii email o un pacchetto di crediti prepagati, e poi contattare il nostro team di supporto affinché abiliti subito il servizio. 

L’utilizzo di questo servizio è consentito esclusivamente per l’invio di email transazionali. Questi invii sono conferme di registrazione, notifiche personalizzate all’utente e, in definitiva, qualsiasi email prodotta da un’interazione diretta dell’utente con la tua piattaforma web. Le email promozionali possono essere inviate utilizzando il nostro strumento di invio campagne, i cui prezzi sono disponibili qui.

Dati di connessione

Per utilizzare il server SMTP devi scegliere il tipo di autenticazione: puoi scegliere una porta plain oppure con TLS/SSL. Per poter utilizzare il nostro server SMTP devi usare i seguenti dati di connessione:

Per iniziare la configurazione, vai alla sezione SMTP all’interno del menu laterale sinistro di Acumbamail:

• In Configura, fai clic sul pulsante Configura SMTP per accedere ai dati di connessione necessari per l’integrazione:

Esempi di configurazione in diversi linguaggi

Esempio di configurazione in Django

Per inviare email tramite Acumbamail con la funzione send_mail di django, dovrai solo includere i seguenti parametri nella configurazione (normalmente in settings.py). Ricorda di sostituire LOGIN_ACUMBAMAIL e PASSWORD_ACUMBAMAIL con quelli corrispondenti nel tuo caso.

# settings.py

EMAIL_HOST = 'smtp.acumbamail.com'
EMAIL_HOST_USER = 'LOGIN_ACUMBAMAIL'
EMAIL_HOST_PASSWORD = 'PASSWORD_ACUMBAMAIL'
EMAIL_PORT = 25 #porta alternativa: 25252

# esempio di chiamata send_mail

send_mail("Oggetto", "Corpo", "example@mailfrom.com" , "example@mailto.com", fail_silently=True)<br>

Esempio di configurazione in Java

Per inviare email tramite il nostro server SMTP utilizzando il linguaggio di programmazione Java, puoi farlo seguendo questo esempio. Ricorda di sostituire LOGIN_ACUMBAMAIL e PASSWORD_ACUMBAMAIL con quelli corrispondenti nel tuo caso.

import javax.mail.*;
import javax.mail.internet.*;
import javax.mail.Authenticator;
import javax.mail.PasswordAuthentication;
import java.util.Properties;

public class test1 {

    private static final String SMTP_HOST_NAME = "smtp.acumbamail.com";
    private static final String SMTP_AUTH_USER = "LOGIN_ACUMBAMAIL";
    private static final String SMTP_AUTH_PWD  = "PASSWORD_ACUMBAMAIL";

    public static void main(String[] args) throws Exception{
       new test1().test();
    }

    public void test() throws Exception{
        Properties props = new Properties();
        props.put("mail.transport.protocol", "smtp");
        props.put("mail.smtp.host", SMTP_HOST_NAME);
        props.put("mail.smtp.port", 25);
        props.put("mail.smtp.auth", "true");
        //props.put("mail.smtp.socketFactory.class","javax.net.ssl.SSLSocketFactory");

        Authenticator auth = new SMTPAuthenticator();
        Session mailSession = Session.getDefaultInstance(props, auth);
        // decommentare per informazioni di debug su stdout
        // mailSession.setDebug(true);
        Transport transport = mailSession.getTransport();

        MimeMessage message = new MimeMessage(mailSession);

        Multipart multipart = new MimeMultipart("alternative");

        BodyPart part1 = new MimeBodyPart();
        part1.setText("Test");

        BodyPart part2 = new MimeBodyPart();
        part2.setContent("Test", "text/html; charset=\"utf-8\"");

        multipart.addBodyPart(part1);
        multipart.addBodyPart(part2);
        message.setHeader("Content-Type","text/html; charset=\"utf-8\""); 
        message.setContent(multipart,"text/alternative");
        message.setHeader("Content-Transfer-Encoding", "8bit");
        message.setFrom(new InternetAddress("EMAILFROM@EXAMPLE.COM"));
        message.setSubject("Email da java ;)");
        message.addRecipient(Message.RecipientType.TO,new InternetAddress("EMAIL_TO1@EXAMPLE.COM"));
        //message.addRecipient(Message.RecipientType.CC, new InternetAddress("EMAIL_TO2@EXAMPLE.COM"));
        transport.connect();
        transport.sendMessage(message,
            message.getRecipients(Message.RecipientType.TO));
        transport.close();
    }

    private class SMTPAuthenticator extends javax.mail.Authenticator {
        public PasswordAuthentication getPasswordAuthentication() {
           String username = SMTP_AUTH_USER;
           String password = SMTP_AUTH_PWD;
           return new PasswordAuthentication(username, password);
        }
    }
}

Esempio di configurazione in PHP

Per inviare email tramite il nostro server SMTP utilizzando il linguaggio di programmazione PHP, puoi farlo seguendo questo esempio. Ricorda di sostituire LOGIN_ACUMBAMAIL e PASSWORD_ACUMBAMAIL con quelli corrispondenti nel tuo caso.

 require_once 'class.phpmailer.php';
     require_once 'class.smtp.php';
     $mail = new PHPMailer();

     // Puliamo tutti i valori che possono essere impostati
     $mail->ClearAddresses();
     $mail->ClearAllRecipients();
     $mail->ClearAttachments();
     $mail->ClearBCCs();
     $mail->ClearCCs();
     $mail->ClearCustomHeaders();
     $mail->ClearReplyTos();

     // Dati SMTP
     $mail->SMTPAuth = true;
     $mail->IsSMTP();
     $mail->Host = 'smtp.acumbamail.com';
     $mail->Username = 'LOGIN_ACUMBAMAIL';
     $mail->Password = 'PASSWORD_ACUMBAMAIL';
     $mail->From     = 'example@mailfrom.com'
     $mail->FromName = 'Example from name';
     $mail->AddReplyTo('example@mailfrom.com');
     $mail->AddAddress('example@mailto.com');
     $mail->Subject  = G_General::convertCharset("Oggetto", $charset);
     $mail->CharSet  = strtolower($charset);

     if ($html) {
         $mail->MsgHTML(G_General::convertCharset('Corpo', $charset));
         $mail->AltBody = '';
     } else {
          //$mail->ContentType = 'text/plain';
          $mail->IsHTML(false); // invia come testo
          $mail->Body = strip_tags(G_General::convertCharset('Corpo', $charset));
     }

     if (isset($data['debug']) && $data['debug']) {
          $mail->SMTPDebug = 2;
          $mail->Debugoutput = 'html';
     }

     if (preg_match('#(,|;)#', $data['to'])) {
          $emails = preg_split('#(,|;)#', $data['to']);
          $res = true;
          foreach ($emails as $k => $email) {
              $email = trim($email);
              $mail->ClearAddresses();
              $mail->AddAddress($data['to']);
              if (!$mail->Send()) {
                  $res = false;
              }
          }
      } 
      else {
          return $mail->Send();
      }

      return $res;

Una volta configurato l’invio tramite SMTP, ti consigliamo di creare categorie di email per poter classificare il volume di email inviate e analizzarne il rendimento individualmente. Ti spieghiamo come farlo con esempi in diversi linguaggi in questo articolo.

Attivare webhook per email transazionali

Dalla sezione Webhooks all’interno di SMTP nel menu laterale, potrai configurare webhook per email transazionali per sincronizzare il tuo database con Acumbamail e ricevere così avvisi quando ci sono modifiche. Accedi alla guida passo passo da questo link. 

Invio di email

Come nella modalità di invio campagne dall’interfaccia di Acumbamail, anche con le email transazionali potrai utilizzare il nostro editor drag & drop, con cui potrai personalizzare a tuo piacimento più di 260 template predefiniti.

I passaggi per modificare la tua email transazionale sono i seguenti:

• All’interno di SMTP, vai alla sezione Template. Per impostazione predefinita, appariranno i template che hai già modificato nella sezione Email, se utilizzi anche questo servizio. Puoi modificare direttamente un template già utilizzato oppure fare clic sul pulsante in alto Nuovo template. 

• Una volta fatto clic, avrai due opzioni:
  • Modificare a tuo piacimento uno dei nostri oltre 260 template personalizzati. Nel menu a discesa a destra puoi vedere i template predefiniti per le notifiche, che in questo caso potrebbero essere quelli più adatti alle tue esigenze. Quando ne selezioni uno, potrai assegnargli un nome e accedere all’editor di template (in questo articolo ti spieghiamo come funziona l’editor). 
  • Importare un tuo template HTML, facendo clic sulla scheda Importa. Trovi maggiori informazioni sull’importazione dei template in questo articolo. 

Report SMTP

Quando inizierai a inviare le tue email transazionali, tutte le informazioni passeranno attraverso di noi, quindi potrai accedere a statistiche dettagliate in tempo reale dalla sezione Report all’interno di SMTP. Di seguito ti spieghiamo quali dati puoi estrarre da qui:

Riepilogo

In questa vista potrai selezionare l’intervallo di date per confrontare i tuoi risultati:

Stato delle email inviate:

• Non aperte: iscritti (email destinatari) che non hanno aperto la tua email
• Aperte: iscritti che hanno aperto la tua email
• Hard bounce (rimbalzi definitivi): email che hanno restituito un errore di invio perché non esistono (di solito perché l’indirizzo contiene un errore di battitura o l’email non esiste più). Una volta che queste email vengono contrassegnate come hard bounce, non invierai loro più email automaticamente nei prossimi invii
• Soft bounce (rimbalzi temporanei): email che hanno restituito un errore di invio temporaneo. Quando si verifica un soft bounce, il server effettuerà un altro tentativo (o altri tentativi) successivi di consegna, generalmente dopo che il resto della campagna è stato inviato correttamente. Il fatto che un indirizzo email sia un soft bounce in un invio specifico non significa che verrà sempre indicato come rimbalzo negli invii successivi. 
• Reclami: volte in cui la persona che ha ricevuto il tuo invio lo ha contrassegnato manualmente come spam. Non invierai più automaticamente email a questo indirizzo di posta. 

Trovi maggiori informazioni sulle metriche dell’email marketing in questo articolo del nostro blog.

Monitoraggio degli URL

In questa sezione potrai monitorare tutti gli URL che hai incluso nelle tue email transazionali. 

Dettagli iscritti

Da Dettagli iscritti potrai accedere a una vista email per email dello stato delle email consegnate nella data che selezioni. Potrai filtrare i destinatari per stato (non aperta, aperta, hard bounce, soft bounce, reclamo o tutti), per data o per categoria. Inoltre, potrai scaricare il report premendo il pulsante "Esporta in csv".