# ClickFunnels

### Ce que ça fait

ClickFunnels 2.0 envoie en temps réel vers DURUM.ai les **soumissions de formulaire** de vos funnels (optins) et les **commandes uniques** payées. La connexion se fait avec votre sous-domaine et une clé API : DURUM.ai crée lui-même les webhooks dans votre workspace, il n'y a rien à coller dans ClickFunnels.

Chaque funnel se classe ensuite en un clic : ses soumissions deviennent des **leads**, des **candidatures** (applications), ou sont **ignorées**.

### Avant de commencer

- Un compte **ClickFunnels 2.0** (adresse en `votresite.myclickfunnels.com`). L'ancienne version de ClickFunnels n'est pas prise en charge.
- Le droit de créer une clé API dans **Account Settings**, section **Developer**. La clé est personnelle : elle donne accès aux workspaces de votre compte.
- Votre sous-domaine : la partie avant `.myclickfunnels.com` dans l'URL de votre workspace.
- Pour l'attribution publicitaire, le pixel DURUM installé sur vos pages ClickFunnels (voir la page Tracking UTM), ou des champs cachés UTM dans vos formulaires.

### Connexion étape par étape

1. Connectez-vous à **ClickFunnels 2.0** (`votresite.myclickfunnels.com`).
2. Cliquez sur votre avatar en bas à gauche, puis sur **Account Settings**.
3. Dans la section **Developer**, ouvrez **API keys** et cliquez sur **Create API key**. Copiez la clé.
4. Dans DURUM.ai, allez dans **Paramètres** puis **Intégrations**, et cliquez sur **Connecter** sur la carte **ClickFunnels** (catégorie Funnels).
5. Remplissez la fenêtre :
   - **Sous-domaine ClickFunnels** : par exemple `monentreprise`. L'URL complète est acceptée, DURUM.ai garde la partie utile.
   - **Clé API ClickFunnels** : collez la clé copiée à l'étape 3.
6. Cliquez sur **Connecter**. DURUM.ai valide la clé, découvre vos équipes et workspaces.
   - Si la clé donne accès à **un seul workspace**, il est connecté directement.
   - Si elle donne accès à **plusieurs workspaces**, un champ **Workspace à connecter** apparaît : choisissez-en un et cliquez de nouveau sur **Connecter**. Une connexion couvre un seul workspace.
7. Le message « ClickFunnels connecté » confirme la connexion. DURUM.ai a créé deux webhooks dans le workspace, tous deux nommés avec le préfixe « DURUM.ai » :
   - **Leads (form submissions)** sur l'événement `form_submission.created`, vers `https://app.durum.ai/api/webhook/lead` ;
   - **Ventes (one-time orders)** sur l'événement `one-time-order.completed`, vers `https://app.durum.ai/api/webhook/sale`.

> **Info: Nom des webhooks**
>
> Ne renommez pas et ne supprimez pas ces webhooks dans ClickFunnels : DURUM.ai les reconnaît par leur URL, qui contient votre identifiant.

#### Classer vos funnels

1. Sur la carte ClickFunnels, ouvrez les paramètres de l'intégration.
2. La liste de vos funnels s'affiche. Pour chacun, choisissez **Lead**, **Application** ou **Ignorer**.
3. Cliquez sur **Enregistrer**.

Sans classement, toute soumission est enregistrée comme lead. Le classement s'applique à la réception : il n'y a rien à changer dans ClickFunnels.

### Vérifier que ça marche

1. Ouvrez une page de votre funnel et soumettez le formulaire avec un courriel de test facile à reconnaître.
2. Attendez 30 secondes.
3. Dans DURUM.ai, ouvrez **Logs Data** : un événement `lead` (ou `application` selon le classement) de source `clickfunnels` doit apparaître.
4. Pour les ventes, passez une commande de test : un événement `sale` doit apparaître avec le montant de la commande.

### Événements captés

