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_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.