Menu de la documentation

Tally : vos répondants

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

Chaque fois que quelqu'un envoie votre formulaire, Tally peut transmettre sa réponse à une adresse web, aussitôt : 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.
  • Aucune offre payante. Tally indique que les webhooks sont gratuits pour tous ses utilisateurs.
  • Un formulaire publié. Tally demande de publier le formulaire avant d'ajouter le webhook.
  • Une question pour l'adresse e-mail, dans votre formulaire.

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 Tally

  1. Publiez votre formulaire, puis ouvrez son onglet « Integrations ».
  2. Sur la carte « Webhooks », cliquez sur « Connect ».
  3. Dans la fenêtre « Add a webhook endpoint », collez votre adresse de réception Mailcheer dans « Endpoint URL ».
  4. Cliquez sur « Connect ».

Le webhook apparaît ensuite dans « My connections », en haut de l'onglet « Integrations ». Son interrupteur le met en pause ou le réactive.

La fenêtre propose deux options, toutes deux facultatives :

  • « Add a signing secret » : Tally signe alors chaque envoi, dans un en-tête Tally-Signature. Vous pouvez vous en passer.
  • « Add HTTP headers » : ajoute à chaque envoi des en-têtes de votre choix.

2. Envoyez un essai

Pour l'essai, répondez vous-même au formulaire :

  1. Ouvrez votre formulaire publié et remplissez-le avec votre propre adresse e-mail.
  2. Envoyez-le.
  3. Dans l'onglet « Integrations », cliquez sur l'icône d'horloge à côté du webhook : le journal liste toutes les requêtes envoyées à votre adresse de réception.

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.

Tally envoie la réponse en JSON. Elle se trouve dans data, sous la forme d'une liste fields : chaque champ y porte son libellé (label), son type (type) et sa valeur (value). Une question e-mail porte le type INPUT_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 tally) 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 Tally a envoyé : onglet « Integrations » → icône d'horloge à côté du webhook.

  • Le webhook est en pause. Vérifiez son interrupteur dans « My connections ».
  • L'adresse est incomplète. L'icône en forme de crayon, à côté du webhook, permet de modifier l'adresse. Comparez-la avec l'adresse de réception affichée dans Mailcheer : elle doit être copiée en entier, sans espace ni caractère en trop.
  • Aucune requête dans le journal. Vérifiez que vous avez bien envoyé le formulaire publié, et que le webhook est rattaché à ce formulaire-là : chaque formulaire a son propre onglet « Integrations ».
  • Les envois échouent. Quand un envoi n'aboutit pas, Tally réessaie cinq fois, en espaçant les tentatives de 5 minutes à 1 jour. Si tous les essais échouent, Tally écrit au propriétaire du formulaire, avec la raison et un lien pour corriger.

Sources