Zur App

DokumentationWorkflowsApps und Services

SendGrid Node

Versende transaktionale E-Mails über SendGrid (Twilio), Text- und/oder HTML-Inhalt, CC/BCC und Reply-To. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.

9 Min LesezeitAktualisiert am

Was SendGrid macht

Versende transaktionale E-Mails über SendGrid (Twilio), Text- und/oder HTML-Inhalt, CC/BCC und Reply-To.

  • Verarbeitet einen Eingang.
  • Stellt einen Ausgang für weitere Schritte bereit.
  • Wird als normaler Schritt in den Ablauf eingebunden.

Node einrichten

  1. 01Öffne einen Workflow und füge „SendGrid“ über Bausteine hinzu.
  2. 02Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
  3. 03Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
  4. 04Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.

Aktionen und Betriebsarten

Wähle im Feld „Aktion“ die gewünschte Funktion. Danach zeigt das Node-Panel nur die dafür relevanten Einstellungen.

  • E-Mail senden

Einstellungen

FeldBedeutungBereich
SendGrid API-KeyName des Workflow-Secrets, das deinen SendGrid API-Key enthält (Settings → API Keys, Berechtigung „Mail Send").Standard
AktionAuswahl: E-Mail sendenStandard
DatenregionWähle die Region deines SendGrid-Kontos. EU-Konten verwenden api.eu.sendgrid.com.Standard
AnE-Mail-Adresse des Empfängers.Standard
Name des EmpfängersOptional: Anzeigename des Empfängers.Standard
VonAbsenderadresse, muss in SendGrid als Sender/Domain verifiziert sein.Standard
Name des AbsendersOptional: Anzeigename des Absenders.Standard
BetreffWird im Node-Panel konfiguriert.Standard
Text-InhaltReiner Text-Inhalt der E-Mail. Mindestens Text oder HTML muss gesetzt sein.Standard
HTML-InhaltHTML-Inhalt der E-Mail. Mindestens Text oder HTML muss gesetzt sein.Standard
CCOptional: eine zusätzliche CC-Adresse.Standard
BCCOptional: eine zusätzliche BCC-Adresse.Standard
Antwort anOptional: abweichende Reply-To-Adresse.Standard
Für jedes Item einzeln ausführenAus (Standard): der Node läuft einmal für den gesamten Input. An: bekommt er mehrere Items (z. B. aus „Liste aufteilen“), läuft er einmal PRO Item, und {{ $json }} ist dabei jeweils genau dieses Item. So arbeitest du eine Dateiliste Eintrag für Eintrag ab.Erweitert
Wenn ein Item fehlschlägt„Überspringen“ schreibt für das fehlgeschlagene Item ein `error`-Feld und verarbeitet die übrigen weiter, statt den ganzen Lauf an einer einzigen unlesbaren Datei scheitern zu lassen.Erweitert
Pause zwischen Items (Millisekunden)Wartezeit vor jedem Durchlauf außer dem ersten. 1000 = 1 Sekunde pro Item. Nützlich, wenn die Gegenstelle sonst dichtmacht. Maximal 300000 (5 Minuten).Erweitert

Eingaben und Ausgaben

EingabeBedeutungTyp
StandardDer Node übernimmt das vollständige Ergebnis des vorherigen Schritts.JSON
AusgabeBedeutungTyp
StandardDas Ergebnis steht dem nächsten Schritt als JSON zur Verfügung.JSON

Dieser Node kann Listen Item für Item verarbeiten. Fehlerbehandlung und Pause zwischen Items findest du in den erweiterten Einstellungen.

Beispiel und Testlauf

Bestellbestätigung nach Checkout versenden: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.

Beispiel für einen Testlauf

{
  "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>"
}

Zugriff und Sicherheit

Prüfe vor der Aktivierung, welche Daten in diesen Schritt gelangen und welche Daten seine Ausgabe enthält.

Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.

Häufige Fehler beheben

  • Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
  • Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.
  • Liste wird nur einmal verarbeitet: Aktiviere die Ausführung pro Item in den erweiterten Einstellungen.

Verwandte Artikel