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:
- Die Webhook-Einstellung in deinem Typeform-Formular
- 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_numbervon 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+oder00. - 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 einer4xx- oder5xx-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