--- title: "Campagnes sortantes" description: "Importez une liste de contacts et laissez un agent la traiter — avec des plages d'appel, des nouvelles tentatives et un suivi en direct." --- Les campagnes appellent une liste de contacts pour vous : choisissez un agent vocal, importez un CSV, définissez les périodes où les appels sont autorisés, et ThunderPhone parcourt la liste — en relançant les appels sans réponse et les messageries vocales selon le planning de votre choix. Retrouvez-les dans **Engagement → Campagnes** (`/dashboard/campaigns`). Pour des appels ponctuels par programmation, utilisez plutôt l’ [API d’appels sortants](/fr/guides/place-outbound-calls). ## Prérequis - Un agent vocal déployé. - Un numéro de téléphone activé pour les appels sortants. Les numéros VoIP des clients continuent de prendre en charge les campagnes. Les numéros ThunderPhone sont initialement limités aux appels entrants ; un administrateur de l’organisation peut demander l’activation des appels sortants depuis la page Numéros de téléphone. ThunderPhone examine chaque demande manuellement, et les numéros approuvés peuvent lancer des campagnes. Consultez [Connecter un fournisseur VoIP](/fr/guides/voip-providers). - Des contacts sous forme de fichier CSV (ou de JSON collé) avec une colonne `phone` ou `phone_number`. **Jusqu’à 5 000 lignes par import**, encodées en UTF-8. Les nouveaux imports JSON doivent être plats : les valeurs supplémentaires peuvent être des chaînes, des nombres, des booléens ou `null`. Les lignes contenant des tableaux ou des objets imbriqués sont rejetées individuellement avec un message de validation ; les lignes valides sont tout de même importées. Les cellules CSV sont des chaînes. Les colonnes supplémentaires acceptées sont conservées comme variables par contact dans les fiches de contact de la campagne et fournies automatiquement à chaque appel. ThunderPhone classe également le prompt de l’agent enregistré avant chaque appel sortant afin de déterminer si l’agent doit naviguer dans un menu téléphonique. Les en-têtes tels que `name` et `account_id` correspondent à `{{name}}` et `{{account_id}}` dans le prompt de l’agent enregistré. Le mappage des noms peut également combiner des colonnes dans `name`. Consultez [variables par appel](/fr/guides/call-variables) pour les valeurs par défaut, les règles de nommage, la limite d’objet de 32 KB et les valeurs renvoyées dans les webhooks de fin d’appel. Les anciennes fiches de contact peuvent contenir des métadonnées imbriquées provenant d’imports JSON antérieurs. Ces métadonnées restent associées au contact enregistré. Chaque appel omet les valeurs non scalaires de sa charge utile de variables et consigne les noms de clés ignorées pour cette tentative, sans consigner les valeurs. Les relances utilisent le même filtrage. ## Créer une campagne Nommez-la, sélectionnez l’**agent vocal**, puis choisissez le **numéro d’appel** (l’un de vos numéros activés pour les appels sortants). Les lignes contenant un numéro de téléphone ou des variables invalides sont rejetées individuellement et signalées avec leur numéro de ligne — les autres sont importées correctement. Choisissez un **fuseau horaire** et une plage **de début/fin quotidienne** ; la campagne ne compose des numéros qu’à l’intérieur de cette plage. Le fuseau horaire est d’abord celui de votre numéro d’appel (son indicatif régional aux États-Unis et au Canada, son pays ailleurs) ou, pour les numéros couvrant plusieurs fuseaux comme les numéros gratuits, celui de votre navigateur. L’indication sous le champ précise lequel. La plage est définie par défaut de 9 h à 17 h. Une plage commençant avant 8 h ou se terminant après 21 h affiche un avertissement : les appels en dehors de ces heures peuvent enfreindre les règles relatives aux heures d’appel, telles que celles de la TCPA. Une fin antérieure au début traverse minuit : 22:00 → 02:00 compose de 22 h à 2 h le lendemain, avec un avertissement. La plage s’applique dans le fuseau horaire de la campagne, et non dans celui de chaque contact ; répartissez donc les contacts par fuseau horaire lorsqu’ils sont dispersés. Vous pouvez également définir une **date de début** pour planifier le lancement et une **date de fin** après laquelle la campagne se termine automatiquement. - **Appels simultanés** — nombre d’appels exécutés simultanément par cette campagne (1–10, 3 par défaut). Les campagnes ne lancent aucun nouvel appel tant que votre organisation compte 10 appels sortants en cours ; les campagnes parallèles partagent donc ce quota. Chaque appel compte également dans la [limite d’appels simultanés](/api-reference/introduction#call-limits) de votre organisation (20 par défaut, pour les appels entrants, sortants, web et de test). Lorsque cette limite est atteinte, ou si le même numéro a été appelé au cours des 10 dernières secondes, le contact attend simplement un passage ultérieur ; ses tentatives ne sont pas consommées. - **Nombre maximal de tentatives** — nombre de fois que chaque contact peut être appelé (1–10, 2 par défaut). - **Délai avant nouvelle tentative (minutes)** — attente avant une nouvelle tentative (au moins 30, 60 par défaut). - **Réessayer en cas de** — résultats déclenchant une nouvelle tentative : **sans réponse**, **messagerie vocale**, **échec** (tous activés par défaut). Besoin de plus de tentatives ou d’un délai plus court ? Contactez l’assistance : son équipe peut augmenter les deux limites pour votre organisation. Les campagnes sont créées sous forme de brouillons — les contacts ne peuvent être ajoutés que lorsqu’une campagne est un brouillon. Le démarrage d’une campagne nécessite un consentement explicite aux frais d’appel. Avec une **date de début** future, elle devient *planifiée* ; sinon, elle démarre *en cours* immédiatement. Les campagnes enregistrées avant ces limites continuent de s’exécuter exactement selon leur configuration. Leurs tentatives et leurs délais restent enregistrés malgré les autres modifications. ## Fonctionnement des résultats et des tentatives Après chaque appel, le contact reçoit un résultat — les appels réussis sont marqués comme terminés ; un appel évalué comme sans réponse, détecté comme messagerie vocale ou ayant échoué est relancé si ce résultat figure dans votre liste **réessayer en cas de** et si le contact dispose encore de tentatives. Les contacts qui n'ont plus de tentatives sont marqués comme *épuisés* ; les échecs non réessayables sont marqués comme *échoués*. La numérotation se met automatiquement en pause tant que le solde de votre compte n'est pas en règle, puis reprend dès qu'il l'est. Gardez la [recharge automatique](/fr/guides/billing-and-topups) activée pour les campagnes longues. ## Surveiller et contrôler Chaque carte de campagne affiche son statut et sa progression (par ex. « 173 sur 248 terminés »). Ouvrez une campagne pour consulter la répartition des statuts, les résultats par contact et les appels récents — chacun renvoie vers la transcription complète et l'enregistrement dans l'historique des appels. - **Mettre en pause / reprendre** — la mise en pause empêche les nouveaux appels ; les appels déjà en cours se terminent naturellement. Les campagnes en pause peuvent être modifiées et reprises. - **Annuler** — arrête définitivement la campagne. - Une campagne se termine automatiquement lorsque chaque contact atteint un état final ou que l'heure **fin à** est dépassée. Statuts de campagne : `draft`, `scheduled`, `running`, `paused`, `completed`, `cancelled`. Statuts de contact : `pending`, `scheduled`, `calling`, `completed`, `failed`, `exhausted`. ## Étapes suivantes Écoutez les appels de campagne au moment où ils ont lieu. Lancez des appels individuels par programmation.