Scripts / Variables reçues


Ces variables sont définies par le système. Pour les différencier des variables générées par l'exécution d’un scénario (variables créées par les scripts "utilisateur"), les variables systèmes sont préfixées _nativip_ . Il est fortement déconseillé de nommer vos propres variables avec le préfixe _nativip_ .

  • Vos scripts peuvent accéder aux variables préfixées _nativip_ et les utiliser pour piloter en retour une action.
  • Par convention les variables préfixées _asr sont réservées pour les échanges de reconnaissance de la parole.
  • Globalement pour prévenir tout conflit avec une version future, il conviendra d'éviter le préfixe '_' (underscore) pour vos propres variables.
  • Vos scripts peuvent créer/modifier d'autres variables dans le tableau params sans limitation spécifique. Il peut être intéressant de créer un fichier spécifique ou d'utiliser une base de données si leur nombre devait être très important.

Variables systèmes

nom de la variable utilisation commentaires
_nativip_chan_id
identificateur unique de la communication
Cette identifiant unique permettra aussi d'identifier la communication dans les données CDR.
nativIP génère par défaut des UUID respectant la RFC4122
( https://fr.wikipedia.org/wiki/Universally_unique_identifier )
_nativip_chan_chan
numéro du canal (channelisé)
Equivalent à un numéro de voix.
Unique le temps de la communication, il permet une identification simple par canal . Cette variable permet aussi la simplification du portage de développements legacy.
_nativip_dtmf_last
dernier DTMF saisi

_nativip_caller_id
identification de l’appelant
(dépend de la connectivité réseau télécom, de l'opérateur)
_nativip_caller_id_name identification de l’appelant (nom) (dépend de la connectivité réseau télécom, de l'opérateur)
_nativip_called_id
identification du numéro appelé
(dépend de la connectivité réseau). En appel sortant il s'agit du numéro cible de l'appel. En réception, il s'agit du numéro sur lequel l'appel a été reçu.
_nativip_pani entête P-Access-Network-Info(uniquement sur appel entrant)

Le contenu de l'entête dépend du lien opérateur.
Il peut potentiellement contenir des informations de géolocalisation de l'appel.
_nativip_scenario
scénario appelant le script

_nativip_rub
rubrique appelant le script

_nativip_lastbridge_res
état du dernier transfert (ou en cours dans liberation.php
Valeur Raison
0 en cours (liberation.php) : abandon de l’appelant
post transfert : échec du transfert
reject
rejeté (numéro interdit)
bridged
mis en relation (abouté ou transféré)

_nativip_diversion
contenu de l’entête diversion
( SIP-INVITE )
_nativip_invite_to
contenu de l’entête to
( SIP-INVITE )
_nativip_from_user
user défini dans le from
( SIP-INVITE )
_nativip_ipsource
adresse IP distante
( IPV4 )
_asr_file
fichier XML contenant la reconnaissance de la parole
contenu propre à chaque système et aux choix de configuration

Ainsi un script dépendant du numéro de l’appelant y accédera par $params[“_nativip_caller_id”] en PHP, nativip.params._nativip_caller_id en Javascript et
nativip['params']['_nativip_caller_id '] en Python.