WhatsApp-API-Key sicher verwalten: Lecks verhindern und reagieren
Dein API-Key ist der einzige Schlüssel, den jemand braucht, um im Namen deiner WhatsApp-Nummer Nachrichten zu senden. Kein Passwort, keine zweite Verifizierung – wer den Key hat, kann die API aufrufen, als wäre er dein Unternehmen. Trotzdem gehen viele Teams nachlässig damit um: hartcodiert in einem Skript, per Slack geteilt oder jahrelang unverändert von jedem genutzt, der je Zugriff bekam. Dieser Artikel zeigt, was du konkret anders machen kannst.
Was der Key tatsächlich kann
Jeder Aufruf der TextMeFlow-API – ob die moderne REST-API unter /v1/* oder die TextMeBot-kompatible Route /send.php – identifiziert sich mit demselben Key, als Header Authorization: Bearer <dein_api_key> oder als Parameter ?apikey=. Eine separate Nur-Lese-Variante gibt es nicht: Wer den Key hat, kann Nachrichten senden, Punkt. Ein geleakter Key ist deshalb nicht nur ein Datenschutz-, sondern auch ein Betriebsrisiko: Jemand, der den Key missbraucht, um massenhaft unerwünschte Nachrichten zu senden, rückt deine Nummer direkt ins Visier der Anti-Spam-Pipeline – und im schlimmsten Fall in Richtung einer Meta-Sperre, mit deinen Kunden als Kollateralschaden.
Wo der Key stehen darf und wo nicht
Die Faustregel ist einfach: Der Key landet nie in der Versionskontrolle. Konkret:
- Leg ihn in einer
.env-Datei oder im Secrets-Manager deiner Hosting-Plattform ab (Railway, Fly.io, eine.envauf dem Server, die nicht in Git liegt), nie hartcodiert in einer.js-,.php- oder.py-Datei, die du committest. - Trag
.envin deine.gitignoreein, bevor du die erste Datei anlegst, nicht erst danach – ein Key, der je committet wurde, bleibt in der Git-Historie, auch nach einem späteren Löschen. - Teile einen Key nie per Chat, E-Mail oder geteiltem Dokument. Nutze die Secrets-Funktion deines Team-Tools (GitHub-Actions-Secrets, Vercel-Umgebungsvariablen, 1Password) statt Copy-and-paste.
- Arbeitest du mit einem Freelancer oder einer Agentur, die vorübergehend Zugriff braucht, gib diesen Zugriff über eine Umgebung, die du später widerrufen kannst (ein gemeinsamer Secrets-Tresor), nicht indem du den Key selbst weiterreichst.
Wenn du gerade erst mit der API beginnst: Den vollständigen Authentifizierungsablauf findest du unter /de/docs/api, die Schritte zum Erstellen eines ersten Keys unter /de/docs/getting-started.
Webhooks sind eine andere Geschichte
Beachte den Unterschied: Dein API-Key sendet Nachrichten, aber eingehende Webhooks (Nachrichtenstatus, Antworten von Kunden) werden nicht mit diesem Key abgesichert. Sie sind HMAC-signiert – TextMeFlow signiert jede Webhook-Payload mit einem eigenen Secret, sodass dein Endpunkt prüfen kann, dass die Anfrage wirklich von TextMeFlow kommt und nicht von jemandem, der deine Webhook-URL erraten hat. Das ist ein eigenes Secret mit einer anderen Rolle als dein API-Key und verdient eine eigene sorgfältige Aufbewahrung. Wie du diese Signatur prüfst, steht in Webhook-Signaturen verifizieren.
Wann du rotieren solltest
Es gibt ein paar Momente, in denen du nicht warten solltest, bis etwas schiefgeht:
- Ein Mitarbeiter oder Freelancer mit Zugriff verlässt das Unternehmen. Wurde der Key je mit jemandem geteilt, der geht, ist das der Moment, ihn zu ersetzen – nicht „irgendwann in diesem Quartal“.
- Du findest den Key zufällig in einer committeten Datei, einem öffentlichen Repo oder einer Logdatei. Geh ab diesem Moment davon aus, dass er kompromittiert ist, auch wenn du nicht sicher weißt, ob ihn schon jemand benutzt hat.
- Du siehst Nachrichten rausgehen, die du nicht ausgelöst hast. Das ist das deutlichste Zeichen für Missbrauch und verlangt sofortiges Handeln.
Wenn du einen Leak vermutest, kontaktiere den TextMeFlow-Support, damit der bestehende Key ungültig gemacht wird und du einen neuen erhältst. Aktualisiere danach jede Stelle, an der der alte Key stand – Skripte, Automatisierungen, CI/CD-Secrets –, denn eine vergessene Stelle mit dem alten Key bedeutet nichts anderes als einen stillen Ausfall in der Produktion, sobald dieser Key nicht mehr funktioniert.
Ein Key, mehrere Integrationen
Die meisten Teams nutzen denselben Key in mehreren Tools: einem n8n-Flow, einem Backend-Skript, einer Airtable-Automation. Das ist an sich kein Problem, macht die Rotation aber lästiger – du musst überall aktualisieren. Führe deshalb eine Liste, wo der Key verwendet wird (eine Zeile in einem internen Wiki-Dokument genügt), damit eine Rotation nicht zur Detektivarbeit wird. Für Teams, die mit mehreren Nummern arbeiten, ist ab dem Business-Tarif ein eigenes Gerät pro Team oder Standort verfügbar, was Rotation und Zugriffskontrolle pro Nummer einfacher macht, als alles über einen gemeinsamen Key laufen zu lassen.
Noch kein Konto? Erstelle ein kostenloses TextMeFlow-Konto und starte mit einem Key, den du vom ersten Tag an korrekt aufbewahrst – das ist einfacher, als hinterher aufzuräumen.
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