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

# Connecter SendGrid

> Connectez SendGrid sous Applications et intégrations avec une clé d'API, un e-mail de l'expéditeur et un nom de l'expéditeur, et envoyez des e-mails à vos clients depuis votre propre compte SendGrid lorsque des expéditions sont créées, envoyées, annulées ou reçoivent une mise à jour de suivi.

SendGrid envoie un e-mail à votre client lorsqu'il se passe quelque chose pour son expédition, par exemple lorsque le colis est en route. L'e-mail part de votre propre compte SendGrid, depuis votre propre adresse, avec un Dynamic Template que vous concevez dans SendGrid. Zippendo indique seulement à SendGrid quel événement s'est produit.

Les intégrations sont incluses dans toutes les formules. Le test, le journal des envois, la modification et la déconnexion fonctionnent de la même façon pour toutes les applications : voir [Connecter une intégration](/docs/fr/how-to/connect-an-integration). Le guide détaillé est [SendGrid](/docs/fr/integrations/sendgrid).

## Avant de commencer

Il vous faut, depuis votre compte SendGrid :

* **Une clé d'API** autorisée à envoyer des e-mails. Créez-la dans SendGrid sous Settings → API Keys.
* **Un expéditeur vérifié** : l'adresse d'où partent les e-mails doit être vérifiée dans SendGrid.
* **Un Dynamic Template pour chaque événement** pour lequel vous voulez envoyer un e-mail, par exemple un pour « en route » et un pour les mises à jour de suivi.

<Frame caption="Le guide de SendGrid sur les clés d'API">
  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-sendgrid/10-sendgrid-create-api-key.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=acb747a6f18dc37dd9053be105df31a8" alt="Documentation Twilio SendGrid sur les clés d'API, avec le chemin Settings et API Keys" width="2880" height="2200" data-path="images/how-to/connect-sendgrid/10-sendgrid-create-api-key.png" />
</Frame>

<Warning>
  La fenêtre de connexion n'a pas de champ pour l'**ID du modèle dynamique**. Un ID de modèle ne peut être défini pour chaque événement que via l'API Zippendo : demandez à votre développeur ou contactez le support pour le définir. Sans modèle pour un événement, SendGrid n'a aucun e-mail à envoyer et refuse l'envoi.
</Warning>

## Connecter SendGrid

<Steps>
  <Step title="Trouver SendGrid dans le catalogue">
    Cliquez sur **Applications et intégrations** dans la barre latérale, puis sur **Catalogue**. SendGrid se trouve sous **Applications**. Cliquez sur **Connecter**, ou sur **Ajouter une connexion** si vous en avez déjà une.
  </Step>

  <Step title="Vérifier l'accès">
    Lisez ce que Zippendo fera avec la connexion et cliquez sur **Continuer**.
  </Step>

  <Step title="Renseigner les informations de connexion">
    Saisissez un **Nom de la connexion**, par exemple « E-mails d'expédition ». Collez la clé dans **Clé d'API**, puis renseignez **E-mail de l'expéditeur** et **Nom de l'expéditeur**.
  </Step>

  <Step title="Choisir les événements">
    Cochez les événements qui doivent envoyer un e-mail, ou cliquez sur **Tout sélectionner**. Voir la liste ci-dessous.
  </Step>

  <Step title="Cliquer sur Connecter">
    Vous voyez **Intégration connectée**, et SendGrid apparaît dans l'onglet **Connecté**.
  </Step>
</Steps>

<Frame caption="La carte SendGrid dans le catalogue">
  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/01-catalog-card-light.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=4234380c4193f08ad5c92fc52fee680c" alt="Catalogue avec la carte SendGrid et ses boutons Utiliser dans les automatisations, En savoir plus et Connecter" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/01-catalog-card-light.png" />

  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/01-catalog-card-dark.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=8e4e7b0bf94984f4623a76f2d4ccce85" alt="Catalogue avec la carte SendGrid et ses boutons Utiliser dans les automatisations, En savoir plus et Connecter" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/01-catalog-card-dark.png" />
</Frame>

