# Mandrill

In caso si voglia collegare Mailchimp per creare template personalizzati per [email transazionali](/email-transazionali.md) dovrete accedere al software Mandrill.

<https://mandrillapp.com/>

Questo software fa parte di Mailchimp (infatti potete fare login con le stesse credenziali) ma, diversamente da esso, permette di inviare email transazionali a singoli destinatari anziché email di marketing a liste di contatti.

<figure><img src="/files/btkLtVB4EHe4MquIrK2s" alt=""><figcaption></figcaption></figure>

## Collegamento dati di pagamento

La prima cosa che dovrete fare sarà configurare i dati di pagamento del vostro piano per inviare le email.\
Qualora non lo facciate subito potrete comunque utilizzare lo strumento con il piano gratuito e con la modalità test che vedremo più avanti.

Potete configurare il vs. piano sia da Mailchimp [a questo link](https://us1.admin.mailchimp.com/transactional/) sia da Mandrill cliccando nella dashboard su Upgrade Account (che vi riporterà allo stesso url).

<figure><img src="/files/How1MGXZqhS1g386k6YX" alt=""><figcaption></figcaption></figure>

## Certificazione del dominio di invio

Dovrete certificare con il vs. gestore il dominio di invio delle email dalla sezione Settings > Domains

<figure><img src="/files/xs5HuS8XKbcmXE1WW8My" alt=""><figcaption></figcaption></figure>

Qui vi verranno forniti i parametri da configurare sul DNS del vs. dominio per la certificazione dello stesso per evitare che i vs. messaggi finiscano in SPAM.

## Creazione dell'apikey

Si creano le apikey che servono a Gsped per la connessione dalla sezione Settings > API keys\
**N.B. le apikey sono visibili solamente in creazione, segnarsele una volta create**

<figure><img src="/files/hyG4KzKgxAqZhP1YOJ6Z" alt=""><figcaption></figcaption></figure>

Qui è possibile creare 2 tipologie di chiavi:

1. chiave di **produzione** che effettivamente invia le email se utilizzata
2. chiave di **test** che non invia le email ma registra le chiamate e dà preview di cosa avrebbe inviato. (Per entrare in modalità test, cambiare nella tendina in alto a destra dello user)

## Creazione template

### Su Mandrill

I template sono creabili dalla sezione Outbound > Templates

<figure><img src="/files/sPdqzU3al9xvFyoU71rz" alt=""><figcaption></figcaption></figure>

### Su Mailchimp

Potete, in alternativa, creare tramite il tool di creazione di template di Mailchimp e successivamente cliccare su "Send to Mandrill" per ritrovarli il template da utilizzare (dovrete comunque sostituire i  placeholder per i dati dinamici).

<figure><img src="/files/7VjKxV4ScNopjXf0wCNE" alt=""><figcaption></figcaption></figure>

### Placeholder

Potete inserire l'HTML che preferite ed utilizzare i placeholder di Gsped per i dati dinamici relativi alla spedizione.<br>

I placeholder dovranno essere dei tag HTML con opportuni attributi che, se presenti, verranno riempiti con i valori passati da Gsped.\
I campi devono avere attributi nella notazione `mc:edit=`.

Se si vorrà quindi che un tag html paragrafo venga riempito con il nome del destinatario dovrà essere inserito `<p mc:edit="rcpt_name"></p>`

{% hint style="warning" %}
Tutti i campi inviati sono stringhe ad eccezione del logo del corriere che viene mandato come tag HTML `<img />`
{% endhint %}

Di seguito la lista al 17/01/2024 dei campi utilizzabili:

* sender\_name
* rcpt\_name
* rcpt\_addr
* rcpt\_cap
* rcpt\_city
* rcpt\_prov
* rcpt\_country\_code
* rcpt\_phone
* rcpt\_cell
* corriere\_name
* corriere\_logo
* link\_reso (da implementare)
* ddt\_alpha
* ddt\_num
* tracking\_link
* num\_spedizione

## Lista attività

Nella sezione Outbound > Activity è presente il riepilogo delle chiamate ricevute dal sistema Gsped con relativa email inviata.\
Potrete vedere i destinatari e la mail che è stata inviata.

### Modalità test

Se avete configurato una apikey di test su Gsped potete vedere comunque le chiamate ricevute ed avere una panoramica delle email che sarebbero state inviate in modalità produzione.

Per entrare in modalità test cliccate su Turn on test mode sul vs. nome utente in alto a destra<br>

<figure><img src="/files/BQoSRRFHBVPpDOYmodt6" alt=""><figcaption></figcaption></figure>

La vs. interfaccia diventerà arancione e potrete vedere le varie statistiche della modalità test.

<figure><img src="/files/5iPoPBJVceI7Cfrv389H" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
La **modalità test** è molto comoda per ricevere comunque i dati e verificare quanto e cosa avreste inviato in caso utilizzasta la chiave di produzione **MA c'è una limitazione**:\
le email risulteranno "Delivered" solamente se inviate al dominio di invio certificato, in tutti gli altri casi vi verranno segnalate come "Rejected"
{% endhint %}

## How TO

### Come escludere una email dall'invio

È possibile non inviare email ad alcuni indirizzi che, per qualche motivo, volete escludere.\
Per farlo è sufficiente inserire le varie email da escludere nella sezione Settings > Rejection Lists > Rejection Denylist

<figure><img src="/files/y7LvoXt4l4BiFvFs78kx" alt=""><figcaption></figcaption></figure>

### Come escludere interi domini dall'invio

È possibile non inviare email ad interi domini di email che, per qualche motivo, volete escludere.\
Per farlo dovrete creare una regola personalizzata di esclusione nella sezione Outbound > Rules dove indicherete di mettere in reject l'email prima di inviarla se l'indirizzo del destinatario contiene un certo valore come nell'esempio qui di seguito:

<figure><img src="/files/WaMGTeuLxKBHcctmqHlQ" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.gsped.com/email-transazionali/mandrill.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.