Utiliser Asterisk avec FreePBX

Date 07.12.10

Auteurs Version dubard@prolibre.com V1.1

Nbr page 15

 LE DOCUMEN

P!"#EN

Nous avons cr ce guide destin aux utilisateurs du couple Asterisk !ree"#$. %l prsentes les manipulations les plus courantes &ue nous pouvons e''ectuer avec le s(st)me.

Sommaire
*+ ,-./0+N1 "234+N1........................................................................................................................ 2 *A 4-.%313 "2-*%#2+............................................................................................................................ 5 "2+A0#/*+............................................................................................................................................ 5 6u7est ce &u7un "#$ 8........................................................................................................................... 5 6u7est ce &ue Asterisk 8....................................................................................................................... 5 Autres notions...................................................................................................................................... 5 *7%N1+2!A.+ !2++"#$............................................................................................................................ 9 *a page d7accueil.................................................................................................................................. 9 *7 A2% ................................................................................................................................................... 9 *e !-"................................................................................................................................................ 11 *es rapports........................................................................................................................................ 12 6uel&ues commandes utiles:.............................................................................................................. 12 4-/2.+4.............................................................................................................................................. 15 *%.+N.+ .............................................................................................................................................. 15

 LA #OC$" " P!OL$B!E

ProLibre est une soci%t% &e service en $n'or(ati)ue et en Logiciel Libre* !onde en 2000 ; <en)ve= "ro*ibre conseille ses clients dans les processus d7intgration= de migration ou de dveloppement de solutions in'ormati&ues libres. Nous mettons en place des in'rastructures conomi&ues= 'iables et per'ormantes &ue nous adaptons aux besoins de c>acun de nos clients. 6ue ce soit le petit bureau d7ingnieurs ou une -rganisation %nternationale= nous assurons d7?tre au plus proc>e des besoins de c>acun de nos clients et de 'ournir un service de &ualit rpondant ; notre c>arte et ; nos engagements. ,e nombreux clients tels &ue l7 %nternational .ooperative Alliance= le #%1= l7-N/= 0decins sans !ronti)re= 1erre des @ommes 4uisse= !o(er @andicap= 0decine et @(gi)ne= l7@Apital de la 1our ou encore la !ondation .lairbois nous 'ont con'iance. "ro*ibre est membre des associations </** B<roupe des /tilisateurs de *inux et de *ogiciel *ibre du *manC pour la&uelle 0. 2obert a t membre 'ondateur et prsident durant 9 ans= et de l7association A"2+4 B.>ambre de l7conomie sociale et solidaire de <en)veC. NO# EN+A+EMEN # #%curit% et 'iabilit% "ro*ibre installe et con'igure ses serveurs avec le soucis permanent de garantir un >aut niveau de scurit et de 'iabilit. Personnalisation et (o&ularit% .>a&ue installation correspond ; vos besoins et ; votre mtier= et vous la 'aites voluer ; votre r(t>me tout en respectant votre budget. Nous ne c>angeons pas toutD $n'rastructure consistante Assurer une maintenance minimum pour des per'ormances optimums ncessite une in'rastructure rseau et in'ormati&ue consistante. !%activit% et pro,i(it% "ro*ibre assure une assistance de proximit et une grande ractivit notamment grEce ; la maintenance ; distance. Logiciel Libre "ro*ibre propose et utilise les *ogiciels *ibres. 4ur le site FFF.prolibre.com ou FFF.prolibre.org vous trouvereG plus d7in'ormations sur le logiciel libre destin aux entreprises. Un Logiciel Libre est un logiciel accompagn de son code de fabrication, ainsi que d'une licence d'utilisation qui octroie le droit de modifier ou de faire modifier par un tiers (socit de service) ce logiciel pour l'adapter ses besoins particuliers. Cette licence permet aussi de redistribuer ce logiciel, modifi ou non.

 P!EAMBULE
-u.est ce )u.un PBX / La dfinition de Wi ipedia. /n autocommutateur tlp>oni&ue priv est souvent dsign par l7anglicisme !rivate "utomatic #ranc$ e%c$ange= le&uel est abrg par le sigle PABX et par'ois PBX. /n "A#$ sert principalement ; relier les postes tlp>oni&ues d7un tablissement Blignes internesC avec le rseau tlp>oni&ue public Blignes externesC. %l permet en plus la mise en oeuvre de certaines autres 'onctions tel &ue:

2elier plus de lignes internes &u7il n7( a de lignes externes. "ermettre des appels entre postes internes sans passer par le rseau public. "rogrammer des droits d7acc)s au rseau public pour c>a&ue poste interne. "roposer un ensemble de services tlp>oni&ues Bcon'rences= trans'erts d7appel= renvois= messagerie= appel par nomHC. <rer les 4,A B4lection ,irecte ; l7ArriveC. <rer la ventilation par service de la 'acture tlp>oni&ue globale BtaxationC.