| Côté ClickFunnels | Événement DURUM.ai | Ce qu'il alimente |
|-------------------|--------------------|-------------------|
| `form_submission.created` (funnel classé Lead, ou non classé) | `lead` | Leads. Contact = courriel, téléphone, prénom et nom du formulaire. Date = date de la soumission. |
| `form_submission.created` (funnel classé Application) | `application` | Candidatures. |
| `form_submission.created` (funnel classé Ignorer) | aucun | Ignoré, visible dans Logs Data avec la raison `funnel_ignored`. |
| `one-time-order.completed` | `sale` | Ventes. Montant = `total_amount` de la commande (taxes incluses), référence de facture = numéro de commande, statut = `billing_status`. |
| Remboursements, abonnements, factures récurrentes | aucun | Non couverts pour l'instant. |

Champs UTM lus dans la soumission (champs cachés du formulaire, remplis par le pixel DURUM ou par ClickFunnels) : `utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`, `utm_ad_id`, `utm_adset_id`, `utm_campaign_id`, ainsi que `fbclid`, `gclid`, `fbc_id` et `h_ad_id`. Sans ces champs, le lead est enregistré mais sans attribution publicitaire directe.

> **Warning: Double comptage des ventes**
>
> ClickFunnels encaisse souvent via Stripe. Si vous connectez aussi Stripe, une même vente peut arriver par les deux sources. DURUM.ai déduplique par courriel, et vous pouvez désactiver le type **Ventes** dans les paramètres de l'intégration ClickFunnels pour ne garder que Stripe.

### Dépannage

| Problème | Solution |
|----------|----------|
| « Clé API invalide ou révoquée » | Recréez une clé dans ClickFunnels, **Account Settings**, **Developer**, **API keys**, et recommencez. |
| « Sous-domaine introuvable chez ClickFunnels » | Vérifiez l'URL de votre workspace : seule la partie avant `.myclickfunnels.com` compte. |
| « Trop de tentatives » | Attendez 1 minute et réessayez. |
| « Connexion sauvegardée, mais la création des webhooks a échoué » | Déconnectez puis reconnectez l'intégration : DURUM.ai réessaie de créer les webhooks. |
| Statut `ignored` avec la raison `no_identifiable_contact` | La soumission n'a ni courriel ni téléphone. Ajoutez un champ courriel au formulaire. |
| Statut `ignored` avec la raison `unhandled_cf_event_type` | ClickFunnels a envoyé un événement que DURUM.ai ne traite pas (autre que soumission ou commande unique). Aucune action requise. |
| Aucun funnel dans la liste de classement | Le workspace connecté ne contient aucun funnel, ou la clé n'y a plus accès. Vérifiez le workspace choisi à la connexion. |
| Vente en double avec Stripe | Désactivez le type Ventes côté ClickFunnels (voir l'avertissement ci-dessus). |

### FAQ

**La clé API expire-t-elle ?**

Non. Elle reste valable tant que vous ne la révoquez pas dans ClickFunnels. Elle est chiffrée et n'est jamais affichée dans DURUM.ai.

**J'ai plusieurs workspaces, comment faire ?**

Une connexion couvre un seul workspace. À la connexion, DURUM.ai vous demande lequel si la clé en voit plusieurs.

**DURUM.ai importe-t-il mes anciennes soumissions ?**

Non. Le suivi commence à la connexion, sans import du passé.

**Que se passe-t-il à la déconnexion ?**

DURUM.ai supprime uniquement les webhooks qui pointent vers `app.durum.ai`. Vos autres webhooks ClickFunnels (Zapier, Kajabi, etc.) ne sont jamais touchés.

**Comment attribuer mes leads ClickFunnels à mes publicités ?**

Installez le pixel DURUM sur vos pages ClickFunnels, ou passez les paramètres UTM de vos publicités dans des champs cachés de vos formulaires. Voir la page Tracking UTM.

---

---

Source: https://docs.durum.ai/integrations/clickfunnels