# Tunnels de vente

La plateforme se connecte à vos tunnels de vente existants afin que, lorsqu'une personne remplit un formulaire d'inscription sur votre page de destination, elle soit automatiquement ajoutée en tant que contact et reçoive un message personnalisé - le tout sans aucune intervention manuelle de votre part.

**En termes simples :** Quelqu'un s'inscrit sur votre site web et, en quelques minutes, il reçoit un message WhatsApp de votre bot IA qui entame une véritable conversation.


---

## Ce que fait une intégration de tunnel

Lorsque vous connectez votre page de destination à la plateforme, chaque nouveau prospect est automatiquement :

1. **Ajouté en tant que contact** dans l'application
2. **Ajouté à une liste de contacts spécifique** surveillée par votre diffusion
3. **Engagé par votre bot IA** avec un message d'ouverture personnalisé
4. **Relancé automatiquement** s'il ne répond pas

Cela transforme une page d'inscription passive en une conversation de vente active, entièrement gérée par votre bot IA.

**Exemple : À quoi cela ressemble en pratique**

```
Someone fills out your landing page form
       |
       v
Your automation tool (Pabbly, Zapier, or Make) sends
the lead's info to the platform
       |
       v
The platform creates the contact and adds them to your list
       |
       v
Your Broadcast sends a personalized WhatsApp message
       |
       v
The lead replies, and your AI bot continues the conversation
```

---

## Ce que votre page d'inscription doit collecter

Votre page de destination (créée avec ClickFunnels, Leadpages, Systeme.io, WordPress ou tout autre outil) doit collecter au moins ces deux champs :

### Champs requis

| Champ | Pourquoi est-ce nécessaire |
|-------|-----------------|
| **Numéro de téléphone** | La plateforme envoie des messages via WhatsApp ou SMS, un numéro de téléphone est donc essentiel. Il doit inclure l'indicatif pays (par ex. +33 pour la France, +41 pour la Suisse). |
| **Prénom** | Utilisé pour personnaliser le message d'ouverture. Les messages incluant le prénom de la personne obtiennent des taux de réponse nettement plus élevés. |

### Optionnel mais recommandé

| Champ | Pourquoi est-ce utile |
|-------|-------------|
| **E-mail** | Permet un suivi multicanal et aide à éviter les contacts en double |
| **Nom de famille** | Personnalisation plus professionnelle |
| **Champs personnalisés** | Toute donnée pertinente pour votre offre (nom de l'entreprise, domaine d'intérêt, etc.) |

**Conseil :** Gardez votre formulaire court. Le numéro de téléphone et le prénom sont le minimum requis. Chaque champ supplémentaire ajouté diminue votre taux de conversion. Vous pouvez toujours collecter des informations complémentaires au cours de la conversation elle-même.

---

## Configuration de votre agent pour les tunnels

Un tunnel nécessite deux éléments : un **agent IA** qui connaît votre offre et répond à chaque prospect de la même manière, et une **diffusion** qui envoie le premier message aux prospects collectés par votre tunnel. Créez d'abord l'agent — la diffusion sera ensuite liée à celui-ci.

### Configuration étape par étape

