---
title: Règles entrantes et groupes
excerpt: Créez une règle entrante par file ou SDA, partagez des plannings avec les groupes de règles, modifiez en masse et importez ou exportez vos règles.
order: 2
---

## Règles entrantes

Une règle entrante est ce que votre call flow interroge. Elle représente un point d’entrée de votre IPBX (une file d’attente ou une SDA) et porte les [plages horaires et exceptions](/fr/docs/smart-routings/opening-hours) qui décident où vont les appels.

Allez dans **Routages** > **Règles entrantes** et cliquez sur **Ajouter une règle**.

| Champ | Description |
|---|---|
| **Nom** | Obligatoire. Le call flow peut s’en servir pour identifier la règle (`queue_name`). |
| **PBX** | Obligatoire. L’un des IPBX 3CX connectés à votre compte. |
| **Type de ressource associée à la règle entrante** | **File** ou **SDA**. |
| **Ressource associée à la règle entrante** | Pour une file : le numéro de la file (`queue_number` dans le lookup). Pour une SDA : une SDA choisie dans l’IPBX. |
| **Type de destination par défaut** / **Destination par défaut** | Facultatif. Enregistré avec la règle et inclus dans les exports. |
| **Groupe de règles** | Facultatif. La règle suit alors le planning du groupe (voir plus bas). |
| **Code** | Code libre facultatif, pour votre propre usage. |
| **Actif** | Seules les règles actives répondent aux lookups. Une règle inactive renvoie `404`. |

> [!WARNING]
> La destination par défaut n’est **pas** renvoyée par le lookup. Quand aucune plage horaire ni exception ne correspond, le lookup répond `404` : votre call flow doit prévoir sa propre route de repli pour ce cas.

Cliquez sur une règle pour l’ouvrir : sa page affiche les tableaux des **plages horaires** et des **exceptions**.

Supprimer une règle supprime aussi ses plages horaires et ses exceptions, y compris quand vous supprimez plusieurs règles à la fois, depuis la liste ou via l’API.

### Modification en masse

Sélectionnez plusieurs règles dans la liste et utilisez **Modifier la sélection** pour changer en une fois :

- **Actif**
- **Type de destination par défaut**
- **Destination par défaut**

Les champs laissés sur *Ne pas modifier* restent inchangés. La suppression en masse est aussi disponible.

## Groupes de règles

Un groupe de règles est un **modèle de planning** partagé par plusieurs règles entrantes. Cas typique : toutes les files d’un site partagent les mêmes horaires et les mêmes jours fériés.

1. Allez dans **Routages** > **Groupes de règles** et cliquez sur **Ajouter un groupe de règles**.
2. Sur la page du groupe, ajoutez les plages horaires et les exceptions (sans destination au niveau du groupe).
3. Sur chaque règle entrante, choisissez le groupe dans le champ **Groupe de règles**.

### Fonctionnement de l’héritage

Quand une règle rejoint un groupe, chaque plage horaire et chaque exception du groupe est copiée sur la règle sous forme de **ligne héritée**. Toute modification ultérieure du groupe (ajout, modification, suppression) est répercutée sur toutes les règles du groupe. Les lignes que la règle possédait avant de rejoindre le groupe sont conservées.

| Sur une règle rattachée à un groupe | Autorisé |
|---|---|
| Modifier le **type de destination** et la **destination** d’une ligne héritée | Oui |
| Modifier le jour, la date, les heures, le libellé ou la référence d’une ligne héritée | Non, modifiez le groupe |
| Supprimer une ligne héritée | Non, supprimez-la dans le groupe |
| Ajouter ses propres plages, exceptions ou jours fériés | Non, ajoutez-les au groupe |

Les destinations se définissent toujours **par règle** : deux règles d’un même groupe partagent les mêmes horaires mais peuvent router vers des destinations différentes.

Pour ne plus suivre le groupe, ouvrez la règle et cliquez sur **Dissocier le groupe**. Les lignes héritées restent sur la règle et deviennent des lignes ordinaires, modifiables et supprimables. Supprimer un groupe a le même effet sur toutes ses règles.

> [!WARNING]
> Les lignes héritées d’un groupe sont créées **sans destination**. Après avoir ajouté une plage horaire, une exception ou des jours fériés à un groupe, renseignez la destination sur chaque règle du groupe : sinon le lookup trouve bien la ligne mais renvoie une `destination` vide.

## Import et export

Depuis **Routages** > **Règles entrantes** :

- **Exporter** télécharge `inbound_rules.xlsx`, avec une ligne par plage horaire.
- **Importer** accepte les fichiers `.xlsx`, `.xls` ou `.csv` (séparateur `;`).

Le plus simple pour construire un fichier d’import est de partir d’un export. Les noms de colonnes sont sur la deuxième ligne, les données commencent à la troisième.

| Colonne | Description |
|---|---|
| `name` | Nom de la règle |
| `number` | Numéro de file ou SDA, selon `type` |
| `type` | `queue` ou `did` |
| `host_name` | Nom d’hôte de l’IPBX, qui doit faire partie des IPBX de votre compte |
| `group_name` | Nom du groupe de règles, créé s’il n’existe pas |
| `active` | `1`, `true`, `vrai` ou `x` pour une règle active. Toute autre valeur, ou une cellule vide, importe la règle comme **inactive** |
| `code` | Code libre |
| `default_destination_type`, `default_destination` | Destination par défaut |
| `day_of_week` | `1` (lundi) à `7` (dimanche) |
| `full_date` | Date précise, `AAAA-MM-JJ` |
| `start`, `end` | `HH:MM:SS` |
| `destination_type`, `destination` | Destination renvoyée pendant la plage horaire |
| `reference` | Référence interne renvoyée par le lookup |

Pour ajouter plusieurs plages horaires à une même règle, répétez les colonnes de la règle sur chaque ligne, ou laissez `type` et `number` vides sur les lignes suivantes. Une ligne ne crée une plage horaire que si elle a un jour ou une date **et** une destination.

Les règles sont identifiées par `type` + `number` : les règles existantes sont mises à jour, les nouvelles sont créées.

> [!WARNING]
> Pour une règle hors groupe, l’import **remplace toutes ses plages horaires** par les lignes du fichier. Les exceptions ne font pas partie de l’import ni de l’export.

L’option **Tout remplacer** supprime aussi les règles entrantes absentes du fichier, ainsi que les groupes qui se retrouvent sans règle.

Si une seule ligne est invalide, tout le fichier est refusé et l’erreur liste les lignes en cause. Rien n’est enregistré.

## Automatiser avec l’API

Les règles entrantes, groupes, plages horaires et exceptions se gèrent aussi via l’API, y compris en masse. Voir [API CX-Engine › Smart Routings](/fr/docs/cx-api/smart-routings).