INTÉGRATION SENDGRID n8n : AUTOMATISER SENDGRID AVEC N8N

L'action Send Mail est le cœur de l'intégration SendGrid n8n. Elle vous permet d'envoyer des emails transactionnels ou marketing directement depuis vos workflows, avec un contrôle total sur chaque aspect du message.

Paramètres de configuration :

• Sender Email : adresse email de l'expéditeur (requis). Doit être une adresse vérifiée dans votre compte SendGrid.
• Sender Name : nom affiché comme expéditeur (optionnel). Exemple : "John Smith" ou "Équipe Support".
• Recipient Email : adresse du destinataire principal (requis).
• Subject : objet de l'email (optionnel mais fortement recommandé).
• MIME Type : format du contenu, "Plain Text" ou "HTML" (requis).
• Message Body : contenu de l'email (requis).
• Dynamic Template : interrupteur pour utiliser les templates dynamiques SendGrid (optionnel).
• Additional Fields : section extensible pour paramètres avancés comme les CC, BCC, pièces jointes, etc.

Cas d'usage typiques : Envoi d'emails de confirmation après soumission de formulaire, notifications transactionnelles, alertes automatiques à l'équipe interne, emails de bienvenue personnalisés.

L'action Update List modifie les propriétés d'une liste existante, notamment son nom. Utile pour maintenir une nomenclature cohérente au fil du temps.

Paramètres de configuration :

• List ID : identifiant de la liste à modifier (requis). La liste doit exister préalablement dans SendGrid.
• Name : nouveau nom pour la liste (optionnel). Si fourni, la liste sera renommée avec cette valeur.

Cas d'usage typiques : Renommage automatique de listes selon des conventions de nommage, mise à jour des noms de liste pour refléter une nouvelle période, correction ou standardisation des noms de liste.

Quand l'utiliser : Pour maintenir une organisation claire et cohérente de vos listes dans le temps.

Cette action récupère l'ensemble de vos listes de contacts SendGrid. Idéale pour avoir une vue d'ensemble de votre segmentation ou alimenter des menus de sélection dynamiques.

Paramètres de configuration :

• Return All : interrupteur pour récupérer toutes les listes (optionnel). Désactivé par défaut.
• Limit : nombre maximum de listes à retourner (optionnel). Défaut à 100, ajustable selon vos besoins.

Cas d'usage typiques : Génération de rapports sur l'organisation des contacts, alimentation de sélecteurs dynamiques dans des interfaces, audit régulier de la structure de segmentation, détection de listes obsolètes ou à nettoyer.

Quand l'utiliser : Pour des opérations nécessitant une vue globale de vos listes ou pour des workflows de maintenance.

L'action Get List récupère les détails d'une liste de contacts spécifique, incluant ses métadonnées et optionnellement un échantillon de contacts.

Paramètres de configuration :

• List ID : identifiant unique de la liste à récupérer (requis). Obtenez cet ID via l'action Get Many Lists ou lors de la création.
• Contact Sample : interrupteur pour inclure un échantillon de contacts (optionnel). Utile pour avoir un aperçu rapide du contenu de la liste.

Cas d'usage typiques : Vérification de l'existence d'une liste avant ajout de contacts, récupération du nombre de contacts dans une liste pour reporting, audit des listes avant lancement de campagne.

Quand l'utiliser : Pour obtenir des informations sur une liste spécifique avant d'effectuer des opérations dessus.

Cette action supprime définitivement une liste de contacts SendGrid. Vous pouvez choisir de conserver ou supprimer les contacts associés.

Paramètres de configuration :

• List ID : identifiant de la liste à supprimer (requis). Action irréversible une fois exécutée.
• Delete Contacts : interrupteur pour supprimer également les contacts de la liste (optionnel). Désactivé par défaut : seule la liste est supprimée, les contacts restent dans SendGrid.

Cas d'usage typiques : Nettoyage des listes de campagnes terminées, suppression des listes temporaires après usage, maintenance régulière de l'organisation des contacts, archivage propre après fin de projet.

Quand l'utiliser : Pour éliminer les listes devenues obsolètes et maintenir une structure de données claire.

