# Mailgun

L'application Altoviz vous permet de mettre à jour vos membres [Mailgun](https://www.mailgun.com/) à partir des contacts rattachés aux clients de votre dossier Altoviz.

### Principes

Une fois l'application Altoviz connectée à votre compte Mailgun, vos membres Mailgun seront mis à jour automatiquement à chaque modification d'un contact rattaché à un client Altoviz.

### Mise en place

Pour connecter votre compte Mailgun à l'application Altoviz, vous n'aurez que deux étapes : Récupérer une clé Mailgun et la saisir dans l'application Altoviz. 

#### Récupération de la clé d'API de Mailgun

Pour se connecter à Mailgun, il est nécessaire de disposer d'une clé d'API. Vous pouvez en récupérer une depuis votre compte Mailgun dans la section API. Lien direct [](https://app.mailjet.com/account/apikeys)[https://app.mailgun.com/settings/api\_security](https://app.mailgun.com/settings/api_security)

A noter que vous pouvez utiliser aussi bien la clé primaire qu'une clé secondaire (pour idoler les contacts Altoviz des autres) avec les implications qui en ressortent. Voir la [documentation officielle](https://documentation.mailjet.com/hc/fr/articles/360042561854-Que-sont-les-sous-comptes-et-%C3%A0-quoi-servent-ils) sur le sujet.

#### Connexion à Mailgun

Rendez-vous dans les extensions de l'application, en cliquant sur l'icône dédiée en haut à droite, puis sur l'encart Mailgun ou en cliquant sur ce lien [https://app.altoviz.com/go/addons/mailgun](https://app.altoviz.com/go/addons/mailgun)

Vous pourrez alors saisir la clé d'API de Mailgun.

Une fois la clé d'API saisie et si elle est valide, vous pourrez sélectionner la liste de membres existante à laquelle seront ajoutés les contacts synchronisés. Vous pouvez par exemple en créer une nommée "Altoviz" qui sera dédiée à vos contacts saisis dans l'application et permettra de les distinguer des autres.

### Informations mises à jour

En plus de l'email, vous pouvez retrouver des informations supplémentaires dans Mailgun.

#### Correspondance des données

Pour les données soient recopiées, il faut que vos membres Mailgun disposent de propriétés avec un nom spécifique correspondant à la liste ci-dessous.

| **Information Altoviz** | **Propriété du membre Mailgun** |
| --- | --- |
| Prénom du contact | prenom, firstname ou first\_name |
| Nom du contact | nom, lastname ou last\_name |
| Entreprise du contact | entreprise, societe ou company |
| Pays du contact | pays ou country |