# Campaigner

Le Campaigner vous permet de créer et gérer des campagnes d'appels sortants automatisées : planifiez des appels en masse vers vos listes de contacts et laissez vos agents IA configurés les dérouler.

> **Prérequis:** Votre plan doit inclure les [appels sortants](https://docs.voicelogica.ai/fr/outbound-calls/), il vous faut au moins un [agent IA](https://docs.voicelogica.ai/fr/getting-started/your-first-agent/) et un [téléphone ou SIP trunk](https://docs.voicelogica.ai/fr/telephony/introduction/) pour appeler vers l'extérieur — la page Campaigns vous indique s'il manque encore un SIP trunk ou un agent.
## Créer une campagne

1. **Démarrez une nouvelle campagne**

   Ouvrez la [page Campaigns](https://app.voicelogica.ai/campaigns) et cliquez sur **"New Campaign"**.

     ![Page Campaigns](https://docs.voicelogica.ai/assets/outbound-calls/campaign-list.png)

2. **Configurez les bases**

   Donnez à la campagne un **nom** descriptif (et une description facultative), choisissez l'**agent IA** qui mènera la conversation — ses prompts et sa voix s'appliquent à chaque appel — et le **téléphone** utilisé pour passer les appels, qui est l'identifiant d'appelant vu par les destinataires. La plupart des champs ont des valeurs par défaut raisonnables, ajustables plus tard.

3. **Définissez les propriétés d'analyse**

   Les **Agent Analysis Properties** définissent quelles données structurées sont extraites de chaque appel répondu — cliquez sur **Manage Properties** pour personnaliser les points de données. Les résultats apparaissent dans les analyses de la campagne.

     ![Propriétés d'analyse de l'agent](https://docs.voicelogica.ai/assets/outbound-calls/agent-analysis-properties.png)

4. **Configurez les nouvelles tentatives et le planning**

   Réglez le **nombre maximal de tentatives** et le **délai entre tentatives** pour les appels sans réponse. Sur l'onglet **Schedule**, définissez le rythme (intervalle **"Run next calls in campaign every"**), le **fuseau horaire** (par défaut celui de votre entreprise) et un ou plusieurs **jours planifiés**, chacun avec ses heures d'activité (format 24 heures, p. ex. 09:00–20:00). Les appels ne sont passés qu'à l'intérieur de ces fenêtres — pour rester conforme et appeler à des heures locales raisonnables.

     ![Planning de la campagne](https://docs.voicelogica.ai/assets/outbound-calls/campaign-schedule.png)

> **Les campagnes ne tournent qu'en statut Active:** Une campagne démarre en **Draft** (brouillon). Passez son statut à **Active** pour que les appels commencent — vous pouvez la mettre en **Pause** à tout moment, et elle se termine automatiquement quand la liste est épuisée.
## Ajouter des leads

Une fois la campagne enregistrée, ajoutez les contacts que votre agent appellera. Le chemin le plus rapide est le modèle Google Sheets :

1. **Ouvrez le modèle et faites votre copie**

   Dans la section **Leads** de la campagne, cliquez sur **"Open Template"**, puis dans Google Sheets cliquez sur **"USE TEMPLATE"** pour le copier dans votre propre Drive.

     ![Ajouter de nouveaux leads](https://docs.voicelogica.ai/assets/outbound-calls/new-leads.png)
     ![Utiliser le modèle](https://docs.voicelogica.ai/assets/outbound-calls/use-template.png)

2. **Remplissez vos colonnes**

   Les colonnes **`phone`** et **`email`** du modèle sont requises — ne les supprimez pas. Tout le reste vous appartient : retirez `client_name`/`client_last_name` si vous ne les utilisez pas, ou ajoutez des colonnes personnalisées (`company`, `appointment_date`, `previous_interaction`, …) — chaque colonne personnalisée devient une **variable dynamique** que votre agent peut utiliser.

     ![Colonnes du modèle](https://docs.voicelogica.ai/assets/outbound-calls/leads.png)

3. **Copiez les lignes — y compris la ligne d'en-tête**

   Sélectionnez vos leads **avec la première ligne** (les noms de colonnes) et copiez.

     ![Copier les leads avec l'en-tête](https://docs.voicelogica.ai/assets/outbound-calls/copy-leads.png)

4. **Collez dans Voice Logica et confirmez**

   Collez dans la zone des leads, vérifiez le tableau d'aperçu et cliquez sur **"Add Leads"**. Les leads apparaissent dans le tableau de la campagne, prêts à être appelés selon le planning.

     ![Coller les leads](https://docs.voicelogica.ai/assets/outbound-calls/paste-leads.png)
     ![Vérifier et ajouter les leads](https://docs.voicelogica.ai/assets/outbound-calls/add-leads.png)
     ![Tableau des leads de la campagne](https://docs.voicelogica.ai/assets/outbound-calls/campaign-leads.png)

## Personnaliser les appels avec des variables dynamiques

Vos colonnes de leads personnalisées deviennent des **variables dynamiques** pour les instructions de l'agent — chaque appel reçoit automatiquement les valeurs du lead concerné :

```
You are calling {{client_name}} {{client_last_name}} about their {{appointment_date}} appointment.
```

Les variables disponibles s'affichent dans l'interface de la campagne après l'import des leads.

  ![Variables dynamiques dans les instructions de l'agent](https://docs.voicelogica.ai/assets/outbound-calls/calling-lead.png)

## Consulter les résultats

Après un appel répondu, les propriétés d'analyse sont remplies avec les données extraites de la conversation — les appels sans réponse suivent quant à eux vos réglages de nouvelles tentatives.

  ![Résultats d'analyse après un appel](https://docs.voicelogica.ai/assets/outbound-calls/after-call.png)

Pour ajuster **ce qui** est extrait, ouvrez l'éditeur de l'agent et allez dans **After the call → Call results** — les propriétés d'analyse configurées là pilotent l'extraction.

## Dépannage

**Ma campagne ne passe aucun appel**

- Le statut doit être **Active** — un Draft ne tourne jamais.
- Vérifiez que vous êtes dans une fenêtre de jour/heure planifiée (et le bon fuseau horaire).
- Vérifiez que le plan inclut les appels sortants et que votre compte télécom a des crédits.

**Les propriétés d'analyse reviennent vides**

Les propriétés ne sont extraites que des appels **répondus**. Pour des appels répondus avec des résultats vides, revoyez les définitions des propriétés sous l'onglet **After the call → Call results** de l'agent.
