· 2 min · TextMeFlow Team

WhatsApp-Bestätigung nach einer Typeform-Einsendung senden

Typeform wird oft für Anfrage-, Anmelde- oder Kontaktformulare genutzt, weil es sich am Handy angenehm ausfüllen lässt. Der Nachteil: Ohne zusätzliche Werkzeuge bemerkst du eine neue Einsendung erst, wenn du zufällig das Dashboard öffnest. Anders als Google Forms hat Typeform einen eingebauten Webhook — du brauchst also weder Apps Script noch eine Zwischenschicht, um sofort eine WhatsApp-Nachricht zu senden, sobald jemand auf „Absenden" klickt.

Dieser Artikel zeigt, wie du diesen nativen Webhook mit einem kleinen PHP-Endpunkt direkt mit der TextMeFlow API verbindest.

So funktioniert es

Bei jeder Einsendung kann Typeform einen POST-Request an eine URL deiner Wahl senden, mit allen Antworten als JSON-Payload. Dieser Endpunkt muss nichts Kompliziertes tun: Er liest die relevanten Felder aus der Payload und ruft die TextMeFlow API auf, um die WhatsApp-Nachricht zu senden.

Also zwei Bausteine:

  1. Die Webhook-Einstellung in deinem Typeform-Formular
  2. Ein PHP-Skript, das die Payload empfängt und an TextMeFlow weiterleitet

Schritt 1: Webhook in Typeform hinzufügen

Gehe im Typeform-Editor zu Connect → Webhooks → Add a webhook und trage die URL deines eigenen Endpunkts ein (zum Beispiel https://deinedomain.de/typeform-hook.php). Typeform signiert jeden Request mit einer HMAC-SHA256-Signatur im Header Typeform-Signature, berechnet mit einem Secret, das du beim Erstellen des Webhooks selbst festlegst. Bewahre dieses Secret auf — du brauchst es, um zu prüfen, dass ein eingehender Request wirklich von Typeform stammt und nicht gefälscht ist.

Schritt 2: der PHP-Endpunkt

<?php
$secret = "JOUW_TYPEFORM_WEBHOOK_SECRET";
$body = file_get_contents("php://input");

$signature = "sha256=" . base64_encode(hash_hmac("sha256", $body, $secret, true));
if (!hash_equals($signature, $_SERVER["HTTP_TYPEFORM_SIGNATURE"] ?? "")) {
    http_response_code(401);
    exit("invalid signature");
}

$payload = json_decode($body, true);
$answers = $payload["form_response"]["answers"] ?? [];

$naam = "onbekend";
$telefoon = null;

foreach ($answers as $antwoord) {
    if ($antwoord["field"]["ref"] === "naam") {
        $naam = $antwoord["text"] ?? $naam;
    }
    if ($antwoord["field"]["ref"] === "telefoon") {
        $telefoon = $antwoord["phone_number"] ?? null;
    }
}

$tekst = "Danke für deine Einsendung, {$naam}! Wir melden uns bald bei dir.";

$ch = curl_init("https://textmeflow.eu/api/messages");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "Authorization: Bearer JOUW_API_KEY",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "to" => $telefoon,
        "message" => $tekst,
    ]),
]);
curl_exec($ch);
curl_close($ch);

http_response_code(200);

Die ref-Werte ("naam", "telefoon") musst du an die Feld-IDs aus deinem eigenen Formular anpassen — die legst du pro Frage selbst unter Field settings → Ref fest. Die vollständige Übersicht der Parameter und Endpunkte der TextMeFlow API findest du unter /de/docs/api; wie du eingehende Webhook-Signaturen allgemeiner verifizierst (auch für die ausgehenden Webhooks von TextMeFlow), liest du in /de/blog/verify-whatsapp-webhook-signatures.

Nur bestätigen, wenn eine Einwilligung vorliegt

Sende nur dann eine WhatsApp-Nachricht an die Telefonnummer aus dem Formular, wenn die Person dem ausdrücklich zugestimmt hat — zum Beispiel über eine Checkbox-Frage („Ich bin damit einverstanden, per WhatsApp kontaktiert zu werden"). Ohne diese Einwilligung versendest du im Prinzip unerwünschte Nachrichten, was auf Dauer auch deinem Absenderruf schadet.

Wichtige Hinweise

  • Format der Telefonnummer: Der Fragetyp phone_number von Typeform liefert in der Regel bereits ein internationales Format, prüfe das aber vor dem Senden — die TextMeFlow API erwartet eine gültige E.164-Nummer ohne führendes + oder 00.
  • Rate Limits: Bei einem Ansturm von Einsendungen (z. B. nach einer Marketingkampagne) kannst du an die Standard-Rate-Limits deines Tarifs stoßen. Die genauen Limits pro Tarif und die Fehlerantworten stehen unter /de/docs/rate-limits.
  • Fehlerbehandlung: Prüfe den HTTP-Statuscode des curl-Aufrufs. Bei einer 4xx- oder 5xx-Antwort von TextMeFlow solltest du sie loggen, damit ein fehlgeschlagener Versand nicht stillschweigend verloren geht.
  • Kein eigener Server? Ohne PHP-Hosting kannst du denselben Flow auch ohne Code über ein Automatisierungstool aufbauen — siehe /de/docs/integrations für den n8n-/Make-/Zapier-Ansatz.

Fazit

Weil Typeform native Webhooks anbietet, ist der kürzeste Weg zu einer automatischen WhatsApp-Bestätigung ein kleiner, zustandsloser Endpunkt, der die Payload in einen API-Aufruf übersetzt — kein zusätzliches Abo, keine Zwischenschicht nötig. Für komplexere Flows mit mehreren Folgeschritten (CRM-Update, Slack-Benachrichtigung, Aufgabe anlegen) greifst du am besten zu einem Automatisierungstool.

Noch kein Konto? Du kannst kostenlos starten, mit 50 Nachrichten pro Monat, für immer — keine Kreditkarte nötig. Erstelle ein kostenloses Konto.

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