· 4 min · TextMeFlow Team

WhatsApp-Auto-Reply-Bot in Python bauen (Flask-Webhook)

Ein Auto-Reply-Bot ist das „Hello World“ der WhatsApp-Automatisierung: Jemand schreibt an deine Nummer, dein Code entscheidet, was geantwortet wird, und die Antwort erscheint innerhalb von Sekunden im Chat. Dieses Tutorial baut einen in Python mit Flask, in etwa 60 Zeilen, ohne Meta-Business-Konto und ohne Template-Freigabe.

Was du brauchst

  • Ein TextMeFlow-Konto mit per QR verknüpfter WhatsApp-Nummer (Einstiegsleitfaden)
  • Deinen API-Key und dein Webhook-Secret aus dem Portal
  • Python 3.10+ mit installierten Paketen flask und requests

Schritt 1 — eingehende Nachrichten empfangen

TextMeFlow liefert jede eingehende Nachricht als JSON an deine Webhook-URL, mit HMAC-SHA256 signiert, damit du prüfen kannst, dass sie wirklich von uns stammt. Das Grundgerüst:

import hashlib
import hmac
import os

import requests
from flask import Flask, request, abort

app = Flask(__name__)

WEBHOOK_SECRET = os.environ["TMF_WEBHOOK_SECRET"]
API_KEY = os.environ["TMF_API_KEY"]
API_URL = "https://api.textmeflow.eu/v1/messages"


@app.post("/webhook")
def webhook():
    received = request.headers.get("X-TextMeFlow-Signature", "")
    expected = "sha256=" + hmac.new(
        WEBHOOK_SECRET.encode(), request.get_data(), hashlib.sha256
    ).hexdigest()
    if not hmac.compare_digest(received, expected):
        abort(401)

    event = request.get_json()
    sender = event["from"]
    text = event.get("message", "").strip().lower()

    reply = make_reply(text)
    if reply:
        send_message(sender, reply)

    return {"ok": True}

Die Signatur steht im Header X-TextMeFlow-Signature als sha256=<hex>, ein HMAC-SHA256-Digest des rohen Request-Bodys. Berechne ihn immer über request.get_data() (die rohen Bytes, nicht neu kodiertes JSON) und vergleiche mit hmac.compare_digest (konstante Zeit), bevor du dem Payload vertraust. Der Payload ist TextMeBot-kompatibel (type, from, from_name, to, message, file); alle Details, auch zu Wiederholungsverhalten und Idempotenz, stehen in unserem Leitfaden zu Webhook-Signaturen.

Schritt 2 — entscheiden, was du antwortest

Beginne mit einfachem Schlagwort-Routing. Es ist unspektakulär und es funktioniert:

def make_reply(text: str) -> str | None:
    if text in ("hi", "hallo", "hello"):
        return "Hallo! Antworte ÖFFNUNGSZEITEN für unsere Zeiten oder PREIS für die Tarife."
    if "öffnungszeiten" in text:
        return "Wir haben Mo-Fr 9:00-18:00 Uhr und Sa 10:00-16:00 Uhr geöffnet."
    if "preis" in text:
        return "Ein Standardservice kostet 95 € inkl. MwSt. Antworte BUCHEN, um einen Termin zu vereinbaren."
    return None  # unbekannte Eingabe: still bleiben, ein Mensch meldet sich

None bei nicht erkannter Eingabe zurückzugeben ist Absicht. Ein Bot, der alles schlecht beantwortet, ist schlimmer als einer, der drei Dinge gut beantwortet und den Rest einem Menschen überlässt.

Schritt 3 — die Antwort senden

Das Senden ist eine einzige POST-Anfrage:

def send_message(to: str, text: str) -> None:
    resp = requests.post(
        API_URL,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"to": to, "text": text},
        timeout=10,
    )
    resp.raise_for_status()

Beachte, dass Antworten auf das monatliche Kontingent deines Tarifs und auf die Rate-Limits pro Nummer (1 Nachricht/Sek.) angerechnet werden. Bei einem Auto-Responder, der echten Kunden antwortet, bleibst du weit unter beiden.

Schritt 4 — starten

export TMF_API_KEY=... TMF_WEBHOOK_SECRET=...
flask run --port 8000

Mache den Port während der Entwicklung über einen Tunnel erreichbar (ngrok oder ähnlich), trage die Tunnel-URL als Webhook-Endpunkt im TextMeFlow-Portal ein und schreibe an deine eigene Nummer. Die Antwort sollte nach ein bis zwei Sekunden eintreffen.

Zwei Regeln, die deinen Bot aus Schwierigkeiten halten

STOP respektieren. TextMeFlow verarbeitet STOP-Schlüsselwörter automatisch auf API-Ebene (ein abgemeldeter Empfänger wird blockiert, noch bevor dein Code läuft), aber entwirf keine Abläufe, die Leute zum Antworten bedrängen.

Nie in eine Schleife geraten. Wenn dein Bot auf seine eigenen ausgehenden Nachrichten reagieren kann (Gruppenchats sind ein klassischer Fall), sichere ab, dass er sich nicht selbst antwortet. Eine einzige Boolean-Prüfung erspart dir ein sehr peinliches endloses Gespräch.

Wie es weitergeht

Ersetze die Schlagwort-Tabelle durch einen LLM-Aufruf, binde ein Buchungssystem an oder leite nicht erkannte Nachrichten an ein menschliches Postfach weiter: Die Struktur Webhook rein, POST raus bleibt identisch. Der kostenlose Tarif (50 Nachrichten/Monat, für immer) reicht zum Bauen und Testen locker aus. Erstelle dein kostenloses Konto und lass den Bot an einem Nachmittag antworten.

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