DokumentationWorkflowsApps und Services
Twilio Node
Sende SMS-Nachrichten über die Twilio-API, z.B. Bestellbestätigungen, 2FA-Codes oder Alerts direkt aus dem Workflow. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.
8 Min LesezeitAktualisiert am
Was Twilio macht
Sende SMS-Nachrichten über die Twilio-API, z.B. Bestellbestätigungen, 2FA-Codes oder Alerts direkt aus dem Workflow.
- Verarbeitet einen Eingang.
- Stellt einen Ausgang für weitere Schritte bereit.
- Wird als normaler Schritt in den Ablauf eingebunden.
Node einrichten
- 01Öffne einen Workflow und füge „Twilio“ über Bausteine hinzu.
- 02Lege die Zugangsdaten unter Workflow-Secrets an und wähle sie im Feld „Twilio-Zugangsdaten“.
- 03Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
- 04Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
- 05Verbinde 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.
- SMS senden
Einstellungen
| Feld | Bedeutung | Bereich |
|---|---|---|
| Twilio-Zugangsdaten | Wähle deine Twilio-Verbindung. Im Modal kannst du den empfohlenen API Key oder einen bestehenden Auth Token sowie die feste Region sicher hinterlegen. | Standard |
| Aktion | Auswahl: SMS senden | Standard |
| An (Telefonnummer) | Empfängernummer im E.164-Format (mit Ländervorwahl, z.B. +49...). | Standard |
| Von (Twilio-Nummer) | Deine Twilio-Absendernummer im E.164-Format. Kann leer bleiben, wenn du stattdessen einen Messaging-Service-SID angibst. | Standard |
| Messaging-Service-SID (optional) | Alternative zu 'Von': SID eines Twilio-Messaging-Service, falls du darüber versenden willst. | Standard |
| Nachrichtentext | Text der SMS (bis zu 1600 Zeichen; lange Texte werden von Twilio in mehrere Segmente aufgeteilt und entsprechend abgerechnet). | Standard |
| Status-Callback-URL (optional) | Optionale Webhook-URL, an die Twilio Zustellstatus-Updates schickt. | Standard |
| Für jedes Item einzeln ausführen | Aus (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
| Eingabe | Bedeutung | Typ |
|---|---|---|
| Standard | Der Node übernimmt das vollständige Ergebnis des vorherigen Schritts. | JSON |
| Ausgabe | Bedeutung | Typ |
|---|---|---|
| Standard | Das 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 per SMS nach Zahlungseingang senden: 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": "+15558675310",
"from": "+15017122661",
"body": "Danke für deine Bestellung! Sie ist unterwegs und kommt in 2-3 Werktagen an."
}Zugriff und Sicherheit
Die Zugangsdaten liegen als Workflow-Secret vor und werden im Feld „Twilio-Zugangsdaten“ ausgewählt. Im Workflow steht nur der Name des Secrets, nie der Schlüssel selbst.
Gibt es unter Konnektoren auch eine Verbindung zu Twilio, gilt deren Einstellung „Aktionen erlauben“ auch für diesen Node, obwohl er mit einem Workflow-Secret arbeitet, und wird bei jedem Lauf geprüft. Jede Aktion dieses Nodes ändert etwas und braucht „Änderungen erlauben“.
Schlüssel und Zugangsdaten gehören in die Workflow-Secrets oder in deine verbundenen Konten. Trage sie nie 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.
- Aktion gesperrt: Stell „Aktionen erlauben“ der Verbindung unter Konnektoren auf „Änderungen erlauben“.
- Liste wird nur einmal verarbeitet: Aktiviere die Ausführung pro Item in den erweiterten Einstellungen.