DocumentationWorkflowsApps et services
SendGrid node
Envoie des emails transactionnels via SendGrid (Twilio), contenu texte et/ou HTML, CC/BCC et réponse à. Découvrez sa configuration, les entrées et sorties, le test et la résolution des erreurs.
9 min de lectureMis à jour le
Fonction du node
Envoie des emails transactionnels via SendGrid (Twilio), contenu texte et/ou HTML, CC/BCC et réponse à.
Utilisez SendGrid comme étape clairement définie dans un workflow anymize.
- Traite 1 entrée.
- Fournit 1 sortie aux étapes suivantes.
- S'exécute comme une étape normale du workflow.
Configurer le node
- 01Ouvrez un workflow et ajoutez SendGrid depuis le catalogue.
- 02Renseignez les champs requis et associez les valeurs des étapes précédentes.
- 03Testez le node avec un petit jeu de données et vérifiez sa sortie.
- 04Reliez la sortie réussie et activez le workflow après un test complet.
Actions et modes
Choisissez la fonction voulue dans Action. Le panneau affiche ensuite les paramètres utiles.
- Envoyer un email
Paramètres
| Champ | Signification | Zone |
|---|---|---|
| Clé API SendGrid | Nom du secret de workflow contenant ta clé API SendGrid (Settings → API Keys, permission "Mail Send" requise). | Protégé |
| Action | Choix: Envoyer un email | Standard |
| Région des données | Choisis la région de ton compte SendGrid. Les comptes UE utilisent api.eu.sendgrid.com. | Standard |
| À | Adresse email du destinataire. | Standard |
| Nom du destinataire | Optionnel : le nom affiché du destinataire. | Standard |
| De | Adresse d'expédition, doit être un expéditeur/domaine vérifié dans SendGrid. | Standard |
| Nom de l'expéditeur | Optionnel : le nom affiché de l'expéditeur. | Standard |
| Objet | Configurez cette valeur dans le panneau du node. | Standard |
| Contenu texte | Corps en texte brut. Il faut au moins le texte ou le HTML. | Standard |
| Contenu HTML | Corps HTML. Il faut au moins le texte ou le HTML. | Standard |
| CC | Optionnel : une adresse CC supplémentaire. | Standard |
| CCI | Optionnel : une adresse CCI supplémentaire. | Standard |
| Répondre à | Optionnel : une adresse de réponse différente. | Standard |
| Exécuter une fois par élément | Désactivé (par défaut) : le node s'exécute une fois pour tout l'input. Activé : s'il reçoit plusieurs éléments (par ex. de « Séparer la liste »), il s'exécute une fois PAR élément, et {{ $json }} correspond alors à cet élément. C'est ainsi que tu traites une liste de fichiers entrée par entrée. | Standard |
| Si un élément échoue | « Ignorer » écrit un champ `error` pour l'élément en échec et poursuit avec les autres, au lieu de perdre toute l'exécution à cause d'un seul fichier illisible. | Standard |
| Pause entre les éléments (millisecondes) | Attente avant chaque exécution sauf la première. 1000 = 1 seconde par élément. Utile si le service distant te limite. Maximum 300000 (5 minutes). | Standard |
Entrées et sorties
| Entrée | Signification | Type |
|---|---|---|
| Standard | Reçoit le résultat complet de l'étape précédente. | JSON |
| Sortie | Signification | Type |
|---|---|---|
| Standard | Met le résultat à disposition de l'étape suivante au format JSON. | JSON |
Ce node peut traiter les listes élément par élément. La gestion des erreurs et la pause se trouvent dans les paramètres avancés.
Exemple et test
Envoyer une confirmation de commande après le paiement: commencez avec un petit jeu de données reconnaissable. Vérifiez la sortie et utilisez uniquement les champs présents.
Exemple de test
{
"to": "kundin@example.com",
"to_name": "Anna Kundin",
"from": "bestellungen@deine-domain.de",
"from_name": "Dein Shop",
"subject": "Deine Bestellung #10432 ist bestätigt",
"text": "Hallo Anna, danke für deine Bestellung! Wir melden uns, sobald sie versendet wird.",
"html": "<p>Hallo Anna,</p><p>danke für deine Bestellung! Wir melden uns, sobald sie versendet wird.</p>"
}Accès et sécurité
Avant l'activation, vérifiez les données reçues par cette étape et le contenu de sa sortie.
Stockez les clés et identifiants dans le gestionnaire protégé. Ne les insérez jamais dans les champs, données de test ou descriptions.
Résoudre les erreurs
- Aucune sortie: vérifiez la dernière exécution et les champs fournis par le node précédent.
- Variable vide: ouvrez la sortie précédente et utilisez un nom de champ réellement présent.
- Liste traitée une seule fois: activez l'exécution par élément.