> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration SendGrid

> Intégrez SendGrid avec OneSignal pour la livraison d'e-mails.

# Prérequis

* [Compte SendGrid](https://www.sendgrid.com)
* [Compte OneSignal](https://onesignal.com)

# Configuration

## 1. Authentification de l'expéditeur SendGrid

Il est recommandé d'utiliser "l'authentification de domaine" de SendGrid afin que SendGrid envoie des e-mails via votre domaine plutôt que `via sendgrid.net`, et que les liens que vos utilisateurs cliquent proviennent de votre domaine.

**Recommandé** : Suivez le guide de SendGrid sur [Comment configurer l'authentification de domaine](https://docs.sendgrid.com/ui/account-and-settings/how-to-set-up-domain-authentication).

SendGrid fournit également la [vérification d'expéditeur unique](https://docs.sendgrid.com/ui/sending-email/sender-verification) si vous n'avez pas de domaine.

## 2. Installer les enregistrements DNS

Si vous avez sélectionné **l'authentification de domaine**, assurez-vous que vos enregistrements DNS sont vérifiés.

<Frame caption="Statut de vérification DNS SendGrid">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3ceb5db-Screen_Shot_2021-10-20_at_1.18.12_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=9cbb18e747d85c69d73e272e3c2e23d5" width="1402" height="872" data-path="images/docs/3ceb5db-Screen_Shot_2021-10-20_at_1.18.12_PM.png" />
</Frame>

Les enregistrements SPF, DKIM et MX doivent être configurés automatiquement via l'assistant de configuration de SendGrid.

<Frame caption="Configuration de l'authentification de domaine SendGrid">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/41879e3-esp-sendgrid-domain-3.jpg?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=deaeacb61d563fb01079199a4a1373be" width="2500" height="1600" data-path="images/docs/41879e3-esp-sendgrid-domain-3.jpg" />
</Frame>

## 3. Créer une clé API

Dans le tableau de bord SendGrid, allez dans [Paramètres -> Clés API](https://app.sendgrid.com/settings/api_keys) et cliquez sur 'Créer une clé API'.

<Frame caption="Écran de création de clé API SendGrid">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/f794466-esp-sendgrid-apikey.jpg?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=58f82278dd1461db66aedf9123723b50" width="2500" height="1270" data-path="images/docs/f794466-esp-sendgrid-apikey.jpg" />
</Frame>

Nommez votre clé API quelque chose comme `Clé API OneSignal` et assurez-vous de définir les permissions sur **Accès complet**. Cliquez sur 'Créer et afficher' lorsque vous êtes prêt.

<Frame caption="Paramètres de permission de clé API SendGrid">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/afe1836-esp-sendgrid-apikey-2.jpg?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=c2647bf1992dc79b00974c453a8ffb00" width="2500" height="1350" data-path="images/docs/afe1836-esp-sendgrid-apikey-2.jpg" />
</Frame>

Ensuite, cliquez sur la clé API pour la copier dans votre presse-papiers.

<Frame caption="Copie de la clé API SendGrid">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b8a9822-esp-sendgrid-apikey-3.jpg?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=df6331d166120cd300fac9d50bb04f82" width="2500" height="990" data-path="images/docs/b8a9822-esp-sendgrid-apikey-3.jpg" />
</Frame>

### Quelles sont les restrictions d'API minimales que je peux autoriser ?

L'accès minimum que vous devez autoriser est le suivant :

<Frame caption="Exigences minimales de permission d'API">
  <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2d82f50-Screen_Shot_2021-12-09_at_1.25.57_PM.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=d8857161192778c6714357b2d5e95ac3" width="986" height="1722" data-path="images/docs/2d82f50-Screen_Shot_2021-12-09_at_1.25.57_PM.png" />
</Frame>

<Warning>
  Si vous utilisez la fonctionnalité de liste d'autorisation de SendGrid, assurez-vous d'ajouter OneSignal à cette liste.

  Consultez la FAQ ci-dessous [Comment mettre les IP de OneSignal sur liste blanche ?](./sendgrid-setup#how-do-i-whitelist-onesignals-ips)
</Warning>

## 4. Désactiver le suivi d'abonnement Sendgrid

OneSignal ajoute automatiquement ses propres liens de désabonnement par défaut pour chaque e-mail envoyé.

Désactivez le **suivi d'abonnement** dans sendgrid pour empêcher Sendgrid d'ajouter automatiquement son propre lien de désabonnement en bas des e-mails texte et HTML.

<Frame caption="Paramètres de suivi d'abonnement SendGrid">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1b863e8-Sendgrid_Tracking_Settings.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=c483fc9706a46d3ab6cc4d00ee90802f" width="1235" height="647" data-path="images/docs/1b863e8-Sendgrid_Tracking_Settings.png" />
</Frame>

## 5. Activer la messagerie par e-mail

Dans OneSignal, accédez à **Paramètres > Plateformes > Email** et **Activez** Email pour configurer vos paramètres d'e-mail.

Sélectionnez **SendGrid** comme fournisseur.

<Frame caption="Image sélectionnant SendGrid dans les paramètres d'e-mail">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a42b5c0-Screenshot_2023-09-27_at_4.38.36_PM.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=af1b1a422edf6fc979eeb9b4c3cfc42e" width="1880" height="1026" data-path="images/docs/a42b5c0-Screenshot_2023-09-27_at_4.38.36_PM.png" />
</Frame>

Collez votre clé API SendGrid dans le champ fourni.

<Frame caption="Image montrant où saisir votre clé API">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/0431d6a-Screenshot_2023-09-27_at_4.39.12_PM.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=bbb78dfd7e2c9deaf6699292dd55dab8" width="1862" height="644" data-path="images/docs/0431d6a-Screenshot_2023-09-27_at_4.39.12_PM.png" />
</Frame>

### Paramètres par défaut de livraison

Ajoutez le **nom** par défaut et l'**adresse e-mail** à partir desquels vous souhaitez que vos e-mails proviennent (ceux-ci peuvent être modifiés ultérieurement).

Appuyez sur Terminé lorsque vous avez fini.

<Frame caption="Bannière de succès de configuration d'e-mail">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4b63e41-Screenshot_2023-09-27_at_4.41.02_PM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=7fa2706b1fa954740752c6b1557552cc" width="1874" height="884" data-path="images/docs/4b63e41-Screenshot_2023-09-27_at_4.41.02_PM.png" />
</Frame>

## 6. Ajouter des abonnés

Si vous avez une liste d'e-mails prête, sélectionnez **Télécharger CSV** ou vous pouvez toujours le faire plus tard.

Si vous avez un site web et souhaitez inviter les utilisateurs à fournir leur e-mail, sélectionnez **Ajouter une invite web** pour utiliser [l'invite web d'e-mail](./permission-requests) de OneSignal.

<Frame caption="Options de configuration d'abonnés e-mail">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6ba703e-Screenshot_2023-09-27_at_4.39.54_PM.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=1073f5704e2367527d67cab6980789d2" width="1874" height="1174" data-path="images/docs/6ba703e-Screenshot_2023-09-27_at_4.39.54_PM.png" />
</Frame>

## 7. Test

Accédez à **Messages > Email**, sélectionnez **Nouveau e-mail**.

Ajoutez un `Sujet`, sélectionnez une expérience d'édition (l'éditeur glisser-déposer est un bon début) et cliquez sur **Envoyer un e-mail de test**.

<Frame caption="Interface de test d'e-mail">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/10d1976-Screenshot_2023-09-27_at_4.49.08_PM.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=5bd931f0ccb9ad064110678ce5e0e183" width="2206" height="692" data-path="images/docs/10d1976-Screenshot_2023-09-27_at_4.49.08_PM.png" />
</Frame>

Saisissez votre e-mail et appuyez sur **Envoyer un e-mail de test**. Un e-mail devrait arriver dans votre boîte de réception sous peu !

<Info>
  Si vous rencontrez des problèmes, consultez notre [FAQ sur les e-mails](./email-troubleshooting).

  Si vous êtes bloqué, contactez `support@onesignal.com` pour obtenir de l'aide.

  Pour une assistance plus rapide, veuillez fournir :

  * Votre ID d'application OneSignal
  * Détails, journaux et/ou captures d'écran du problème.
  * Étapes pour reproduire
</Info>

# Recommandé

## Identifier les utilisateurs

**Requis si vous utilisez des intégrations.** **Recommandé pour la messagerie sur plusieurs canaux (push, email, sms).**

OneSignal crée des enregistrements au niveau de l'abonnement sous un ID unique appelé subscription\_id. Un seul utilisateur peut avoir plusieurs enregistrements subscription\_id en fonction du nombre d'appareils, d'adresses e-mail et de numéros de téléphone qu'il utilise pour interagir avec votre application.

Si votre application a son propre système de connexion pour suivre les utilisateurs, appelez `login` à tout moment pour lier tous les canaux à un seul utilisateur. Pour plus de détails, consultez [Aliases & ID externe](./users).

## Collecter de nouveaux e-mails

**Recommandé si vous utilisez la messagerie par e-mail et SMS.**

Il existe plusieurs façons de transmettre de nouvelles adresses e-mail à OneSignal :

* Utilisez le SDK Frontend de OneSignal pour capturer de nouveaux e-mails. Consultez [Méthodes SDK pour les e-mails](./mobile-sdk-reference#email).
* Utilisez les API [Create user](/reference/create-user) ou [Create subscription](/reference/create-subscription) pour ajouter des e-mails depuis votre serveur.
* Si vous souhaitez importer des e-mails via CSV, consultez [Importer des adresses e-mail](./import).

## Ajouter des Tags

**Optionnel**

Les tags sont des paires personnalisées `clé : valeur` de données de type String utilisées pour suivre les événements et propriétés des utilisateurs. La définition de tags est nécessaire pour une [segmentation](./segmentation) plus complexe et une [personnalisation des messages](./message-personalization).

Consultez [Tags](./add-user-data-tags) pour plus de détails.

<Check>
  Visitez [Tutoriels sur les e-mails](./email-messaging) pour les prochaines étapes.
</Check>

# Exporter des e-mails

1. **Navigation dans les listes de contacts** : Accédez à `Marketing > Contacts`.

2. <Frame caption="Navigation vers la page Contacts">
     <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7c49df1-step-1-50.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=eb80902228ae5d891426577e09211c6a" width="224" height="1167" data-path="images/docs/7c49df1-step-1-50.png" />
   </Frame>

3. **Identification de la liste** : Localisez la liste que vous souhaitez exporter.

4. **Sélection de l'export** : Ouvrez le menu contextuel sous l'en-tête de liste **Action**.

<Frame caption="Sélection de la liste de contacts à exporter">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/d900c5a-step-3-50.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=4ef417459779b56fe9211305f082782e" width="1261" height="679" data-path="images/docs/d900c5a-step-3-50.png" />
</Frame>

4. **Démarrer l'export** : Cliquez sur **Export**. Cela vous amène à `Contact > Active Exports`.
5. **Télécharger le fichier** : Attendez que le **Status** affiche 'Ready for Download', puis cliquez sur **Download CSV**.

<Frame caption="Téléchargement du CSV exporté">
  <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2d1c12f-step-5-50.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=3f8102ca85b5dde7c55e10cb12643ce6" width="1261" height="630" data-path="images/docs/2d1c12f-step-5-50.png" />
</Frame>

6. **Récupération du fichier** : Le fichier sera enregistré dans votre répertoire de téléchargements.

# Obtenir une clé API

1. Accédez à votre tableau de bord Sendgrid et ouvrez **Settings** depuis la barre latérale gauche.

<Frame caption="Navigation vers Paramètres > Clés API">
  <img src="https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/cf3fe33-step-1-50.png?fit=max&auto=format&n=4HyuQPBpu-4xjmQC&q=85&s=0a162a955d877a4b66623bbe835cfcb7" width="1616" height="1365" data-path="images/docs/cf3fe33-step-1-50.png" />
</Frame>

2. Sélectionnez **API Keys**.

<Frame caption="Clic sur le bouton Créer une clé API">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c3045de-step-2-50.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=2421e360c654dcf620110214bdceb187" width="1616" height="1365" data-path="images/docs/c3045de-step-2-50.png" />
</Frame>

3. Nommez votre clé. Optionnellement, choisissez *Restricted Access* pour des permissions spécifiques.

<Frame caption="Nommer la clé et définir les permissions">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/8770efc-step-3-50.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=f2c9125755ab5db955af0a8dd6d1edfc" width="1616" height="1365" data-path="images/docs/8770efc-step-3-50.png" />
</Frame>

Si vous utilisez *Restricted Access*, assurez-vous d'accorder les privilèges **Full Access** pour Marketing.

<Frame caption="Accorder un accès complet au Marketing">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/83d80f8-step-4-50.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=33a46fe982c60987c70cd4dfa9e0d07e" width="1616" height="1365" data-path="images/docs/83d80f8-step-4-50.png" />
</Frame>

4. Cliquez sur **Create & View**.

<Frame caption="Clic sur le bouton Create & View">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/f92f0c4-step-5-50.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=75a7a005e4040d66c4badf0d68260942" width="1616" height="1365" data-path="images/docs/f92f0c4-step-5-50.png" />
</Frame>

5. Copiez votre clé API.

<Frame caption="Copie de la clé API">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/64034da-step-6-50.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=73edf11c5792ca71d42301ac225594f6" width="1616" height="1365" data-path="images/docs/64034da-step-6-50.png" />
</Frame>

# FAQ

## Comment configurer OneSignal si j'ai déjà un Webhook actif dans SendGrid ?

Pour simplifier la configuration et pouvoir accéder aux statistiques de livraison d'e-mails, OneSignal configurera automatiquement les Webhooks avec SendGrid. Malheureusement, SendGrid ne prend en charge qu'un seul webhook pour un compte donné. OneSignal nécessite des webhooks pour l'analyse des e-mails, ce qui peut entrer en conflit avec des webhooks précédemment configurés (par exemple pour une intégration d'analyse).

Si vous avez besoin du webhook que vous avez actuellement configuré, vous pouvez transférer la requête vers `https://onesignal.com/email/hooks/sendgrid`. Configurez un délai d'attente de 30 secondes pour de meilleurs résultats.

Si vous n'avez pas besoin du webhook que vous avez précédemment configuré, vous devez le modifier. Dans SendGrid, accédez à **Settings > Mail Settings** et cliquez sur 'Event Webhook'. L'URL HTTP Post doit être `https://onesignal.com/email/hooks/sendgrid` et avoir les paramètres minimaux affichés :

<Frame caption="Paramètres de configuration du webhook SendGrid">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/989f714-Screen_Shot_2021-10-20_at_2.05.47_PM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=fccfdce1d4e2ae9139c8a00bd1605bf2" width="2526" height="1522" data-path="images/docs/989f714-Screen_Shot_2021-10-20_at_2.05.47_PM.png" />
</Frame>

## Comment mettre les IP de OneSignal sur liste blanche ?

Consultez les exigences dans notre [Aperçu de l'API REST](/reference/rest-api-overview) pour plus de détails.

<Frame caption="Exigences de liste blanche IP OneSignal">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b7550d9-Screen_Shot_2022-05-27_at_5.32.06_PM.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=d107970e875efcb9418aea08ea412106" width="1626" height="1314" data-path="images/docs/b7550d9-Screen_Shot_2022-05-27_at_5.32.06_PM.png" />
</Frame>

***