<Frame caption="Connexion de SendGrid : un nom, la Clé d'API, E-mail de l'expéditeur et Nom de l'expéditeur">
  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/02-connect-modal-light.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=0fa298ef12df78e3fb7ccf317260a308" alt="Fenêtre de connexion de SendGrid avec un nom de connexion, Clé d'API, E-mail de l'expéditeur, Nom de l'expéditeur et des cases à cocher pour les événements" className="block dark:hidden" width="2880" height="2800" data-path="images/fr/how-to/connect-sendgrid/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/02-connect-modal-dark.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=1b057239ca5f61eac510ac157065ff0b" alt="Fenêtre de connexion de SendGrid avec un nom de connexion, Clé d'API, E-mail de l'expéditeur, Nom de l'expéditeur et des cases à cocher pour les événements" className="hidden dark:block" width="2880" height="2800" data-path="images/fr/how-to/connect-sendgrid/02-connect-modal-dark.png" />
</Frame>

| Champ | Obligatoire | Ce qu'il faut saisir |
| - | - | - |
| **Nom de la connexion** | Oui | N'importe quel nom que vous reconnaîtrez, jusqu'à 100 caractères. |
| **Clé d'API** | Oui | La clé d'API SendGrid. Elle est masquée pendant la saisie, stockée chiffrée et jamais réaffichée. |
| **E-mail de l'expéditeur** | Oui | L'adresse d'où partent les e-mails. Ce doit être un expéditeur que vous avez vérifié dans SendGrid. |
| **Nom de l'expéditeur** | Oui | Le nom que vos clients voient comme expéditeur, par exemple le nom de votre boutique en ligne. |

## Événements pour lesquels SendGrid peut envoyer un e-mail

| Case à cocher | Envoyé lorsque |
| - | - |
| **Expédition créée** | Une expédition est créée |
| **Expédition envoyée** | Une expédition est envoyée au transporteur et possède son étiquette |
| **Expédition annulée** | Une expédition est annulée ou supprimée |
| **Suivi mis à jour** | Le transporteur signale un nouveau scan de suivi |

SendGrid n'a pas d'événements de commande. Chaque e-mail part vers l'e-mail du client indiqué sur l'expédition, avec le modèle défini pour cet événement.

<Frame caption="Les événements d'expédition et de suivi pour SendGrid">
  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/07-events-light.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=c45103357a7d94d487b5ca02c21e9ba0" alt="Fenêtre de connexion de SendGrid défilée jusqu'aux cases à cocher des événements, dont Suivi mis à jour" className="block dark:hidden" width="2880" height="2800" data-path="images/fr/how-to/connect-sendgrid/07-events-light.png" />

  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/07-events-dark.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=e707c825f7627ab6c7bab3051115d092" alt="Fenêtre de connexion de SendGrid défilée jusqu'aux cases à cocher des événements, dont Suivi mis à jour" className="hidden dark:block" width="2880" height="2800" data-path="images/fr/how-to/connect-sendgrid/07-events-dark.png" />
</Frame>

## Vérifier la connexion

Cliquez sur l'avion en papier sur la ligne de la connexion (**Envoyer un événement de test**), puis ouvrez le journal des envois (l'icône de prise). Un événement de test n'a ni client ni modèle, SendGrid le refuse donc même si vos informations sont correctes. La vérification la plus sûre est un événement réel pour une commande avec un e-mail client.

| Le journal des envois affiche | Que faire |
| - | - |
| 401 | SendGrid a refusé la clé. Créez une nouvelle clé et collez-la. |
| 403 | La clé n'est pas autorisée à envoyer des e-mails, ou **E-mail de l'expéditeur** n'est pas un expéditeur vérifié dans SendGrid. |
| 400 | SendGrid n'a pas pu construire l'e-mail, par exemple parce que l'événement n'a pas de modèle ou pas d'e-mail client. Lisez le motif de SendGrid dans le texte d'erreur de la ligne. |

