#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 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. |
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.
- Allez dans Routages > Groupes de règles et cliquez sur Ajouter un groupe de règles.
- Sur la page du groupe, ajoutez les plages horaires et les exceptions (sans destination au niveau du groupe).
- 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.
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
destinationvide.
#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,.xlsou.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.
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.