Typeform

Ce que ca fait

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

Configuration etape par etape

1. Connectez-vous a votre compte Typeform
2. Ouvrez le formulaire que vous souhaitez connecter
3. Cliquez sur Connect dans le menu du haut
4. Selectionnez Webhooks dans la liste des integrations
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 a 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 lateral
3. Selectionnez 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 publicite
   • utm_term -- le terme de recherche (optionnel)
5. Dans vos publicites Meta, ajoutez ces parametres a 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 a une campagne specifique. Le lead sera quand meme 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. Verifiez que l'evenement apparait avec le bon type (lead ou application)

Depannage Typeform

Probleme	Solution
L'evenement n'apparait pas	Verifiez 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 present dans l'URL ou les hidden fields
Pas d'attribution aux campagnes	Verifiez que les hidden fields UTM sont configures 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 a votre compte. Les soumissions suivantes seront automatiquement reconnues.

---