· 4 min · TextMeFlow Team

WhatsApp-Nachricht aus Retool senden

Teams, die interne Dashboards in Retool bauen, brauchen oft einen schnellen Weg, einen Kunden zu benachrichtigen, ohne die App zu verlassen – eine Erstattung bestätigen, an eine überfällige Zahlung erinnern oder Bescheid geben, dass eine Bestellung bereitliegt. Statt in ein separates Messaging-Tool zu wechseln oder über Zapier zu routen, kannst du mit einer einzigen REST-API-Resource einen WhatsApp-Senden-Button direkt in jede Retool-App einbauen.

Diese Anleitung behandelt die Einrichtung für eine Support-Konsole oder ein Ops-Dashboard, aber dieselbe Resource funktioniert in jeder Retool-App: Admin-Panels, Bestellverwaltungs-Tools oder interne CRMs.

Warum direkt aus Retool

Retool-Apps sind meist der Ort, an dem dein Team ohnehin den Kundendatensatz nachschlägt – die Bestellung, das Ticket, den Account. Wenn man für eine WhatsApp-Nachricht ein anderes Tool öffnen und die Telefonnummer neu eintippen muss, lassen die Leute es bleiben oder machen Fehler. Ein Button, der direkt an die API angebunden ist, hält Nachschlagen und Senden auf demselben Bildschirm, wobei Telefonnummer und Nachricht direkt aus dem bereits angezeigten Datensatz kommen.

Wenn dein Auslöser ein Backend-Ereignis ist statt eines Klicks auf einen Button – ein Webhook, ein Cronjob, eine Statusänderung in deiner Datenbank –, ist das ein anderes Muster; siehe WhatsApp-Nachrichten aus n8n, Make.com oder Zapier senden für automatisierungsgesteuerte Sendungen. Retools native Resource passt gezielt dann, wenn ein Mensch die Nachricht aus einem internen Tool heraus anstößt.

Was du brauchst

  • Eine Retool-App mit einer Tabellen- oder Detailansicht, die bereits einen Kundendatensatz zeigt (mindestens Telefonnummer und Name).
  • Einen kostenlosen TextMeFlow-Account mit einer per QR-Code verknüpften WhatsApp-Nummer – keine Meta-Business-Verifizierung nötig.
  • Deinen API-Key aus dem TextMeFlow-Dashboard.

Schritt 1: die REST-API-Resource hinzufügen

Gehe in Retool zu Resources → Create New → REST API und konfiguriere:

  • Base URL: https://api.textmeflow.eu/v1
  • Headers: Authorization: Bearer YOUR_API_KEY, Content-Type: application/json

Gib ihr einen Namen wie textmeflow, damit du sie beim späteren Anlegen der Queries leicht findest.

Schritt 2: eine Query zum Senden einer Nachricht erstellen

Füge eine neue Query auf der Resource hinzu, setze die Methode auf POST, den Pfad auf /messages und den Body auf:

{
  "to": "{{ table1.selectedRow.data.phone }}",
  "text": "{{ textArea1.value }}"
}

Verweise auf die Komponenten, die Empfänger und Nachrichtentext enthalten – eine ausgewählte Tabellenzeile, ein Texteingabefeld oder ein fester Vorlagentext, der mit Retools {{ }}-Bindungssyntax aufgebaut wird.

Schritt 3: die Query mit einem Button verbinden

Platziere einen Button neben dem Datensatz und setze seinen onClick-Event-Handler auf Trigger query, mit Verweis auf die Query aus Schritt 2. Füge einen Show notification-Handler für den Erfolgsfall hinzu, damit der Mitarbeiter eine sichtbare Bestätigung („Nachricht gesendet") bekommt, statt sich zu fragen, ob der Klick angekommen ist.

// Optional: disable the button while the query runs
sendWhatsapp.trigger({
  onSuccess: () => {
    utils.showNotification({ title: "WhatsApp sent", notificationType: "success" });
  },
  onFailure: (error) => {
    utils.showNotification({ title: "Send failed", description: error.message, notificationType: "error" });
  },
});

Schutz vor falschen Telefonnummern

Der häufigste Fehler in einem internen Tool ist nicht der API-Aufruf, sondern eine Telefonnummer, die ohne Ländervorwahl gespeichert wurde. TextMeFlow erwartet das E.164-Format (+ und Ländervorwahl, z. B. +32470123456); eine Nummer im lokalen Format wie 0470123456 wird abgelehnt, bevor irgendetwas gesendet wird. Füge einen Retool-Transformer oder eine einfache JS-Query hinzu, die die Nummer prüft und normalisiert, bevor die Sende-Query ausgelöst wird, und deaktiviere den Button, wenn das Feld leer oder offensichtlich fehlerhaft ist. Die vollständigen Formatregeln stehen in /de/docs/api.

Sendungen in der eigenen Datenbank protokollieren

Wenn deine Retool-App auf einer Postgres- oder MySQL-Resource aufbaut, hänge nach erfolgreichem Senden eine zweite Query an, die über den onSuccess-Handler der ersten Query eine Zeile in eine message_log-Tabelle schreibt (Empfänger, Text, Zeitstempel, auslösender Nutzer). So hat dein Team einen Audit-Trail darüber, wer was aus dem internen Tool gesendet hat – unabhängig von TextMeFlows eigenen Zustellprotokollen.

Was TextMeFlow auf seiner Seite übernimmt

Jede über die API gesendete Nachricht – aus Retool, einem Backend-Job oder einer anderen Integration – durchläuft automatisch dieselbe Anti-Spam-Pipeline: Rate Limits, ein Risikowert, STOP-Wort-Verarbeitung und Ruhezeiten. Du musst das nicht pro Tool konfigurieren; es gilt unabhängig davon, was die Anfrage ausgelöst hat. Details stehen in /de/docs/anti-spam.

Über den kostenlosen Tarif hinaus

Der kostenlose Tarif enthält 50 Nachrichten pro Monat, dauerhaft – genug, um diese Resource mit echten Daten zu bauen und zu testen. Für tägliches Support- oder Ops-Volumen erhöht der Starter-Tarif für 5 €/Monat dein Kontingent, mit Datenhosting in der EU (Paris) und einem automatischen AVV (DPA) bei bezahlten Tarifen, falls dein internes Tooling ihn für einen Kundenvertrag braucht.

Bereit, den Button einzubauen? Erstelle einen kostenlosen Account und sende in wenigen Minuten deine erste WhatsApp-Nachricht aus einer Retool-App.

Selbst WhatsApp-Nachrichten per API senden?

Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.

Für immer gratis