/n "A#$ Bou central tlp>oni&ue priv si vous pr'reGC= travaille aussi bien en numri&ue &u7en analogi&ue.*es raccordements oprateurs les plus courants sont le 21. Bligne analogi&ue t(pe 4FisscomC et le 2N%4 BN/0+2%4 en 10 ou 12C. %l existe deux sortes de "A#$ : *es PABX tra&itionnels ceux &ue l7on appelle de gnration 1,0 B1ime ,ivision 0ultiplexingC= &ui peuvent ventuellement migrer partiellement ou totalement en %" Bsur certaines gammes seulementC= +t les PABX0$P ou %"#$ ou "#$%" B&ui nativement o''rent une connectivit %" +t>ernet a'in d7o''rir des services de tlp>onie sur %"C. *es $PBX peuvent actuellement se prsenter sous la 'orme d7un ". traditionnel &uip d7un logiciel Asterisk par exemple B-pen 4ourceC= et de cartes d7entresIsorties 2N%4 etIou analogi&ues. -u.est ce )ue Asterisk / La dfinition de Wi ipedia Asterisk est un "A#$ logiciel libre= multi plate'orme= publi sous licence <"* par 0ark 4pencer de la socit ,igium. Asterisk permet= comme les "#$ propritaires coJteux= la messagerie vocale= la con'rence= les serveurs vocaux= la distribution des appels= etc. Asterisk implmente les protocoles @K2K et 4%". %l peut Louer le rAle de registrar et passerelle avec les rseaux publics B21.= <40= etc.C. Asterisk implmente galement un protocole spci'i&ue nomm %A$ B%nter Asterisk e$c>angeC : il permet la communication entre client et serveur Asterisk ainsi &u7entre deux serveurs Asterisk. Asterisk est extensible par des scripts ou des modules en "erl ou en .. 4ite Feb o''iciel : >ttp:IIFFF.asterisk.orgI Autres notions Quest-ce quun tlphone SIP ? *es tlp>ones 4%" sont lM&uivalent des tlp>ones Vo%" ou les so't p>ones BlogicielC. .es derniers sont des tlp>ones &ui permettent de tlp>oner en utilisant la tec>nologie Vo%" Bvoix sur protocole %nternetC. %l ( a deux t(pes de tlp>ones 4%". *e premier t(pe de tlp>one est matriel et ressemble ; un tlp>one classi&ue mais peut recevoir et passer des appels via %nternet plutAt &uMen utilisant le rseau tlp>oni&ue traditionnel. *es tlp>ones 4%" peuvent aussi ?tre logiciels. .eux ci permettent ; nMimporte &uel ordinateur dM?tre utilis comme un tlp>one avec un micro cas&ue etIou une carte son. /ne connexion >aut dbit est ncessaire= ainsi &uMune connexion ; un 'ournisseur Vo%" ou ; un serveur 4%".

 L.$N E!FACE F!EEPBX

!ree"#$ est un outil de con'iguration grap>i&ue tr)s convivial du logiciel de tlp>onie libre Asterisk. .7est galement le logiciel utilis dans la distribution 1rixbox et +lastix. >ttp:IIFFF.'reepbx.orgI La page &.accueil

Voicemail N 2ecording BA2% C : "ermet d7accder ; la messagerie vocale. !las> -perator "anel B!-"C : /ne inter'ace permettant de visualiser les extensions= la 'ile d7attente= la con'erence= les trunks acti's=etc... !ree"#$ Administration : "age d7administration

L. A!$ *7A2% B Asterisk 2ecording %nter'ace C permet ; un utilisateur de grer plusieurs options de son extension.

/ne 'ois connecter dans l7 espace personnel= nous avons acc)s ; di''rents liens &ue nous allons dtailler ci dessous.

Le lien &#o'te vocale () <rer notre boOte vocale: Arc>iver=transmettre=couter=e''acer nos messages.

Le lien & *ournal d'appels ( ) "ermet d7avoir une liste dtaille des appels mis ou rceptionns depuis notre extension.

Le lien & !$ones features () "ermet de grer notre extension: 1ransmettre un appel &ui nous est destin sur une autre extension ou vers un autre numro de tlp>one externe. 0ettre en attente les appels. 2endre indisponible notre extension.

Le lien & +ollo, me ( ) "ermet de crer une s&uence d7appel au cas ou l7on rePois un appel sur notre extension et &ue celle ci est occupe ou indisponible. -n peut ainsi transmettre l7appel dans l7ordre &ue l7on veut ; une ou plusieurs extensions =vers un numro externe=ou pour 'inir ; une messagerie.

