# Campagnes Callbot

Le module de **campagnes d’appel sortant Callbot** du BMS permet d’automatiser et de piloter des campagnes d’appels téléphoniques sortants, grâce à un callbot capable de dialoguer avec les destinataires selon des scénarios personnalisés. Cette fonctionnalité offre un large éventail de possibilités pour organiser, suivre et analyser les campagnes, depuis la création de la campagne jusqu’à l’exploitation des résultats.

La documentation ci-dessous détaille l’ensemble des fonctionnalités liées aux campagnes d’appel sortant : création, configuration, gestion des contacts, suivi des performances, et exploitation des rapports.

{% hint style="warning" %}
À ce jour, la gestion et la mise en place des campagnes d’appel sortant Callbot ne peuvent être réalisées que par l’équipe Dydu.

Si vous souhaitez déployer une campagne d’appel, merci de vous rapprocher de Dydu pour toute demande de création, de paramétrage ou d’assistance.
{% endhint %}

## Mise en place de la campagne

### **Création d’une nouvelle campagne**

Pour créer une campagne d’appel sortant Callbot, suivez les étapes ci-dessous :

1. Accédez au menu **Intégrations** **>** **Campagnes Callbot**.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FYsAFBxbh4pHKaOfjpCpC%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2016-28-47.png?alt=media&#x26;token=1695af77-4769-4746-be98-5f9c432e057c" alt=""><figcaption></figcaption></figure>

2. Cliquez sur la modale **Mes Campagnes** pour initier la création d’une nouvelle campagne.
3. Une fenêtre de création s’affiche : renseignez le **nom de la campagne** souhaité, puis cliquez sur **Créer**.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FcjBMqVHbPL1qmYwW9Z7q%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2016-29-21.png?alt=media&#x26;token=074e4af1-49ce-428c-a86b-9ab6d6c8233d" alt="" width="563"><figcaption></figcaption></figure>

4. La page de configuration des paramètres de la campagne s’ouvre automatiquement, vous permettant de poursuivre la personnalisation de votre campagne.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FSqVWJFmKDedfg6XuM0dx%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2016-29-57.png?alt=media&#x26;token=04856d13-e067-4aa5-9cbc-fee0aadc8659" alt="" width="563"><figcaption></figcaption></figure>

## Présentation des différents composants

### Paramètres

#### Paramètres généraux de la campagne

La section **Paramètres généraux de la campagne** permet de configurer les principaux réglages opérationnels de votre campagne d’appel sortant Callbot.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FA6oQi371vjn3D2YwiZrX%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2016-54-16.png?alt=media&#x26;token=8d9d4316-2b2c-4309-a233-ccaab368b40b" alt="" width="375"><figcaption></figcaption></figure>

Les différents paramètres sont :

* **Activer / désactiver la campagne**
  * Permet de rendre la campagne active ou inactive.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FPuZ5qcktB6vx2eFndIHe%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2016-55-23.png?alt=media&#x26;token=cd6d7e6a-8216-43c1-9298-0b428b9d2247" alt="" width="485"><figcaption></figcaption></figure>

