Extensions

Une extension est une instruction du plan de numrotation excute pour le poste ou groupe de postes destinataire(s) correspondant son nom.

Ce nom est dfini par une squence de touches (numro de tlphone ou alphanumrique).

Syntaxe:exten => nom_extension

Syntaxe complte de l'instruction:exten => nom_extension, priorit, application()

Exemple: rpondre l'appel numrotant le poste 123exten => 123, 1, Answer()

Exemple: rpondre l'appel numrotant tout poste commenant par 123 et comportant 5 chiffresexten => _123XX, 1, Answer()

Les protocoles de VoIP tels H323 ou SIP encouragent l'emploi de noms d'extensions alphanumriques ou adresses de messagerie.

Extensions Pythagore F.D. Page 24(c) Pythagore F.D. 2011

Extensions non spcifiquesCertaines extensions nommes ne sont pas spcifiques un terminal, ni mme un groupe de terminaux.

"s": startL'extension "s", pour dbut (start), gre automatiquement tous les appels entrants dans un contexte sans extension de destination spcifique (souvent utilis dans les macros).

Exemple: sur tout appel entrant, dcrocher et jouer le fichier son demandant de numroter une extensionexten => s, 1, Answer()exten => s, 2, Background(enter-ext-of-person)

"i": invalidL'extension "i", pour entre invalide (invalid), recevra tous les appels dont l'extension numrote ne figurera pas dans le menu d'un serveur vocal.

Exemple: sur entre invalide, joue le fichier son correspondant et raccrocheexten => i, 1, Playback(pbx-invalid)exten => i, 2, Hangup()

"t": timeoutL'extension "t", pour dlai dpass (timeout), sera appele lorsque l'appelant aura mis trop de temps composer une entre demande par une application (exemple: Background()). La temporisation par dfaut est de 10 secondes.

Exemple: la chute du dlai de temporisation, jouer le fichier son vm-goodbye et raccrocherexten => t, 1, Playback(vm-goodbye)exten => t, 2, Hangup()

Extensions Pythagore F.D. Page 25(c) Pythagore F.D. 2011

PrioritsLa priorit dfinit l'ordonnancement des instructions relatives une extension. Elles sont numrotes partir de 1 dans un ordre croissant.

En cas de "trou" dans la numrotation des priorits, le PBX Astrisk arrtera l'excution des instructions.

Exemple: rpondre sur la numrotation de 123 puis raccrocherexten => 123, 1, Answer()exten => 123, 2, Hangup()

Les priorits peuvent comporter du texte indicatif entre parenthses, qui servira de nom de rfrence: ce sont des priorits nommes:

exten => 123, 1(dcrocher), Answer()exten => 123, 2(raccrocher), Hangup()

Les priorits peuvent tre non numrotes: la priorit n (next) prendra le numro incrment de 1 de la priorit prcdente, rendant le plan de numrotation plus souple.

Exemple: rpondre au canal qui sonne sur numrotation de 123, tablir la communication vers le terminal SIP d'extension 123 puis raccrocher en fin de communicationexten => 123, 1, Answer()exten => 123, n, Dial(SIP/123)exten => 123, n, Hangup()

Priorits Pythagore F.D. Page 26(c) Pythagore F.D. 2011

ApplicationsUne application excute une action spcifique sur le canal en cours. Analogue une fonction, elle peut recevoir des arguments entre parenthses "()" spars par des virgules ",".

Syntaxe:application(argument1, argument2,...)

La plupart des applications ne fonctionne que si le canal n'est pas en train de sonner. Il faut donc au pralable faire rpondre Asterisk (Answer()), qui cre alors le demi-canal appelant-proxy.

Tout plan de numrotation devrait donc dbuter ainsi:

[incoming]exten => s, 1, Answer()exten => s, n, application2()exten => s, n, application3()

exten => 123, 1, application1()...

La liste des applications Asterisk est accessible en ligne de commande:~# asterisk -rCLI> core show applicationsCLI> core show application Dial ;Manuel de l'application Dial (sensible la casse)

Applications Pythagore F.D. Page 27(c) Pythagore F.D. 2011

Exemple d'appelTout terminal tlphonique VoIP (ipphone, softphone) devant s'inscrire sur un proxy pour passer des appels, devra ncessairement tre dclar dans la configuration d'Asterik.

Dans le cas o l'on dispose de deux ipphones SIP, on renseignera le fichier /etc/asterisk/sip.conf avant d'crire le plan de numrotation dans le fichier /etc/asterisk/extensions.conf selon les rgles prcdentes.

Exemple de configuration des ipphones uid01 et uid10 pour des appels bidirectionnels:

/etc/asterisk/sip.conf:

[uid01] ;Nom de compte utilis pour l'enregistrement du tlphonetype=friend ;Support bidirectionnel des appelsallow=all ;Liste des codecs autorissusername=station01 ;Nom d'utilisateur en cas d'authentificationsecret=bonjour ;Mot de passe l'enregistrementqualify=yes ;Dtermination de la latence rseau par Asteriskhost=dynamic ;Adressage IP dynamiquecontext=from_01 ;Contexte du plan de numrotation traitant les appels de uid01

[uid10]type=friendallow=allusername=station10secret=bonjourqualify=yeshost=dynamiccontext=from_10 ;Contexte du plan de numrotation traitant les appels de uid10

Exemple d'appel Pythagore F.D. Page 28(c) Pythagore F.D. 2011

Exemple d'appelExemple de plan de numrotation grant les numros deux chiffres:

/etc/asterisk/extensions.conf:

[from_01] ;Dclaration du contexte de uid01include => interne ;Inclusion du contexte de numrotation interne

[from_10] ;Dclaration du contexte de uid10include => interne ;Inclusion du contexte de numrotation interne

[interne] ;Dclaration du contexte interneexten => _XX, 1, Answer() ;Asterisk tablit le demi-canal appelant-proxyexten => _XX, n, Dial(SIP/uid${EXTEN},30,gjr) ;Numrotation du canal SIP rfrenc 'uidXX'.

;Le destinataire est connu grce la variable ${EXTEN}exten => _XX, n, Hangup() ;L'appel se termine, on raccroche

Visualisation de l'appel uid01 vers uid10 dans la console Asterisk:~# asterisk -rCLI> core set verbose 3

-- Executing [10@from_01:1] Answer("SIP/uid01-08b054b8", "") in new stack-- Executing [10@from_01:2] Dial("SIP/uid01-08b054b8", "SIP/uid10|30|gjr") in new stack-- Called uid10-- SIP/uid10-08b071e8 is ringing-- SIP/uid10-08b071e8 answered SIP/uid01-08b054b8-- Native bridging SIP/uid01-08b054b8 and SIP/uid10-08b071e8-- Executing [10@from_01:3] Hangup("SIP/uid01-08b054b8", "") in new stack

== Spawn extension (from_01, 10, 3) exited non-zero on 'SIP/uid01-08b054b8'

Exemple d'appel Pythagore F.D. Page 29(c) Pythagore F.D. 2011

ExtensionsPrioritsApplicationsExemple d'appel