Cette action crée une nouvelle liste de contacts dans SendGrid. Les listes permettent de segmenter vos contacts pour des campagnes ciblées et une meilleure organisation.

Paramètres de configuration :

• Name : nom de la nouvelle liste (requis). Choisissez un nom descriptif qui facilite l'identification. Supporte les valeurs fixes et les expressions dynamiques pour un nommage contextuel.

Cas d'usage typiques : Création automatique de listes par source d'acquisition (ex: "Leads_Webinar_Mars2024"), segmentation dynamique par critères métier, organisation des contacts par campagne ou événement, mise en place de listes par catégorie de produit ou service.

Quand l'utiliser : Lorsque votre workflow détecte un nouveau segment ou besoin de catégorisation nécessitant une liste dédiée.

Cette action récupère une liste de contacts depuis votre compte SendGrid. Parfaite pour les opérations en masse ou l'export de données vers d'autres systèmes.

Paramètres de configuration :

• Return All : interrupteur pour récupérer tous les contacts (optionnel). Désactivé par défaut pour permettre un contrôle via la limite.
• Limit : nombre maximum de contacts à récupérer (optionnel). Par défaut à 100. Utile pour paginer ou limiter le volume de données.
• Filters : section pour ajouter des critères de filtrage (optionnel). Permet de cibler des contacts spécifiques selon différents critères.

Cas d'usage typiques : Export de contacts vers un autre outil marketing, audit régulier de la base de données contacts, préparation de listes pour des campagnes ciblées, synchronisation bidirectionnelle avec un CRM comme HubSpot.

Quand l'utiliser : Pour des opérations impliquant plusieurs contacts simultanément ou pour des besoins d'analyse et d'export.

L'action Get Contact récupère les informations complètes d'un contact spécifique depuis SendGrid. Utile pour vérifier l'existence d'un contact ou récupérer ses données avant d'effectuer d'autres opérations.

Paramètres de configuration :

• By : méthode d'identification du contact (requis). Actuellement configuré sur "ID" pour rechercher par identifiant unique.
• Contact ID : identifiant unique du contact à récupérer (requis). Vous obtenez cet ID lors de la création du contact ou via l'action Get Many Contacts.

Cas d'usage typiques : Vérification de l'existence d'un contact avant envoi d'email, récupération des données complètes pour personnalisation de message, validation des informations contact dans un workflow de vérification.

Quand l'utiliser : Lorsque vous avez besoin d'accéder aux données d'un contact spécifique pour conditionner la suite de votre workflow.

L'action Delete Contact supprime définitivement un ou plusieurs contacts de votre compte SendGrid. Essentielle pour maintenir une base de données propre et conforme RGPD.

Paramètres de configuration :

• Contact IDs : liste des identifiants de contacts à supprimer (requis si Delete All désactivé). Accepte plusieurs IDs pour suppression en masse.
• Delete All : interrupteur pour supprimer TOUS les contacts (optionnel). Attention : action irréversible et drastique, à utiliser avec précaution.

Cas d'usage typiques : Traitement automatique des demandes de suppression RGPD, nettoyage des contacts invalides ou bounce, suppression des contacts désabonnés après période de rétention, maintenance régulière de la base de données.

Quand l'utiliser : Pour la conformité réglementaire, le nettoyage de base ou la gestion des désabonnements.

Cette action gère intelligemment vos contacts SendGrid : elle crée un nouveau contact si l'email n'existe pas, ou met à jour les informations si le contact existe déjà. Idéale pour maintenir une base de données contacts toujours synchronisée.

Paramètres de configuration :

• Email : adresse email du contact (requis). C'est l'identifiant unique qui détermine si le contact existe déjà.
• Additional Fields : section pour ajouter des propriétés supplémentaires (optionnel). Permet d'enrichir le profil avec prénom, nom, champs personnalisés, etc.

Cas d'usage typiques : Synchronisation automatique des nouveaux leads depuis un CRM, mise à jour des informations contact après modification de profil utilisateur, import de contacts depuis des formulaires web comme Tally ou Fillout, enrichissement progressif des données contact au fil des interactions.

Quand l'utiliser : Chaque fois qu'un contact doit être ajouté ou mis à jour dans SendGrid suite à une action dans un autre système.