<Frame caption="Une connexion SendGrid dans l'onglet Connecté">
  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/03-connected-light.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=f9587de9f7667a0c6173b4a2b9e0793a" alt="Onglet Connecté avec une connexion SendGrid et les icônes de test, de journal des envois, de modification et de suppression" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/03-connected-light.png" />

  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/03-connected-dark.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=11b543c0485c6c0647a5b69138787612" alt="Onglet Connecté avec une connexion SendGrid et les icônes de test, de journal des envois, de modification et de suppression" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/03-connected-dark.png" />
</Frame>

<Frame caption="Le journal des envois avant le premier événement">
  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/05-delivery-log-light.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=14c5e32a80ce5a93286c8757a00882d0" alt="Fenêtre du journal des envois d'une connexion SendGrid indiquant Aucun envoi pour le moment" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/05-delivery-log-dark.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=56a7fe84af6d994f4e0a7ecb5dfd6037" alt="Fenêtre du journal des envois d'une connexion SendGrid indiquant Aucun envoi pour le moment" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/05-delivery-log-dark.png" />
</Frame>

## Modifier les informations ou déconnecter

Cliquez sur l'icône de curseurs pour ouvrir **Modifier votre connexion SendGrid**. Laissez **Clé d'API**, **E-mail de l'expéditeur** et **Nom de l'expéditeur** vides pour conserver ce qui est enregistré. Si vous en modifiez un, renseignez les trois : ce que vous saisissez remplace tout ce qui est enregistré pour la connexion. Cliquez sur **Enregistrer les modifications**.

<Frame caption="Modifier une connexion SendGrid">
  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/04-edit-modal-light.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=c017f7bf755083d5cc18260aa826a4f0" alt="Fenêtre de modification d'une connexion SendGrid avec le nom de la connexion, les champs Clé d'API, E-mail de l'expéditeur et Nom de l'expéditeur vides et les événements" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/04-edit-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/04-edit-modal-dark.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=8d097454f7e8e64160d6a5189a1ddf78" alt="Fenêtre de modification d'une connexion SendGrid avec le nom de la connexion, les champs Clé d'API, E-mail de l'expéditeur et Nom de l'expéditeur vides et les événements" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/04-edit-modal-dark.png" />
</Frame>

Pour déconnecter, cliquez sur la corbeille, saisissez DELETE et cliquez sur **Déconnecter**. Zippendo cesse d'envoyer des événements à SendGrid et supprime le journal des envois.

<Frame caption="Saisissez DELETE pour déconnecter">
  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/06-disconnect-modal-light.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=a34cbc04030b0539f4275586baeadfa0" alt="Fenêtre Déconnecter l'intégration demandant de saisir DELETE" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/06-disconnect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-sendgrid/06-disconnect-modal-dark.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=d12cfb7ac91e04cbc9748d6774cfe9f1" alt="Fenêtre Déconnecter l'intégration demandant de saisir DELETE" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/connect-sendgrid/06-disconnect-modal-dark.png" />
</Frame>

## Utiliser SendGrid dans une automatisation

Dans **Automatisations**, ajoutez l'étape **Envoyer un e-mail SendGrid**. Elle envoie l'e-mail correspondant à l'événement qui a démarré l'automatisation, mais seulement si vos conditions correspondent, par exemple uniquement pour les expéditions à l'étranger. Elle utilise le même modèle que la connexion pour cet événement.

| Champ | Obligatoire | Ce qu'il fait |
| - | - | - |
| **Connexion** | Oui | Choisissez votre connexion SendGrid dans la liste. Sans elle, vous voyez **La connexion est obligatoire**. |
| **Propriétés personnalisées** | Non | Cliquez sur **Ajouter** pour envoyer des données supplémentaires au modèle, comme la référence de l'expédition. |

Voir [Automatisations](/docs/fr/how-to/automations) pour construire le reste de l'automatisation.

## Voir aussi

* [Connecter une intégration](/docs/fr/how-to/connect-an-integration) - test, journal des envois, modification et déconnexion pour chaque application
* [SendGrid](/docs/fr/integrations/sendgrid) - le guide détaillé
* [Dépannage des intégrations](/docs/fr/integrations/troubleshooting)
* [Automatisations](/docs/fr/how-to/automations)
* [Connecter un transporteur ou une intégration](/docs/fr/how-to/connect-index)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.