Se connecterCréer un compte gratuit

Langue

Se connecterCréer un compte gratuit
Menu de la documentation

Typeform : vos répondants

Faites entrer dans Mailcheer les personnes qui répondent à votre formulaire Typeform : webhook à chaque réponse, essai, choix du champ e-mail.

Chaque fois que quelqu'un envoie votre formulaire, Typeform peut transmettre ses réponses à une adresse web, en quelques secondes : c'est un webhook. Donnez-lui votre adresse de réception Mailcheer, et la personne arrive dans vos contacts, sans export ni import.

Avant de commencer

  • Une adresse de réception Mailcheer. Dans Mailcheer, ouvrez Intégrations → Faire entrer des contacts et cliquez sur « Créer une adresse de réception ». Mailcheer vous donne une adresse de la forme https://mailcheer.com/api/in/<jeton>. C'est un secret : ne la publiez nulle part, car quiconque la connaît peut y envoyer des données.
  • Une offre Typeform qui comprend les webhooks. Sur sa page de tarifs, Typeform range « Webhooks & integrations » parmi les fonctionnalités de l'offre Basic, et les offres Plus et Business reprennent tout ce que contient Basic. Pour voir ce que comprend votre offre, Typeform renvoie aux réglages de votre organisation (« Organization Settings »).
  • Une question pour l'adresse e-mail. Le plus simple est une question de type « Email ».

Un mot sur le consentement

N'y faites entrer que des personnes qui ont accepté de recevoir vos e-mails : dites-le clairement dans votre formulaire. Le double opt-in (un e-mail de confirmation) est activé par défaut dans Mailcheer.

1. Créez le webhook dans Typeform

  1. Ouvrez votre formulaire depuis votre espace de travail (« Workspace »).
  2. Ouvrez le panneau « Connect », puis l'onglet « Webhooks ».
  3. Cliquez sur « Add a webhook ».
  4. Collez votre adresse de réception Mailcheer dans « Destination URL », puis cliquez sur « Save webhook ».
  5. De retour dans l'onglet « Webhooks », allumez le webhook avec son interrupteur : un nouveau webhook reste sur « Off » tant que vous ne l'activez pas.

Typeform n'accepte que les adresses en https:// : c'est le cas de l'adresse Mailcheer.

Le bouton « Edit », à côté du webhook, ouvre ses réglages. Deux d'entre eux vous concernent :

  • « Secret » : facultatif. Typeform s'en sert pour signer ses envois. Vous pouvez laisser ce champ vide.
  • « Trigger » : choisissez les réponses complètes. Si vous ajoutez les réponses partielles, une même personne peut déclencher le webhook plusieurs fois.

Enregistrez avec « Save changes ».

2. Envoyez un essai

  1. Dans l'onglet « Webhooks », cliquez sur « View deliveries ».
  2. Cliquez sur « Send test request ».
  3. L'envoi apparaît dans la liste de gauche, marqué « Test ». « Request » montre ce que Typeform a envoyé, « Response » ce qu'il a reçu en retour.
  4. Fermez la fenêtre avec la croix, en haut à droite.

Pour renvoyer un essai, le webhook doit être sur « On ». Vous pouvez aussi répondre vous-même au formulaire, avec votre propre adresse e-mail : une vraie réponse suit le même chemin.

Mailcheer répond tout de suite et traite l'envoi ensuite.

3. Choisissez les champs dans Mailcheer

Revenez sur votre adresse de réception dans Mailcheer : elle affiche ce qu'elle a reçu, avec la liste des champs trouvés.

Typeform range les réponses dans form_response, sous la forme d'une liste answers. Chaque réponse indique son type : la réponse à une question « Email » porte le type email. Repérez ce champ-là.

Choisissez ensuite, en cliquant :

  • le champ qui contient l'e-mail (obligatoire) ;
  • le prénom et le nom, si vous le souhaitez ;
  • les étiquettes : fixes (par exemple typeform) ou tirées d'un champ ;
  • le double opt-in, activé par défaut ;
  • l'automatisation à déclencher, si vous en avez une.

Pour importer les personnes que vous aviez déjà, passez par un fichier : voir Importer vos contacts.

Si ça ne marche pas

Commencez par regarder ce que Typeform a envoyé : onglet « Webhooks » → « View deliveries ». Typeform garde les envois 30 jours, avec la réponse reçue pour chacun.

  • Le webhook est sur « Off ». Un nouveau webhook est éteint : allumez-le dans l'onglet « Webhooks ».
  • L'adresse est incomplète. Ouvrez « Edit » et comparez « Endpoint URL » avec l'adresse de réception affichée dans Mailcheer : elle doit être copiée en entier, sans espace ni caractère en trop.
  • Le champ e-mail manque dans l'envoi. Typeform n'envoie que les questions auxquelles la personne a répondu. Une question e-mail facultative, ou sautée par la logique du formulaire, n'y figure pas.
  • Typeform a désactivé le webhook. Typeform peut désactiver un webhook qui accumule les erreurs, et vous prévient alors par e-mail. Revenez dans « Connect » → « Webhooks » pour vérifier son adresse et son état.

Sources