Services Complémentaires

📖 Retour à la Documentation Principale

Configuration et mise en œuvre du renvoi d'appels, du blocage de l'CLI et des services d'appel d'urgence.

Documentation Connexe

Documentation de Base

📋 README Principal - Vue d'ensemble et démarrage rapide
🔧 Guide de Configuration - Paramètres de configuration du service (codes d'urgence, blocage de l'CLI, renvoi d'appels par défaut)
🔧 Guide des Opérations - Test des services complémentaires

Traitement des Appels & Sources de Données

🔀 Configuration du Plan de Numérotation - Mise en œuvre des services dans la logique du plan de numérotation
👥 Interface Sh - MMTel-Config pour les paramètres de renvoi d'appels
📡 SS7 MAP - Renvoi d'appels basé sur HLR (alternative à Sh)
🔢 Traduction de Numéros - Gestion des préfixes de blocage de l'CLI

Interactions de Service

💳 Chargement en Ligne - Les appels d'urgence contournent l'OCS
📞 Messagerie Vocale - Renvoi d'appels sur les itinéraires occupés/sans réponse vers la messagerie vocale

Surveillance

📊 Référence des Métriques - Métriques de renvoi d'appels et de service
📈 Métriques du Plan de Numérotation - Métriques d'utilisation du service

Services Complémentaires (Renvoi d'Appel / CLI Bloqué / Codes d'Urgence)

Configuration pour les préfixes de CLI bloqués, les codes d'appel d'urgence et les données par défaut de Renvoi d'Appel (les données de Renvoi d'Appel / Pas de Réponse ne sont utilisées que lorsque aucune donnée MMTel-Config n'est renvoyée par le Référentiel sur Sh).

config :tas,
  ...
  blocked_cli_prefix: ["*67"],
  call_forward_not_reachable_destination: "2222",
  default_no_reply_timer: 30,
  emergency_call_codes: ["911", "912", "913", "sos"],
  ...

Paramètres de Configuration :

blocked_cli_prefix (liste de chaînes) : Préfixes qui déclenchent la rétention de l'CLI (Identifiant de Ligne Appelante)
- Exemple : ["*67"] - composer *67 avant un numéro cache l'identité de l'appelant
- Utilisé dans le plan de numérotation pour définir la variable cli_withheld
call_forward_not_reachable_destination (chaîne) : Destination par défaut pour le Renvoi d'Appel Non Joignable (CFNRc)
- Utilisé uniquement lorsque aucune MMTel-Config n'est renvoyée par l'interface Sh
- Exemple : "2222" - renvoie vers la messagerie vocale
default_no_reply_timer (entier) : Délai d'attente par défaut en secondes avant que le CFNRc ne s'active
- Utilisé uniquement lorsque aucune MMTel-Config n'est renvoyée par l'interface Sh
- Exemple : 30 - sonne pendant 30 secondes avant de renvoyer
emergency_call_codes (liste de chaînes) : Numéros de services d'urgence pour votre juridiction
- Vérifiés lors de l'autorisation d'appel pour détecter les appels d'urgence
- Les URNs d'urgence SIP (par exemple, <urn:service:sos>) sont toujours vérifiés en plus de ces codes
- Exemples courants : ["911", "112", "000", "999", "sos"]
- Voir la section Appels d'Urgence pour une utilisation détaillée

Comment Fonctionne le Blocage de l'Identité de l'Appelant

Le TAS prend en charge deux méthodes pour bloquer l'identité de l'appelant (retenue de l'CLI), qui définissent toutes deux la variable de plan de numérotation cli_withheld sur "true" :

Méthode 1 : Blocage Basé sur le Préfixe

Lorsqu'un abonné compose un numéro de destination précédé d'un code de blocked_cli_prefix :

Le module de traduction de numéros détecte le préfixe (par exemple, l'appelant compose *67555123456)
Le préfixe est retiré du numéro de destination (devenant 555123456)
La variable cli_withheld est définie sur "true"
Le plan de numérotation peut ensuite utiliser cette variable pour cacher l'identité de l'appelant

Exemple de configuration :

blocked_cli_prefix: ["*67"]        # Blocage de style US
blocked_cli_prefix: ["#31#"]       # Blocage de style GSM européen
blocked_cli_prefix: ["*67", "#31#"] # Support des deux

Méthode 2 : Détection de l'En-tête SIP From

Lorsque l'UE/appareil demande la confidentialité via les en-têtes SIP :

Le TAS vérifie si le nom d'affichage de l'en-tête SIP From contient "anonyme" (insensible à la casse)
Si trouvé, la variable cli_withheld est définie sur "true"
Cela respecte la demande de confidentialité de l'abonné définie au niveau de l'appareil

Mise en Œuvre du Blocage de l'CLI dans le Plan de Numérotation

Le TAS définit la variable cli_withheld, mais votre XML de plan de numérotation doit mettre en œuvre le comportement de blocage réel :

<extension name="CLI-Privacy" continue="true">
  <condition field="${cli_withheld}" expression="true">
    <!-- Cacher l'identité de l'appelant -->
    <action application="set" data="effective_caller_id_name=anonyme"/>
    <action application="set" data="effective_caller_id_number=anonyme"/>
    <action application="set" data="origination_privacy=hide_number"/>

    <!-- Optionnellement définir la confidentialité de l'identité affirmée P- -->
    <action application="set" data="sip_h_Privacy=id"/>
  </condition>
</extension>

Variables Définies par le TAS pour le Blocage de l'CLI :

Le TAS définit ces variables avant l'exécution du plan de numérotation :

Variable	Type	Valeurs	Description
`cli_withheld`	chaîne	`"true"` ou `"false"`	Indique si le blocage de l'CLI a été demandé via un préfixe OU un en-tête From
`tas_destination_number`	chaîne	numéro normalisé	Destination avec le préfixe de blocage retiré (par exemple, `555123456`)
`destination_number`	chaîne	numéro normalisé	Identique à `tas_destination_number` (les deux sont définis)

Variables que Votre Plan de Numérotation Doit Définir (lorsque cli_withheld="true"):

Ces variables contrôlent la manière dont l'identité de l'appelant est présentée :

Variable	Valeur Recommandée	But
`effective_caller_id_number`	`"anonyme"`	Cache le numéro de téléphone de l'appelant
`effective_caller_id_name`	`"anonyme"`	Cache le nom d'affichage de l'appelant
`origination_privacy`	`"hide_number"`	Drapeau de confidentialité SIP pour le segment sortant
`sip_h_Privacy`	`"id"`	En-tête de confidentialité SIP (RFC 3323)
`sip_h_P-Asserted-Identity`	(non défini ou supprimé)	Optionnel : Supprimer l'en-tête P-Asserted-Identity

Exemple Complet de Plan de Numérotation :

<extension name="CLI-Privacy-Handler" continue="true">
  <condition field="${cli_withheld}" expression="true">
    <!-- Journaliser pour le dépannage -->
    <action application="log" data="INFO Blocage de l'CLI demandé pour l'appel à ${tas_destination_number}"/>

    <!-- Cacher l'identité de l'appelant lors de l'appel sortant -->
    <action application="set" data="effective_caller_id_name=anonyme"/>
    <action application="set" data="effective_caller_id_number=anonyme"/>
    <action application="set" data="origination_privacy=hide_number"/>

    <!-- Définir les en-têtes de confidentialité SIP -->
    <action application="set" data="sip_h_Privacy=id"/>

    <!-- Optionnel : Supprimer P-Asserted-Identity si présent -->
    <action application="unset" data="sip_h_P-Asserted-Identity"/>

    <!-- L'anti-action s'exécute si cli_withheld est faux -->
    <anti-action application="log" data="DEBUG Utilisation de l'identité de l'appelant normale : ${msisdn}"/>
    <anti-action application="set" data="effective_caller_id_number=${msisdn}"/>
  </condition>
</extension>

<!-- Cette extension continue vers le routage d'appel réel -->
<extension name="Route-Outbound-Call">
  <condition field="${tas_destination_number}" expression="^(.+)$">
    <action application="bridge" data="sofia/gateway/trunk/${tas_destination_number}"/>
  </condition>
</extension>

Remarques Importantes :

Les deux méthodes peuvent fonctionner simultanément (le préfixe OU l'en-tête SIP déclenche le blocage)
Le préfixe est toujours retiré du numéro de destination, même si le plan de numérotation n'implémente pas la confidentialité
La variable cli_withheld est une chaîne ("true" ou "false"), pas un booléen
Le comportement de Renvoi d'Appel / CLI Bloqué est mis en œuvre dans votre XML de plan de numérotation
La configuration d'exemple inclut ces fonctionnalités, mais si vous ne les définissez pas dans votre plan de numérotation, elles ne fonctionneront pas
Les variables sont définies uniquement pendant le flux d'appel MO (Mobile Originating)

Comment Fonctionne le Renvoi d'Appel

Le renvoi d'appels (également connu sous le nom de Diversion de Communication ou CDIV) permet aux abonnés de rediriger les appels entrants vers une autre destination. Le TAS prend en charge plusieurs types de renvoi d'appels avec un comportement configurable.

Types de Renvoi d'Appel

1. Renvoi d'Appel Total (CFA) - Renvoi Inconditionnel

Variable : call_forward_all_destination
Quand Actif : Tous les appels entrants sont immédiatement renvoyés
Priorité : Vérifié en premier (après le renvoi HLR)
Utilisation Courante : L'abonné souhaite que tous les appels soient envoyés à un autre numéro
Exemple : Appels professionnels renvoyés vers le téléphone personnel

2. Renvoi d'Appel Occupé (CFB)

Quand Actif : L'appel est renvoyé lorsque l'abonné est déjà en ligne
Réponse SIP : 486 Occupé déclenche le renvoi
Utilisation Courante : Renvoie vers la messagerie vocale lorsqu'on est sur un autre appel

3. Renvoi d'Appel Pas de Réponse (CFNRy)

Variable : no_reply_timer
Quand Actif : L'appel est renvoyé après avoir sonné pendant un certain nombre de secondes sans réponse
Délai d'Expiration : Typiquement 15-30 secondes
Utilisation Courante : Renvoie vers la messagerie vocale si non répondu

4. Renvoi d'Appel Non Joignable (CFNRc)

Variable : call_forward_not_reachable_destination
Quand Actif : L'abonné est hors ligne, non enregistré ou inaccessible
Réponse SIP : 480 Temporairement Indisponible
Utilisation Courante : Renvoie vers la messagerie vocale lorsque le téléphone est éteint
Par Défaut : Paramètre de configuration utilisé si aucune MMTel-Config

Priorité des Sources de Données

Les données de renvoi d'appels sont récupérées à partir de plusieurs sources avec cette priorité :

1. Données HLR (SS7 MAP)           [Priorité la Plus Élevée - remplace tout]
   ↓ (si aucun renvoi HLR actif)
2. MMTel-Config (Interface Sh)      [Paramètres spécifiques à l'abonné provenant de l'HSS]
   ↓ (si aucune MMTel-Config renvoyée)
3. Valeurs par Défaut de Configuration [Priorité la Plus Basse - valeurs de secours]

Pourquoi Cette Priorité ?

Données HLR : État de renvoi en temps réel pour les scénarios de roaming/réseau
MMTel-Config : Préférences configurées par l'abonné dans l'IMS
Valeurs de Configuration : Valeurs de secours à l'échelle du réseau (typiquement messagerie vocale)

Variables de Plan de Numérotation pour le Renvoi d'Appel

Variable	Type	Source	Valeur Exemple	Description
`call_forward_all_destination`	chaîne	Sh/MMTel ou `"none"`	`"61403555123"`	Destination CFA si active
`call_forward_not_reachable_destination`	chaîne	Sh/MMTel ou config	`"2222"`	Destination CFNRc (messagerie vocale)
`no_reply_timer`	entier	Sh/MMTel ou config	`30`	Secondes à sonner avant CFNRy
`msrn`	chaîne	HLR (MT uniquement)	`"61400123456"`	MSRN ou numéro renvoyé depuis HLR
`tas_destination_number`	chaîne	Calculée	`"2222"`	Destination de routage réelle (peut être le numéro de renvoi)

Mise en Œuvre du Renvoi d'Appel dans le Plan de Numérotation

Exemple de Plan de Numérotation MT avec Renvoi d'Appel :

<!-- Vérifier le Renvoi d'Appel Total (priorité la plus élevée après HLR) -->
<extension name="Check-CFA" continue="true">
  <condition field="${call_forward_all_destination}" expression="^(?!none$).+$">
    <action application="log" data="INFO Renvoi d'Appel Total actif vers ${call_forward_all_destination}"/>
    <action application="set" data="tas_destination_number=${call_forward_all_destination}"/>
  </condition>
</extension>

<!-- Tentative de relier à l'abonné -->
<extension name="Bridge-To-Subscriber">
  <condition field="${msrn}" expression="^none$">
    <!-- Pas de MSRN, routage vers l'abonné local -->
    <action application="set" data="call_timeout=${no_reply_timer}"/>
    <action application="bridge" data="sofia/internal/${tas_destination_number}@${scscf_address}"/>

    <!-- Si le pont échoue, vérifier le renvoi -->
    <action application="log" data="INFO Le pont a échoué, vérification du renvoi d'appel"/>

    <!-- Renvoi d'Appel Non Joignable -->
    <action application="set" data="forward_destination=${call_forward_not_reachable_destination}"/>
    <action application="log" data="INFO Renvoi vers ${forward_destination}"/>
    <action application="answer"/>
    <action application="voicemail" data="default default ${msisdn}"/>
  </condition>
</extension>

Configuration du Renvoi d'Appel par Défaut

Définir les valeurs par défaut à l'échelle du réseau dans config/runtime.exs :

config :tas,
  # Destination CFNRc par défaut (utilisée lorsque aucune MMTel-Config)
  call_forward_not_reachable_destination: "2222",  # Numéro d'accès à la messagerie vocale

  # Délai par défaut avant l'activation de CFNRy (utilisé lorsque aucune MMTel-Config)
  default_no_reply_timer: 30  # Sonner pendant 30 secondes

Quand les Valeurs par Défaut Sont Utilisées :

L'abonné existe dans l'HSS mais n'a pas de MMTel-Config provisionnée
La recherche Sh réussit mais ne renvoie aucun paramètre de renvoi d'appel
Nouveaux abonnés avant que le renvoi d'appel ne soit configuré

Dépannage du Renvoi d'Appel

Problème : Les appels ne se renvoient pas comme prévu

Vérifier les Données Sh :
- Utiliser l'interface Web /sh_test pour interroger l'abonné
- Vérifier que la MMTel-Config contient des règles CDIV
- Vérifier la valeur de call_forward_all_destination
Vérifier les Variables de Plan de Numérotation :
- Examiner les journaux d'appels pour les valeurs des variables
- Confirmer que call_forward_all_destination != "none"
- Vérifier que tas_destination_number est défini sur la destination de renvoi
Vérifier les Données HLR (si SS7 MAP activé) :
- Utiliser l'interface Web /hlr pour interroger l'abonné
- Le renvoi HLR remplace les données Sh
- Vérifier que la variable msrn ne contient pas de numéro de renvoi inattendu
Vérifier les Valeurs par Défaut de Configuration :
- Vérifier call_forward_not_reachable_destination dans la configuration
- Confirmer que default_no_reply_timer est approprié
- Ceux-ci ne s'appliquent que lorsque aucune MMTel-Config n'existe

Problème : Boucles de renvoi

Symptômes : L'appel se renvoie vers un numéro qui renvoie en retour, créant une boucle

Prévention dans le Plan de Numérotation :

<!-- Suivre le nombre de sauts de renvoi -->
<extension name="Prevent-Forward-Loop" continue="true">
  <condition field="${sip_h_X-Forward-Hop-Count}" expression="^$">
    <action application="set" data="sip_h_X-Forward-Hop-Count=1"/>
    <anti-action application="set" data="sip_h_X-Forward-Hop-Count=${expr(${sip_h_X-Forward-Hop-Count}+1)}"/>
  </condition>
</extension>

<extension name="Check-Forward-Hop-Limit">
  <condition field="${sip_h_X-Forward-Hop-Count}" expression="^([3-9]|[1-9][0-9]+)$">
    <action application="log" data="ERROR Boucle de renvoi détectée, nombre de sauts : ${sip_h_X-Forward-Hop-Count}"/>
    <action application="hangup" data="LOOP_DETECTED"/>
  </condition>
</extension>

Surveillance du Renvoi d'Appel

Indicateurs Clés :

Taux élevé d'appels vers des numéros de messagerie vocale
Modèle d'appels expirant au niveau de la valeur no_reply_timer
Appels systématiquement routés vers les mêmes destinations de renvoi

Journaux Utiles :

INFO Renvoi d'Appel Total actif vers 61403555123
INFO Renvoi vers 2222
INFO Le pont a échoué, vérification du renvoi d'appel

Intelligence d'Affaires :

Suivre les taux d'activation de renvoi par abonné
Surveiller les modèles d'utilisation de la messagerie vocale
Identifier les abonnés avec renvoi inconditionnel

Documentation Connexe​

Documentation de Base​

Traitement des Appels & Sources de Données​

Interactions de Service​

Surveillance​

Services Complémentaires (Renvoi d'Appel / CLI Bloqué / Codes d'Urgence)​

Comment Fonctionne le Blocage de l'Identité de l'Appelant​

Comment Fonctionne le Renvoi d'Appel​

Types de Renvoi d'Appel​

Priorité des Sources de Données​

Variables de Plan de Numérotation pour le Renvoi d'Appel​

Mise en Œuvre du Renvoi d'Appel dans le Plan de Numérotation​

Configuration du Renvoi d'Appel par Défaut​

Dépannage du Renvoi d'Appel​

Surveillance du Renvoi d'Appel​