· 2 min · TextMeFlow Team

Envoyer une confirmation WhatsApp après un formulaire Typeform

Typeform est souvent utilisé pour les formulaires d'accueil, d'inscription ou de demande, car il est agréable à remplir sur mobile. Son inconvénient : sans outil supplémentaire, vous ne remarquez une nouvelle réponse que lorsque vous ouvrez le tableau de bord par hasard. Contrairement à Google Forms, Typeform dispose, lui, d'un webhook intégré — vous n'avez donc besoin ni d'Apps Script ni d'une couche intermédiaire pour envoyer un message WhatsApp dès que quelqu'un clique sur « envoyer ».

Cet article montre comment relier ce webhook natif directement à l'API TextMeFlow avec un petit endpoint PHP.

Comment ça fonctionne

À chaque soumission, Typeform peut envoyer une requête POST vers une URL que vous indiquez, avec toutes les réponses sous forme de charge utile JSON. Cet endpoint n'a rien de compliqué à faire : il lit les champs utiles de la charge utile et appelle l'API TextMeFlow pour envoyer le message WhatsApp.

Deux éléments, donc :

  1. Le réglage du webhook dans votre formulaire Typeform
  2. Un script PHP qui reçoit la charge utile et la transmet à TextMeFlow

Étape 1 : ajouter un webhook dans Typeform

Dans l'éditeur Typeform, allez dans Connect → Webhooks → Add a webhook et saisissez l'URL de votre propre endpoint (par exemple https://votredomaine.fr/typeform-hook.php). Typeform signe chaque requête avec une signature HMAC-SHA256 dans l'en-tête Typeform-Signature, calculée avec un secret que vous définissez vous-même lors de la création du webhook. Conservez ce secret — il vous servira à vérifier qu'une requête entrante provient bien de Typeform et n'est pas falsifiée.

Étape 2 : l'endpoint PHP

<?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 = "Merci pour votre envoi, {$naam} ! Nous vous recontactons très vite.";

$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);

Vous devez adapter les valeurs ref ("naam", "telefoon") aux identifiants de champ de votre propre formulaire — vous les définissez vous-même pour chaque question sous Field settings → Ref. L'aperçu complet des paramètres et des endpoints de l'API TextMeFlow se trouve sur /fr/docs/api ; pour la vérification plus générale des signatures de webhooks entrants (y compris les webhooks sortants de TextMeFlow), consultez /fr/blog/verify-whatsapp-webhook-signatures.

Ne confirmer qu'en cas de consentement

N'envoyez un message WhatsApp au numéro de téléphone saisi dans le formulaire que si la personne y a expressément consenti — par exemple via une case à cocher (« J'accepte d'être contacté(e) par WhatsApp »). Sans ce consentement, vous envoyez en principe des messages non sollicités, ce qui nuit aussi à terme à votre réputation d'expéditeur.

Points d'attention

  • Format du numéro de téléphone : le type de question phone_number de Typeform fournit généralement déjà un format international, mais vérifiez-le avant d'envoyer — l'API TextMeFlow attend un numéro E.164 valide, sans + ni 00 initial.
  • Limites de débit : lors d'un pic de soumissions (par exemple après une campagne marketing), vous pouvez atteindre les limites de débit standard de votre plan. Les limites exactes par plan et les réponses d'erreur figurent sur /fr/docs/rate-limits.
  • Gestion des erreurs : vérifiez le code de statut HTTP de l'appel curl. En cas de réponse 4xx ou 5xx de TextMeFlow, mieux vaut la journaliser, afin qu'un envoi échoué ne se perde pas en silence.
  • Pas de serveur à vous ? Sans hébergement PHP, vous pouvez construire le même flux sans code avec un outil d'automatisation — voir /fr/docs/integrations pour l'approche n8n/Make/Zapier.

Conclusion

Comme Typeform propose des webhooks natifs, le chemin le plus court vers une confirmation WhatsApp automatique est un petit endpoint sans état qui traduit la charge utile en appel d'API — sans abonnement supplémentaire ni couche intermédiaire. Pour des flux plus complexes avec plusieurs étapes de suivi (mise à jour du CRM, notification Slack, création de tâche), un outil d'automatisation est le meilleur choix.

Pas encore de compte ? Vous pouvez démarrer gratuitement avec 50 messages par mois, pour toujours — sans carte bancaire. Créez un compte gratuit.

Envie d'envoyer des messages WhatsApp via API ?

Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.

Gratuit pour toujours