# Campagnes Laissez l'agent appeler une liste de numéros selon un planning, avec relances, et journaliser chaque appel > Full REST + WebSocket API reference: https://api.happ.tools/reference Une **campagne** est un lot d'appels sortants par IA : l'agent compose les numéros de votre liste de clients avec son propre prompt, sa voix et son numéro de téléphone. Les appels partent dans les plages horaires que vous définissez, sont relancés en cas de non-réponse ou d'occupation, et chaque appel arrive dans **Historique** avec sa transcription et son enregistrement. Ouvrez-la depuis la barre latérale de l'agent : **Configurer** > **Campagnes**. ## Avant de commencer [#before-you-start] * L'agent dispose d'un **numéro de téléphone** activé et rattaché — voir [Numéros de téléphone](/docs/agents/phones). Sans numéro, la campagne se met en pause avec une erreur de configuration. * L'espace de travail a du **solde**. Les appels sont facturés comme un usage vocal normal ; quand le solde est épuisé, la campagne se met en pause et reprend après un rechargement. * Vous avez besoin d'un accès en écriture à **Appels** pour créer et lancer des campagnes. ## Créer une campagne [#create-a-campaign] **Nouvelle campagne** ouvre un assistant en trois étapes. **1. Bases** | Champ | Ce qu'il fait | | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nom de la campagne | Au moins 2 caractères, p. ex. « Réactivation de printemps » | | Agent | Fixé sur cet agent — son prompt, sa voix et sa langue servent aux appels | | Lignes | Nombre d'appels simultanés, 1–100 (1 par défaut — les numéros sont composés l'un après l'autre). Limité par votre forfait ; modifiable pendant que la campagne tourne | **2. Planning** | Champ | Ce qu'il fait | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | Fuseau horaire | L'horloge de la campagne pour les plages et les dates | | Date de début / Date de fin | Facultatif. Une fois la date de fin passée, la campagne se termine et tous ceux qui n'ont pas encore été joints sont marqués **Non joint** | | Plages d'appel | Heures de–à (les nouvelles plages valent 09:00–18:00 par défaut). Les appels ne partent qu'à l'intérieur. Sans plages, les appels partent à toute heure | **3. Relances et lancement** | Champ | Ce qu'il fait | | --------------- | ----------------------------------------------------------------------- | | Tentatives max | 1–10 (3 par défaut). Au-delà, le numéro est marqué comme non joint | | Mode de relance | **Immédiatement**, **Après N minutes** (1–1440) ou **Fenêtre suivante** | | Relancer si | **Pas de réponse**, **Occupé**, **Échouée** — tous activés par défaut | **Créer la campagne** l'enregistre comme **Brouillon** et ouvre **Sources** — d'où viennent les numéros. ## Ajouter des numéros [#add-numbers] Une campagne obtient ses numéros d'une ou plusieurs sources : | Source | Fonctionnement | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Liste collée | Un numéro par ligne, ou CSV avec `,` ou `;`. La première colonne est le téléphone ; les autres colonnes deviennent des variables d'appel (nommées par la ligne d'en-tête, sinon `var1…varN`) que l'agent peut utiliser dans son prompt. Jusqu'à 10 000 numéros par import ; les numéros invalides et les doublons sont écartés | | Sélection CRM | Conditions sur KeyCRM, NetHunt ou SalesDrive avec aperçu en direct. S'exécute immédiatement, puis à intervalle ou selon un planning, en ignorant les numéros appelés au cours des N derniers jours | | Événement CRM | Copiez l'URL du webhook dans votre CRM ; chaque événement ajoute un numéro. Filtre d'étape facultatif — n'appeler qu'à une étape donnée de l'affaire. Une telle campagne ne se termine jamais d'elle-même | | Google Sheet | Partagez la feuille avec l'e-mail du compte de service affiché par Happ, collez le lien, choisissez l'onglet et la colonne du téléphone, associez les autres colonnes à des variables du prompt | ``` +380991234567 phone,name,city +380991234568,Anna,Kyiv ``` ## La lancer [#run-it] Rien n'est composé tant que la campagne est en **Brouillon** — appuyez sur **Lancer la campagne**. | Statut | Actions | | ------------------ | ------------------------------ | | Brouillon | Lancer la campagne, Supprimer | | En cours | Suspendre, Annuler la campagne | | Suspendu | Reprendre, Annuler la campagne | | Terminée / Annulée | Supprimer | * **Suspendre** arrête les nouveaux appels ; les appels déjà transmis au fournisseur peuvent encore aboutir. * **Annuler** annule tous les numéros en attente et est irréversible. * Les paramètres ne sont modifiables qu'en **Brouillon** ou **Suspendu** ; **Lignes** peut aussi être modifié pendant l'exécution (pris en compte en 20 secondes environ). * Happ met lui-même en pause une campagne en cours en cas de **Solde insuffisant** ou d'**Erreur de configuration** (pas de téléphone, téléphone désactivé). Corrigez la cause et appuyez sur **Reprendre**. ## Résultats [#results] * **Aperçu** — progression et compteurs : total, en file d'attente, en numérotation, joints, injoignables, annulés. * **Contacts** — chaque numéro avec son statut (**En attente**, **Numérotation**, **Joint**, **Non joint**, **Annulée**), les tentatives utilisées, le dernier résultat et la prochaine tentative. * **Historique des tentatives** — cliquez sur un numéro pour voir le résultat de chaque tentative (**Connecté**, **Pas de réponse**, **Occupé**, **Échouée**, **Non composé**) et **Ouvrir l'appel** pour la transcription et l'enregistrement. **API :** [api.happ.tools/reference](https://api.happ.tools/reference) ## Ensuite [#next] * [Numéros de téléphone](/docs/agents/phones) — rattachez le numéro depuis lequel l'agent appelle * [Voix](/docs/agents/voice) — comment l'agent sonne et parle * [Analyse](/docs/workspace/analysis) — évaluez les appels de la campagne avec un moniteur