In SparkPost il modo migliore per archiviare un'email è creare una copia identica dell'email progettata specificamente per scopi di archiviazione. Questo viene fatto utilizzando la funzionalità di Archive di SparkPost. La funzionalità di Archive di SparkPost offre al mittente la possibilità di inviare un duplicato dell'email a uno o più indirizzi email.  Questo duplicato utilizza gli stessi link di tracciamento e di apertura dell'originale. La documentazione di SparkPost definisce la funzionalità di Archive nel seguente modo:

I destinatari nella lista dell'archivio riceveranno una replica esatta del messaggio inviato all'indirizzo RCPT TO. In particolare, i link codificati destinati al destinatario RCPT TO saranno identici nei messaggi di archivio.

L'unica differenza tra questa copia di archivio e l'email originale inviata a RCPT TO è che alcuni degli header saranno diversi poiché l'indirizzo di destinazione per l'email di archiviazione è diverso, ma il corpo dell'email sarà una replica esatta!

Se desideri una spiegazione più approfondita, ecco un link alla documentazione di SparkPost sulla creazione di copie duplicate (o di archivio) di un'email. Gli header campione X-MSYS-API per questo progetto sono mostrati più avanti in questo blog.

Esiste una avvertenza per questo approccio; mentre tutte le informazioni sugli eventi nell'email originale sono legate insieme sia da un transmission_id che da un message_id, non vi sono informazioni nell'evento di inbound relay (il meccanismo per ottenere e diffondere l'email di archivio) per l'email duplicata che si ricollega a uno di questi due id e quindi alle informazioni per l'email originale. Questo significa che dobbiamo inserire dati nel corpo dell'email e nell'header dell'email originale come un modo per collegare tutti i dati SparkPost dall'email originale e da quella di archivio.

Per creare il codice che viene inserito nel corpo dell'email, ho utilizzato il seguente processo nell'applicazione di creazione dell'email.

1. Da qualche parte nel corpo dell'email, ho inserito il seguente ingresso:<input name="ArchiveCode" type="hidden" value="<<UID>>">

2. Quindi ho creato un codice univoco e sostituito il campo <<UID>>:$uid = md5(uniqid(rand(), true)); $emailBody = str_replace(“<<UID>>,$uid,$emailBody);

   Ecco un esempio di output:

   <input name="ArchiveCode" type="hidden" value="00006365263145">

3. Dopo ho verificato di aver aggiunto il $UID al blocco meta_data dell'header X-MSYS-API. Questo passaggio assicura che l'UID sia inserito in ciascun output di evento per l'email originale:

X-MSYS-API: {
  "campaign_id": "<my_campaign>",
  "metadata": {
    "UID": "<UID>"
  },
  "archive": [
    {
      "email": "archive@geekwithapersonality.com"
    }
  ],
  "options": {
    "open_tracking": false,
    "click_tracking": false,
    "transactional": false,
    "ip_pool": "<my_ip_pool>"
  }
}

Ora abbiamo un modo per collegare tutti i dati dall'email originale al corpo dell'email di archivio.