Typeform

Ce que ca fait

Typeform envoie les soumissions de formulaires en temps réel vers DURUM.ai. Selon le formulaire, la soumission sera classifiee comme lead (premier contact) ou application (formulaire de qualification).

Configuration étape par étape

1. Connectez-vous à votre compte Typeform
2. Ouvrez le formulaire que vous souhaitez connecter
3. Cliquez sur Connect dans le menu du haut
4. Sélectionnez Webhooks dans la liste des intégrations
5. Cliquez sur Add a webhook
6. Dans le champ URL, entrez :
   • Pour un formulaire de premier contact (lead) :

     https://app.durum.ai/api/webhook/lead?client_key=VOTRE_CLE

   • Pour un formulaire de qualification (application) :

     https://app.durum.ai/api/webhook/application?client_key=VOTRE_CLE

7. Cliquez sur Save
8. Activez le webhook avec le toggle ON

Configuration des hidden fields (important pour le suivi UTM)

Pour que DURUM.ai puisse attribuer chaque soumission à la bonne campagne publicitaire, configurez des hidden fields dans votre formulaire Typeform :

1. Dans Typeform, ouvrez votre formulaire en mode edition
2. Cliquez sur Logic dans le menu latéral
3. Sélectionnez Hidden Fields
4. Ajoutez les champs suivants :
   • client_key -- votre identifiant client
   • utm_source -- la source du trafic (ex: facebook, google)
   • utm_campaign -- le nom de la campagne
   • utm_content -- le nom de la publicité
   • utm_term -- le terme de recherche (optionnel)
5. Dans vos publicités Meta, ajoutez ces paramètres à l'URL du formulaire Typeform :

   https://votre-formulaire.typeform.com/to/XXXXX#client_key=VOTRE_CLE&utm_source=facebook&utm_campaign={{campaign.name}}&utm_content={{ad.name}}

WARNING

Sans les hidden fields UTM, DURUM.ai recevra la soumission mais ne pourra pas l'attribuer à une campagne spécifique. Le lead sera quand même enregistre, mais sans attribution publicitaire.

Comment tester

1. Ouvrez votre formulaire Typeform dans un navigateur
2. Remplissez une soumission de test (utilisez un email facilement identifiable)
3. Attendez 30 secondes
4. Dans DURUM.ai, allez dans Logs Data
5. Vérifiez que l'événement apparaît avec le bon type (lead ou application)

Dépannage Typeform

Problème	Solution
L'événement n'apparaît pas	Vérifiez que le webhook est active (toggle ON) dans Typeform
Statut quarantined	Le formulaire n'est pas encore reconnu. L'agence le categorisera automatiquement.
client_key=unknown dans les logs	Le client_key n'est pas présent dans l'URL ou les hidden fields
Pas d'attribution aux campagnes	Vérifiez que les hidden fields UTM sont configurés et passes dans l'URL

Identification automatique

Si un formulaire Typeform est nouveau et que le client_key n'est pas dans l'URL, DURUM.ai tente de l'identifier via sa base de formulaires connus. Si le formulaire est inconnu, il est mis en quarantaine et l'agence le mappe à votre compte. Les soumissions suivantes seront automatiquement reconnues.

---