{% hint style="info" %}
Pour activer la campagne, il est nécessaire d’avoir configuré au minimum un [créneau d’appel](#calendrier-dappels), d’avoir sélectionné une instance Callbot, et d’avoir défini au moins une [règle de succès](#regles-de-succes).
{% endhint %}

* **Choisir une instance Callbot**
  * Sélectionne l’instance Callbot à utiliser pour la campagne.\
    Les instances affichées correspondent à celles configurées dans le menu [**Canaux**](https://docs.dydu.ai/integrations/canaux) du BMS.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FtumK9D82aygtFzaZNwCL%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2016-55-53.png?alt=media&#x26;token=8eb9643b-d842-464f-a57b-7c7b27935535" alt="" width="541"><figcaption></figcaption></figure>

{% hint style="info" %}
Si aucune instance Callbot n’est sélectionnée, il ne sera pas possible de modifier les paramètres associés à la campagne (nombre d’appels simultanés, nombre d’appels maximum par contact, durée minimale entre deux appels, gestion des répondeurs).

Veillez à sélectionner une instance Callbot pour accéder à l’ensemble des options de configuration.
{% endhint %}

* **Options d’appels :**
  * **Nombre d’appels simultanés autorisés** : définit combien d’appels peuvent être passés en même temps par le Callbot (de 1 à 50).
  * **Nombre d’appels maximum par contact** : précise le nombre maximal de tentatives d’appel pour chaque contact (de 1 à 4).
  * **Durée minimale entre deux appels pour un même contact** : détermine le délai minimal avant de rappeler un contact après un premier échec (de 0 à 24 heures).

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FT5tSUe84aA4rsWXArU7V%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2016-57-07.png?alt=media&#x26;token=8ec5c87d-cfea-4155-8a96-71c6d6e08f9e" alt="" width="556"><figcaption></figcaption></figure>

* **Gestion des répondeurs**
  * Active ou désactive la possibilité de laisser un message sur répondeur.\
    Si cette option est activée, vous pouvez configurer une connaissance spécifique que le Callbot utilisera pour délivrer le message vocal.\
    Il est important de **valider la connaissance sélectionnée** en cliquant sur la coche de validation. Pour supprimer la connaissance associée, il suffit de cliquer sur l’icône croix.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FmRYdWRkpYej1dd3qOsIy%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2016-58-39.png?alt=media&#x26;token=c8f9ea8d-c467-448f-a2e1-1a4d239cb8d8" alt="" width="534"><figcaption></figcaption></figure>

#### Correspondance entre fichier de contacts et variable Dydu

La section **Correspondance entre fichier de contacts et variable Dydu** permet d’associer les colonnes de votre [fichier de contacts](#import-massif-de-contacts-via-un-fichier) aux différentes variables exploitées par le Callbot lors de la campagne.

{% hint style="info" %}
Seuls les fichiers au format EXCEL (.xls, .xlsx) ou CSV (.csv) sont acceptés pour l’import des contacts.
{% endhint %}

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FLQo8rTsP7pgXXUQAExDU%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2017-04-19.png?alt=media&#x26;token=dbe598c6-f826-4162-a3d6-f45c7c2b3741" alt="" width="563"><figcaption></figcaption></figure>

Il est obligatoire de définir la correspondance pour la variable **Num\_Tel**, qui doit pointer vers la colonne du fichier contenant le numéro de téléphone du contact à appeler. Cette variable ne peut pas être supprimée, mais uniquement modifiée.

{% hint style="info" %}
Sans cette correspondance, il sera impossible d'ajouter un fichier de contacts à votre configuration.
{% endhint %}

Vous pouvez ajouter autant de correspondances que nécessaire pour enrichir les informations transmises au Callbot.&#x20;

Cependant, si une erreur se glisse dans le nom d’une colonne (colonne inexistante ou mal orthographiée), aucune erreur ne sera affichée : la donnée ne sera tout simplement pas prise en compte lors de l'ajout de contact.

Pour gérer les correspondances dans votre configuration, procédez comme suit :

1. Cliquez sur le bouton **« Ajouter une correspondance »**.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FEAXQWtYYkm5ytgKXmkp0%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2017-21-20.png?alt=media&#x26;token=16544e60-2ff1-4cd4-b4c9-38c647bbc943" alt="" width="224"><figcaption></figcaption></figure>

2. Indiquez le **nom de la variable de conversation** et le **nom de la colonne dans le fichier** ; les deux champs sont obligatoires.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FSnZaaavsNQOD3tklmROx%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2017-22-25.png?alt=media&#x26;token=9f07093d-fe5d-436e-bb51-a358cbe8ead4" alt="" width="542"><figcaption></figcaption></figure>

3. Cliquez sur la **coche** pour valider l’ajout, ou sur la **croix** pour annuler l'ajout.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FTzQcA7LB9LSQJ21maWbm%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-30%2017-25-08.png?alt=media&#x26;token=acec7ff3-a733-478f-b214-633038523c08" alt="" width="375"><figcaption></figcaption></figure>

4. Pour modifier une correspondance existante, cliquez sur l’icône **crayon** puis éditez les champs souhaités.
5. Pour supprimer une correspondance, cliquez sur le bouton **corbeille** correspondant à la ligne à supprimer.

#### Calendrier d'appels

La gestion des **inclusions** et **exclusions** de dates permet de définir précisément les périodes pendant lesquelles la campagne d’appel sortant peut être active, ainsi que celles pendant lesquelles les appels ne doivent pas être passés. Grâce à cette fonctionnalité, il est possible de planifier finement l’activité du Callbot en spécifiant des créneaux autorisés ou interdits selon les besoins de la campagne (par exemple, en excluant les jours fériés ou en ciblant uniquement certaines plages horaires).

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2F6sVDwYREPEU8daw6r13c%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-31%2016-39-12.png?alt=media&#x26;token=d1a64cb1-60e7-422a-979e-a379f6fdfbcf" alt=""><figcaption></figcaption></figure>

Pour définir une inclusion ou une exclusion dans votre campagne, suivez les étapes suivantes :

1. Cliquez sur le bouton **« Ajouter une inclusion »** ou **« Ajouter une exclusion »**. Le fonctionnement d’ajout est identique pour les deux options.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2F8LXKRUepUrX7wv4tmL70%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-31%2016-46-02.png?alt=media&#x26;token=5274ee66-1393-4d43-9722-7ec68591a716" alt="" width="375"><figcaption></figcaption></figure>

2. Choisissez si vous souhaitez inclure/exclure un **jour de la semaine** ou une **date précise**.

> * **Pour un jour de la semaine** : sélectionnez le jour souhaité parmi les options proposées ; le dimanche est exclu par défaut pour respecter la réglementation.
>
> <p align="center"><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2Fc09bhSqGpb6f8Ef0CVg8%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-31%2016-50-20.png?alt=media&#x26;token=c0f0b515-965e-4584-ae8b-9eeb57c8a52e" alt="" data-size="original"></p>
>
> * **Pour une date précise** : sélectionnez la date souhaitée directement dans le calendrier.
>
> <p align="center"><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FTawHBjPbNsN3zHJhMa1S%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-31%2016-51-38.png?alt=media&#x26;token=21e39eac-94ea-4f3e-9443-05024f6e7232" alt="" data-size="original"></p>

3. Indiquez les **horaires** sur lesquels cette inclusion ou exclusion doit s’appliquer.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FH03wmSR2thYeW4KO0sPJ%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-31%2016-52-46.png?alt=media&#x26;token=5bc2e0a5-9e0e-465d-960d-c8a76d1a67ed" alt="" width="211"><figcaption></figcaption></figure>

4. Cliquez sur **Enregistrer** pour valider l’ajout, ou sur **Supprimer cette règle** pour annuler.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FgZYULm3KlHMBRU9fN9Up%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-31%2016-53-26.png?alt=media&#x26;token=55fcd6ba-b75f-4fe9-915e-efcdcdc174df" alt="" width="375"><figcaption></figcaption></figure>

Les inclusions et exclusions ajoutées sont affichées dans un tableau récapitulatif. Ce tableau indique, pour chaque ligne, le jour de la semaine ou la date précise concernée, le type de règle (inclusion ou exclusion) sous forme de tag, ainsi que les horaires associés.

Pour supprimer une règle, il suffit de cliquer sur l’icône **corbeille** à droite de la ligne correspondante.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2F8tXa0Mf3gfpsxArg92JT%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-31%2016-55-59.png?alt=media&#x26;token=aaca5c67-67b1-4a0b-8909-da49b5fe5188" alt="" width="374"><figcaption></figcaption></figure>

#### Règles de succès

Les **règles de succès** permettent de définir les conditions à remplir pour qu’une conversation, dans le cadre d’une campagne d’appel sortant, soit considérée comme réussie. Grâce à ces règles, il est possible de personnaliser précisément les critères de réussite selon les objectifs fixés pour chaque campagne.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FcOzdBHxhVMA3CEG1hKtz%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-31%2017-05-56.png?alt=media&#x26;token=dea0536d-7ed7-4667-8067-b799b240e673" alt=""><figcaption></figcaption></figure>

Pour gérer les règles de succès dans votre campagne, procédez comme suit :

1. Cliquez sur le bouton **« Ajouter une règle »**.
2. Renseignez le **nom de la condition** (par exemple : `callbot_call_duration_seconds`).
3. Sélectionnez un **opérateur de comparaison** dans la liste proposée, puis saisissez la **valeur** souhaitée.
4. Cliquez sur la **coche** pour valider l’ajout, ou sur la **croix** pour annuler.
5. Pour modifier une règle existante, cliquez sur l’icône **crayon**. Pour supprimer une règle, cliquez sur l’icône **corbeille** correspondante.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2F15tPc1vFldpCO9NmO3hI%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-07-31%2017-15-38.png?alt=media&#x26;token=50f5cb81-a6ce-4ca8-a79b-20283056251b" alt=""><figcaption></figcaption></figure>

### Contacts

#### Import massif de contacts via un fichier

L’import massif permet d’ajouter plusieurs contacts à une campagne en une seule opération, à partir d’un fichier externe.\
Seuls les formats **`.csv`**, **`.xls`** et **`.xlsx`** sont acceptés.

Sans correspondance définie pour la colonne **Num\_Tel** dans le tableau de correspondance, il sera **impossible** d’importer un fichier. Cette colonne doit obligatoirement pointer vers le numéro de téléphone de chaque contact.

Les autres variables renseignées dans le tableau de correspondance ne sont pas obligatoires : si elles ne figurent pas dans le fichier importé, elles seront simplement ignorées lors de l’import.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FIhdlk2mdHlW3d01OhOKI%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-08-11%2010-48-32.png?alt=media&#x26;token=04dda43a-ddbd-4207-a82c-c55ebef7d50c" alt=""><figcaption></figcaption></figure>

Pour importer le fichier de contact, il faut :

* Cliquez sur le bouton **« Sélectionner le fichier à importer »** et choisissez votre fichier au format `.csv`, `.xls` ou `.xlsx`.
* Une fois le fichier importé, le **nombre de contacts ajoutés** s’affiche à l’écran.
* Un bouton supplémentaire **« Supprimer tous les contacts »** apparaît alors.

{% hint style="warning" %}
Ce bouton supprime **l’intégralité** des contacts importés. Il n’existe pas, à ce jour, de fonction permettant de supprimer des contacts individuellement.
{% endhint %}

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FQYT2z9H24DN3xOntbJAQ%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-08-11%2010-52-18.png?alt=media&#x26;token=7372751c-258c-45af-8538-7b1345b69bec" alt=""><figcaption></figcaption></figure>

#### Ajout de contacts via API : vous consommez l'API Dydu

Cette section permet d’ajouter un contact à une campagne par appel API. Un **exemple de requête cURL** est affiché dans l’interface ; complétez simplement les champs requis avant l’envoi.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FKW7nKQx8YSykNqO10M6w%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-12-16%2011-00-03.png?alt=media&#x26;token=b4bcc887-ec0c-4983-928c-d65446ee0c72" alt=""><figcaption></figcaption></figure>

**Champs et éléments à renseigner :**

* **`phoneLine` (obligatoire)** : le **numéro de téléphone** du contact à ajouter.
* **`content.inputVariables` (optionnel)** : les **variables de conversation Dydu** à associer au contact sous forme de paires **clé/valeur** (la **clé** est le nom de la variable Dydu, la **valeur** est son contenu pour ce contact).
* **Token d’**`Authorization` **(obligatoire)** : récupérez un **jeton Bearer** dans **Préférences > API > Accès aux APIs**, puis utilisez-le dans l’en-tête `Authorization: Bearer <token>`.

Cette API peut être appelée depuis un **script** pour **ajouter automatiquement un grand nombre de contacts** en se connectant à une **base de données** (ex. PostgreSQL) et en envoyant une requête par contact.

### Suivi d'activité de la campgne

#### Statistiques générales de la campagne

La section **Statistiques générales** permet d’obtenir un aperçu rapide des principaux indicateurs de performance d’une campagne d’appel sortant :

* **Nombre de contacts** : total de contacts actuellement présents dans la configuration de la campagne.
* **Nombre d’appels réalisés** : total des appels passés par le Callbot dans le cadre de cette campagne.
* **Taux de joignabilité** : pourcentage obtenu en divisant le nombre d’appels décrochés par le nombre total d’appels réalisés.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2F8sbM6vPdRr6bre4D2jaU%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-08-11%2011-37-55.png?alt=media&#x26;token=831dcf04-a8b2-4cb0-8743-324a668f06d2" alt=""><figcaption></figcaption></figure>

Pour accéder à des indicateurs plus détaillés ou spécifiques, il est possible de créer un rapport personnalisé dans le menu **Statistiques personnalisées > Configuration > Rapports**.

#### Statistiques par contact

Cette section permet de consulter, pour chaque contact présent dans la configuration de la campagne, un ensemble d’informations détaillées sur les appels effectués.

<figure><img src="https://1101559743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgMQl4578l4DzuAEhrEii%2Fuploads%2FrimdapU8JxewJL0Owd9e%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-08-11%2011-53-31.png?alt=media&#x26;token=7f2e0571-6610-4fca-a18c-438fe9a48e24" alt=""><figcaption></figcaption></figure>

Une **barre de recherche** est disponible pour retrouver rapidement un contact à partir de son **numéro de téléphone** (ce champ ne filtre pas sur d’autres données).

Pour chaque contact, les informations suivantes sont affichées :

* **Nombre d’appels réalisés** pour ce contact.
* **Date du dernier appel** passé à ce contact.
* **Lien vers la dernière conversation** de ce contact.
* **Variables alimentées pendant la conversation**, avec possibilité d’en voir davantage en cliquant sur le bouton **« info »**.
* **Statut du contact**, parmi les cinq possibles :
  * **À appeler**
  * **Appel en cours**
  * **Appels après succès**
  * **Succès**
  * **Échec**

Il est également possible d’exporter l’ensemble des contacts et leurs appels dans un fichier Excel en cliquant sur le bouton **« Exporter contacts et appels (Excel) »**.