Le lien & features codes () "ermet d7avoir les di''rentes combinaisons de touc>es permettant d7accder aux services &ue propose notre serveur de tlp>onie Asterisk.

Le lien & param-tres ( ) "ermet de grer d7autres param)tres lis ; notre extension B mot de passe= adresse mail pour la rception des messages=etc...C

Le FOP *e Q !-" R B !las> operator panelC permet de visualiser sous 'orme d7icAne les extensions enregistres sur votre s(st)me de tlp>onie Asterisk. %l permet =entre autre= de voir les di''rents services mis en place B con'rence='ile d7attente=parc d7appel=etcHC *es principaux avantages du !-" sont:

S *a visualisation des extensions occupes par un appel B exemple des extensions en rouge sur l7image ci dessus D C. S *a possibilit d7appeler une autre extension par simple Q gliss pos R de l7icAne correspondant ; notre poste sur celui de notre correspondant. S *a possibilit de Loindre une con'rence. S *a visualisation des appels en 'ile d7attente ou ceux par&us B *es extensions dsignes comme TagentU=de couleur Laune sur l7image ci dessus= pourront prendre l7appel C S *a possibilit de voir si il ( a des messages sur le rpondeur d7une extension B grEce au s(mbole d7une enveloppe blanc>e indi&u ; cAt du numro de l7extension concerne D C. S *a possibilit de par&uer les appels entrants =de les trans'rer vers une d7autres extensions ou dans une salle de con'rence par simple Q gliss pos R

Les rapports *es rapports permettent d7avoir des in'ormations concernant les appels &ui ont t mis ou rceptionns. .es in'ormations peuvent ?tre conserves et enregistres en 'ormat ",! ou .4V.

-uel)ues co((an&es utiles1

Le transfert d'appel )

*e trans'ert d7appel est e''ectu en composant le code correspondant au param)tre Q %n .all Asterisk #lind 1rans'er R du module Q !eature code admin R accessible via l7inter'ace d7administration. 4i le tran'ert d7appel est activ= vous pouveG trans'rer un appel mis vers votre extension en composant : VV B dans notre cas c7est le code d'init dans Q !eature code admin R C suivi du numro de l7extension /ne voix vous indi&uera &u7un trans'ert vient d7?tre activ. *e trans'ert peut s7e''ectuer vers une autre extension =un numro externe ou vers le parking d7appel Ba'in de mettre en attente l7appelant et prvenir le destinataireC . -n peut aussi dcider de trans'rer l7appel tout en s7assurant d7abord &ue le destinataire veut bien prendre cet appel. ,ans ce cas on compose W2 Bcode correspondant au param)tre Q %n .all Asterisk Attended 1rans'er R du module Q !eature code admin R accessible via l7inter'ace d7administration.C= l7appelant est mis en attente et nous sommes mis en relation avec le destinataire de l7appel. 4i celui ci ne veut pas prendre l7appel alors il lui suffit de raccroc$er et l7appelant est automati&uement remis en relation avec notre extension.

4i celui ci veut prendre l7appel alors il nous suffit de raccroc>er et l7appelant est mis en relation avec son destinataire. !arquer un appel )

%l 'aut &ue le module Q parking lots R soit install et paramtr B Voir aussi la documentation destin aux administrateurs &ue nous avons cr C. %l su''it de composer =pour notre cas VV B comme pour un #lind trans'ertC... et ensuite le numro 70 . *a voix vous donnera le numro d7extension vers le&uel l7appel ; t par&u. 4i l7appel est destin ; &uel&u7un d7autre=prveneG le destinataire &u7un appel l7attend au numro d7extension spci'i par la voix. *e destinataire devra alors composer ce numro a'in d7?tre mis en relation avec son correspondant. 4i l7appel n7est pas pris au bout d7un certain temps=il sera dirig vers la destination c>oisi lors du paramtrage du module Q "arking lots R.

Le &call pic up( par groupe d'e.tension )

*e Q call pickup R par groupe est e''ectu en composant le code correspondant au param)tre Q Asterisk <eneral .all "ickup R du module Q !eature code admin R accessible via l7inter'ace d7administration. ,ans notre cas= il 'aut composer W puis le numro X . .ette 'onctionnalit permet de prendre l7appel &ui arrive sur une extension dont l7utilisateur est absent. .ela impli&ue &ue cette extension 'asse partie du m?me groupe BpickupcallC &ue celle oY l7on e''ectue la commande D B voir le param)tre Q callgroup R de notre extension pour savoir dans &uel groupe l7on se trouve. Voir aussi le param)tre Q pickupgroup R a'in de dterminer si l7on est autoris ; prendre les appels de l7extension distant. C /ntrer dans une &conference room( )

%l 'aut &ue le module Q con'erence R soit install et paramtr. %l su''it ensuite de composer le numro de la con'rence. /.emple ) "our accder ; Q "ro*ibre 2oom R composer le numro 200: /ne voix vous indi&uera votre place parmi les participants ; la con'rence. +nsuite une musi&ue d7attente sera Lou Lus&u7; ce &ue &uel&u7un reLoigne cette con'rence D -n peut aussi trans'rer un appel extrieur dans la con'rence en e''ectuant un trans'ert d7appel vers le numro de la con'rence Bici le numro 200C D 0nterroger sa messagerie "steris )

.omposer WZ7 : S +ntrer votre mot de passe S 4uiveG les instructions 0nterroger sa messagerie "steris depuis une autre e.tension )

.omposer WZX : S +ntrer votre numro de boOte vocale B idem ; celui de l7extension C S +ntrer votre mot de passe S 4uiveG les instructions 1edirection d'appel (Call for,ard )) [

%l 'aut &ue le module Q call 'orFard R soit install. 234/5 06!314"24/5) *e Tcall 'orFard U ne 'onctionne pas si l7option T'olloFme U est active pour l7extension. *es appels suivent les r)gles tablies dans la U 'olloF me list U Voir les di''rents code dans le menu U !eature codes U de votre extension accessible depuis l7onglet TrecordingU de l7inter'ace Feb:

.all !orFard All Activate : activer le renvoi inconditionnel des appels

.all !orFard All ,eactivate : dsactiver le renvoi inconditionnnel des appels concernant l7extension depuis la&uelle la manipulation est 'aite. .all !orFard All "rompting ,eactivate : dsactiver le renvoi inconditionnnel des appels concernant une extension= pas ncessairement celle depuis la&uelle la manipulation est 'aite. *e s(st)me demandera de spci'ier l7extension pour la&uelle la dsactivation est e''ectue.

.all !orFard #us( Activate : activer le renvoi d7appel en cas de ligne occupe.

.all !orFard #us( ,eactivate : dsactiver le renvoi d7appel en cas de ligne occupe concernant l7extension depuis la&uelle la manipulation est 'aite. .all !orFard #us( "rompting ,eactivate : dsactiver le renvoi d7appel en cas de ligne occupe= pas ncessairement celle depuis la&uelle la manipulation est 'aite. *e s(st)me demandera de spci'ier l7extension pour la&uelle la dsactivation est e''ectue. .all !orFard No AnsFerI/navailable Activate : activer le renvoi d7appel en cas de non rponse ou de non disponiblit.

.all !orFard No AnsFerI/navailable ,eactivate : dsactiver le renvoi d7appel en cas de non rponse ou de non disponibilit concernant l7extension depuis la&uelle la manipulation est 'aite.

/.emple ) "our activer ou dsactiver un renvoi= il su''it de composer le code correspondant. 4i le s(st)me demande de composer le numro de l7extension concerne et l7extension concerne est celle depuis la&uelle on appelle= alors il su''it de composer V= sans composer le numro de l7extension. 4i on c>oisit un T,eactivateU sans T"romptingU= alors il ne sera pas demand de composer le numro de l7extension et la dsactivation concernera l7extension depuis la&uelle on appelle. 4i on veut renvo(er les appels vers sa propre messagerie= il su''it de presser W et de valider avec V. 4i on veut renvo(er les appels vers la messagerie d7une autre extension= il su''it de presser W suivi du numro de cette extension et de valider avec V. -n peut aussi renvo(er les appels vers un numro externe au s(st)me.

 #OU!CE#
\e remercie principalement les sites nomms ci dessous pour la ric>esse de leurs in'ormations. >ttp:IIFFF.manuel 'reepbx.comI >ttp:IIFFF.asterisk 'rance.orgI >ttp:IIaussievoip.comIFikiIindex.p>p8page]'ree"#$ >ttp:IIFFF.voip in'o.orgI >ttp:IIFiki.contribs.orgI!ree"#$I'rV!ree"#$ >ttp:IIFFF.asteriskguru.comItutorialsI >ttp:IIcondorcet.iris.'ree.'rI >ttp:IIFFF.cadvision.comIblanc>asIAsteriskI.on'iguringAsterisk,a>di.>tml >ttp:IIFFF.Kcx.'rIvoip sipI >ttp:IIartisan.karma lab.netI >ttp:IIFFF.&ueret.netIblogIcategor(IVoip asterisk telep>onie >ttp:IIFFF.'reepbx.orgIsupportIdocumentationI>oFtosI >ttp:IIFFF.elastix.orgI

L$CENCE

.e document ; t ralis par 0icka^l ,/#A2, B dubard@prolibre.comC %l est publi sous licence .reative .ommons Attribution= "artage ; l7identi&ue= .ontexte non >ttp:IIcreativecommons.orgIlicensesIb( nc saI2.0I'rI

commercial

2.0