> ## Documentation Index
> Fetch the complete documentation index at: https://docs.setteo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ajouter des prospects

> Les façons de faire entrer des prospects dans Setteo : message entrant, création manuelle, import CSV, webhook, API et outils de réservation.

Un prospect arrive dans Setteo de plusieurs façons. Sa **Source** garde la trace de son origine : vous la retrouvez sur sa fiche et dans les filtres.

| Comment | Source affichée |
| - | - |
| Il vous écrit sur WhatsApp ou Instagram | WhatsApp, Instagram |
| Vous le créez avec **Nouveau prospect** | Au choix |
| Vous importez un fichier CSV | Import |
| Votre outil l'envoie par webhook | Webhook |
| Votre outil l'envoie par l'API | API |
| Il réserve via Calendly, iClosed, Momence ou Custom One | Le nom de l'outil |

## Le prospect vous écrit

C'est le cas le plus simple. Un prospect écrit sur votre WhatsApp ou votre Instagram connecté : Setteo crée sa fiche et ouvre la conversation. L'**agent par défaut** du canal lui répond.

Vérifiez que vous avez un agent par défaut sur chaque canal. Voir [Configuration de l'agent](https://docs.setteo.io/agents/configuration.md).

## Créer un prospect à la main

Dans **Prospects**, cliquez sur **Nouveau prospect**. Renseignez au moins un nom, un identifiant, un e-mail ou un téléphone, puis cliquez sur **Créer le prospect**.

## Importer un fichier CSV

**1. Préparez le fichier**

Un fichier CSV de **20 Mo** au plus. La première ligne contient le nom des colonnes : prénom, nom, e-mail, téléphone…

Écrivez les numéros avec leur indicatif, par exemple `+33612345678`. Un numéro sans indicatif est lu avec le pays de votre espace.

**2. Chargez-le**

Dans **Prospects**, cliquez sur **Importer**, puis **Choisir un fichier** ou déposez-le.

**3. Associez les colonnes**

Setteo devine quelle colonne va dans quel champ. Corrigez si besoin, ou choisissez **Ne pas importer** pour ignorer une colonne.

**4. Réglez les options**

Dans **Options** :

* ajoutez des tags à chaque prospect importé, par exemple `import_salon_mars` ;
* cochez **Importer des variables depuis les colonnes CSV** pour garder d'autres colonnes comme variables du prospect. Le nom de la variable reprend celui de la colonne, en minuscules avec des tirets bas.

**5. Lancez l'import**

Cliquez sur **Lancer l'import**. Vous pouvez fermer la fenêtre : l'import continue.

<video autoPlay muted loop playsInline controls src="https://mintcdn.com/setteo-397937b0/j0YxzPTdh8p9gxnW/videos/live/import-csv.mp4?fit=max&auto=format&n=j0YxzPTdh8p9gxnW&q=85&s=c3686e80dbbe5a88ab642e93769c5672" />

Importer un fichier CSV avec un tag

À la fin, Setteo affiche le nombre de lignes importées et rejetées. **Télécharger les lignes rejetées** vous donne le fichier des lignes refusées, avec la raison de chaque rejet.

* Une ligne est **rejetée** si elle n'a ni nom, ni identifiant, ni e-mail, ni téléphone, ou si son téléphone est invalide.
* Un **e-mail invalide** est ignoré, mais le reste de la ligne est importé.

> [!WARNING]
>
> Un tag ajouté par import inscrit chaque prospect dans les scénarios **actifs** qui suivent ce tag. Importer une liste avec un tag suivi par un scénario actif y inscrit toute la liste, et peut déclencher des envois tout de suite. Vérifiez vos scénarios avant d'importer.

> [!NOTE]
>
> Un import ne coûte rien. Avec la formule À l'usage, un prospect n'est facturé que la première fois que votre agent lui répond.

## Par webhook

Votre outil de tunnel (Systeme.io, GoHighLevel, Kajabi, Make, n8n…) peut envoyer chaque nouvel inscrit à Setteo par webhook. Selon l'URL utilisée, le prospect est créé ou mis à jour, tagué, ou inscrit dans un scénario.

* Un scénario a son URL sur son bloc **Début du scénario**.
* Un tag a son URL sur sa fiche, dans la section **Webhook**.

Voir [Webhooks entrants](https://docs.setteo.io/integrations/webhooks-entrants.md).

## Par l'API

L'API publique crée, lit et modifie des prospects, et les inscrit dans un scénario. Il faut une clé API. Voir [Clés API](https://docs.setteo.io/integrations/cles-api.md) et la [référence de l'API](https://docs.setteo.io/api-reference/introduction.md).

## Par un outil de réservation

Calendly, iClosed, Momence et Custom One taguent vos prospects à chaque événement (appel réservé, annulé, absent…). Par défaut, ils ne taguent que les prospects déjà dans Setteo. Pour qu'ils en créent de nouveaux, réglez **Nouveaux prospects** sur **Créer le prospect** dans les paramètres de l'outil.

Voir [Outils de réservation](https://docs.setteo.io/integrations/outils-de-reservation.md).

## Les doublons

Setteo évite de créer deux fois le même prospect. Il cherche un prospect existant avant d'en créer un :

| Origine | Setteo cherche par |
| - | - |
| Message WhatsApp | l'identifiant WhatsApp, puis le téléphone |
| Import CSV | l'e-mail, puis le téléphone |
| Webhook | l'identifiant Setteo s'il est fourni, sinon le téléphone, puis l'e-mail |

* L'e-mail est comparé sans tenir compte des majuscules.
* À l'import, une cellule vide n'efface jamais ce que le prospect a déjà.
* Par webhook, les variables reçues remplacent celles de même nom ; les autres restent.

## Et ensuite

Vos prospects sont là. Retrouvez-les dans **Prospects**, filtrez-les, taguez-les ou inscrivez-les dans un scénario. Voir [Gérer vos prospects](https://docs.setteo.io/gerer/prospects.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.