1. **Commencez par votre agent**
   - Vous en avez déjà un pour cette offre ? Sous **AI Studio**, cliquez sur **AI Agents** et cliquez sur son nom. (Sur un téléphone, appuyez d'abord sur l'icône de menu **☰**.)
   - Vous partez de zéro ? Cliquez sur **New agent** et pointez-le vers votre site web — il lira vos pages et rédigera les instructions pour vous — ou choisissez **Start blank**. Voir [Création d'un agent](../ai-agents/ai-agents.md#creating-an-agent).
   - Donnez-lui un nom descriptif, par exemple "Tunnel Webinaire - Mars 2026".


2. **Configurer le bot**
   - À l'étape **Instructions IA**, rédigez des instructions adaptées à l'offre de votre tunnel
   - Ajoutez des informations sur l'entreprise, des FAQ et des ressources spécifiques à l'offre à l'étape **FAQ & Connaissances**
   - Définissez l'objectif de la conversation (par ex. "Réserver un appel de consultation gratuit")
   - Consultez le guide [Configuration de votre bot IA](../ai-automation/ai-bot-setup.md) pour des instructions détaillées


3. **Activez l'agent**
   - De retour sur la page AI Agents, utilisez le bouton **Activate agent** de la ligne pour que son statut indique **Active**. À partir de ce moment, il répondra à toute personne vous contactant sur les canaux dont il est responsable.
   - Ces canaux sont déterminés par les [Points d'entrée](../ai-agents/entry-points.md) — soit via l'étape **Entry Points** de l'agent, soit via le panneau **Who answers new conversations** en haut de la page AI Agents.

4. **Créez la diffusion qui envoie le premier message**
   - Ouvrez [Broadcasts](../broadcasts/broadcasts.md) et créez-en une. Son étape **Message** contient le message d'ouverture que vos prospects recevront — incluez le prénom du contact, soyez bref, c'est votre première impression.
   - À l'étape **Replies**, choisissez l'agent que vous venez de créer. C'est ce qui connecte l'envoi au cerveau de l'IA.
   - Sur WhatsApp, le message d'ouverture doit être soumis à WhatsApp pour approbation avant de pouvoir être envoyé ; voir [Modèles WhatsApp](../templates/whatsapp-templates.md).


5. **Notez l'ID de votre liste**
   - L'automatisation de votre tunnel a besoin de l'ID de la liste à laquelle ajouter les prospects. Sous **CRM**, ouvrez **Contacts** → **Lists**, ouvrez la liste vers laquelle votre diffusion envoie, et copiez son ID depuis cette page.


6. **Activez les relances** (recommandé)
   - Activez les relances automatiques à l'étape **Follow-ups** de l'agent afin que les prospects qui ne répondent pas soient réengagés.
   - Voir le guide [Système de relance](../ai-automation/follow-ups.md) pour plus de détails.


---

## Connecter votre tunnel à l'application

La plateforme fonctionne avec toutes les principales plateformes d'automatisation. Voici comment connecter le formulaire de votre page de destination.

### Option 1 : Utiliser Pabbly Connect

Pabbly est rentable et gère bien les tunnels à fort volume.

**Étapes :**

1. **Configurez un déclencheur webhook** - Il se déclenche lorsque quelqu'un soumet votre formulaire d'inscription.
2. **Ajoutez un délai de 15 à 20 minutes** (optionnel mais recommandé) - Donne au prospect le temps de vous envoyer un message en premier, créant une conversation plus naturelle.
3. **Vérifiez si le contact existe déjà** - Appelez l'API pour éviter de créer des doublons.
4. **Créez le contact et ajoutez-le à votre liste en un seul appel** - Envoyez ses informations à la plateforme en incluant l'ID de liste de votre diffusion (`listId`). Une seule requête crée le contact et l'ajoute à la liste, et l'ajout à la liste est ce qui déclenche le message d'ouverture. (Voir [Intégration API directe](#direct-api-integration) ci-dessous.)

### Option 2 : Utiliser Zapier

**Étapes :**

1. **Déclencheur :** Nouvelle soumission de formulaire depuis votre page de destination.
2. **Action 1 :** l'application - Find Contact (vérifier s'il existe déjà).
3. **Filtre :** Continuer uniquement si le contact n'a PAS été trouvé.
4. **Action 2 :** l'application - Create Contact, en incluant l'ID de liste de votre diffusion afin que le contact soit créé directement dans la liste. Si vous préférez l'API brute, un seul POST "Webhooks by Zapier" vers `/v1/contacts` avec `listId` fait la même chose — aucune étape "Ajouter à la liste" séparée n'est nécessaire.

### Option 3 : Utiliser Make (anciennement Integromat)

**Étapes :**

1. **Déclencheur de webhook** depuis votre tunnel
2. **Vérification** de l'existence du contact via l'API
3. **Création** du contact s'il est nouveau, en transmettant l'ID de liste de votre diffusion (`listId`) dans la même requête - cela crée le contact et l'ajoute à la liste en un seul appel. Un seul module HTTP POST vers `/v1/contacts` gère les deux.

---

## Intégration directe via API

Si vous avez un développeur ou si vous gérez vous-même le backend de votre site web, vous pouvez vous connecter directement à l'API de la plateforme sans outil intermédiaire.

### Créer le contact et l'ajouter à votre liste - en un seul appel

Vous n'avez **pas** besoin de deux requêtes distinctes. Le point de terminaison de création de contact accepte un `listId`, donc un seul appel crée le contact **et** l'ajoute à la liste de votre diffusion - et l'ajout du contact à cette liste est exactement ce qui déclenche le message d'ouverture.

```
POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "phoneNumber": "+1234567890",
  "firstName": "John",
  "lastName": "Smith",
  "email": "john@example.com",
  "listId": "YOUR_LIST_ID"
}
```

Pour ajouter le contact à plusieurs listes à la fois, utilisez `listIds` (un tableau) à la place - il est prioritaire sur `listId` :

```
{
  "phoneNumber": "+1234567890",
  "firstName": "John",
  "listIds": ["list123", "list456"]
}
```

> **Utilisez des noms de champs en camelCase** (`phoneNumber`, `firstName`, `lastName`) - pas `phone_number` / `first_name`. Tout champ que la plateforme ne reconnaît pas est stocké en tant que [champ personnalisé](../get-started/custom-contact-fields.md) sur le contact ; ainsi, un `phone_number` mal orthographié laisserait le contact sans numéro de téléphone et la requête serait rejetée.

### Ajouter un contact existant à une liste (facultatif)

Si le contact existe déjà et que vous avez seulement besoin de l'ajouter à une liste, utilisez le point de terminaison d'ajout à une liste avec l'ID du contact :

```
POST https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "contactId": "abc123",
  "listId": "YOUR_LIST_ID"
}
```

Consultez la [référence complète de l'API Contacts](../api/contacts.md) pour voir tous les champs disponibles.

**Où trouver votre clé API :** Allez dans **Paramètres** (icône d'engrenage, près du bas de la barre latérale gauche) → **Intégrations** → **Clé API**.

**Important :** Incluez toujours l'indicatif pays dans le numéro de téléphone (par ex. `+1` pour les États-Unis, `+44` pour le Royaume-Uni, `+31` pour les Pays-Bas).

---

## Comment les nouveaux membres de la liste déclenchent le message d'ouverture

C'est ce qui relie le tout, une fois que votre diffusion est en ligne avec l'option **Envoyer aux nouveaux membres de la liste** activée :

1. Un nouveau contact est ajouté à la liste surveillée par votre diffusion (via l'automatisation, une importation manuelle ou manuellement)
2. La diffusion détecte le nouveau contact
3. Le message d'ouverture est envoyé :
   - **1 à 3 contacts** sont envoyés immédiatement (c'est le scénario classique de tunnel - une personne s'inscrit à la fois)
   - **4 contacts ou plus simultanément** sont automatiquement mis en file d'attente et envoyés à un rythme sûr pour protéger votre réputation d'expéditeur
4. Lorsque le contact répond, l'agent à l'étape **Réponses** de la diffusion prend le relais de la conversation

---

## Le flux complet du tunnel (de bout en bout)

Voici tout ce qui se passe lorsqu'un prospect entre dans votre tunnel :

1. **Le prospect remplit votre formulaire d'inscription** sur votre page de destination
2. **Votre outil d'automatisation** (Pabbly, Zapier, Make) reçoit les données du formulaire
3. **Délai optionnel de 15-20 minutes** pour voir si le prospect vous envoie un message en premier
4. **L'automatisation vérifie** si le contact existe déjà dans l'application
5. **Le contact est créé dans votre liste** via un seul appel API (l'ID de liste de la diffusion est inclus dans la requête de création, donc la création et l'ajout à la liste se font simultanément)
6. **La diffusion envoie** le message WhatsApp d'ouverture (modèle)
7. **Le prospect lit le message** et répond
8. **Votre bot IA** engage une conversation personnalisée
9. **Le bot travaille vers votre objectif** (prendre rendez-vous, qualifier le prospect, partager une offre)
10. **Si le prospect ne répond plus**, des suivis automatiques le relancent
11. **Si le bot a besoin d'aide**, il alerte un membre de l'équipe pour prendre le relais

---

## Bonnes pratiques

1. **Ajoutez un court délai avant de créer le contact.** Un délai de 15 à 20 minutes donne aux prospects le temps de vous envoyer un message en premier. S'ils le font, ils entrent dans le flux entrant (une conversation plus naturelle). S'ils ne le font pas, le modèle sortant est envoyé.

2. **Activez l'option Envoyer aux nouveaux membres de la liste pour les tunnels en cours.** À l'étape **Audience** de la diffusion, ce paramètre permet à la diffusion de continuer à surveiller la liste après son lancement, afin que chaque nouveau prospect qui s'inscrit reçoive automatiquement le message d'ouverture. Les prospects qui vous envoient un message en premier sont gérés par le même agent via ses points d'entrée, de sorte que les deux directions aboutissent dans une seule configuration.

3. **Personnalisez le message d'ouverture.** Incluez toujours le prénom du contact dans le modèle WhatsApp. Les messages d'ouverture génériques obtiennent des taux de réponse beaucoup plus faibles.

4. **Gardez le message d'ouverture court.** Deux à trois phrases sont idéales. Posez une question pour inviter à une réponse. Par exemple : "Salut {first_name} ! Merci de vous être inscrit à notre consultation gratuite. Quel est le plus grand défi auquel vous faites face avec [sujet] en ce moment ?"

5. **Activez les suivis.** Les prospects du tunnel sont intéressés mais occupés. Un suivi 24 à 72 heures plus tard les ramène souvent vers vous.

6. **Testez le flux complet avant le lancement.** Soumettez une inscription de test sur votre page de destination, vérifiez que le contact est créé dans l'application et confirmez que le message d'ouverture arrive bien.

7. **Surveillez vos taux de conversion.** Suivez combien de prospects du tunnel répondent au message d'ouverture et combien atteignent votre objectif (rendez-vous, vente, etc.) à partir des statistiques de la diffusion. Ajustez vos instructions IA et votre message d'ouverture en fonction de ce que vous apprenez.

8. **Évitez les doublons.** Vérifiez toujours si un contact existe avant de le créer. Les contacts en double entraînent des conversations confuses et un gaspillage de crédits.

9. **Obtenez un consentement approprié.** Assurez-vous que votre page d'inscription indique clairement que le prospect recevra des messages WhatsApp. Incluez une case à cocher de consentement si cela est requis dans votre région.

---

## Étapes suivantes

- [Passer des Campagnes aux Diffusions & Agents](../moving-from-campaigns.md) - où se trouvent désormais tous les anciens paramètres de campagne.
- [Système de suivi](../ai-automation/follow-ups.md) - relancez les prospects du tunnel qui ne répondent plus.
- [Diffusions](../broadcasts/broadcasts.md) - le guide complet pour configurer l'envoi.
- [Référence de l'API Contacts](../api/contacts.md) - tous les champs acceptés par le point de terminaison de création de contact.