# Intégration Mailgun : synchroniser vos contacts clients

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 intégrations de l'application, en cliquant sur **Intégrations** dans le menu, puis sur l'encart Mailgun ou en cliquant sur ce lien [https://app.altoviz.com/go/integrations/mailgun](https://app.altoviz.com/go/integrations/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 |

## Envoi des e-mails

Au-delà de la synchronisation des contacts, Mailgun peut expédier vos devis, factures et
relances **depuis votre propre adresse**.

**Clé d'API** : la clé de votre compte Mailgun.

**Domaine d'envoi** : le domaine configuré chez Mailgun. C'est lui qui détermine l'adresse
d'expédition possible, et il doit être **vérifié chez Mailgun** par des enregistrements DNS.

**Région** : l'implantation de votre compte. Mailgun distingue une région européenne d'une
région américaine, et **la clé d'une région ne fonctionne pas sur l'autre** — une région
incorrecte se traduit par un échec d'authentification.

**Adresse d'expéditeur** et **Nom d'expéditeur** : ce que voit le destinataire.

Le raccordement ne suffit pas : il faut ensuite désigner ce compte comme expéditeur dans
[Paramètres → E-mails](/fr/reference/parametres/e-mails). Voir le guide
[Envoyer vos e-mails depuis votre propre adresse](/fr/guides/emails/envoyer-depuis-votre-propre-adresse).