#acl All:read
= Asterisk =
Asterisk est un autocommutateur téléphonique privé (PABX) open source et propriétaire (publié sous licence GPL et licence propriétaire) pour systèmes GNU/Linux. Il permet, entre autres, la messagerie vocale, les files d'attente, les agents d'appels, les musiques d'attente et les mises en garde d'appels, la distribution des appels.

== Installation ==
La version d'asterisk utilisé par le crans est celle du trunk svn d'asterisk et pas celle des dépots debian. La raison première est l'apport de plusieurs fonctionnalité inintéressante (comme le support des messages instantanés hors canal de communication préétabli).
Les sources se trouvent dans {{{/usr/scripts/src/asterisk/}}}

Il faudra voir si la version des dépots de wheezy possèdes ces fonctionnalités, parce que bon, compiler asterisk, même si le makefile est très bien fait, ça reste enquiquinant et relativement long.

== Fichiers de configurations ==
Les fichiers utilisés au crans sont : 
 * sip.conf pour tout ce qui concerne les comptes sip
 * voicemail.conf pour les paramètres de la messagerie
 * manager.conf pour les paramètres de {{{AMI}}} {{{Asterisk Manager Interface}}}. Le fichier {{{asterisk.py}}} dans {{{/usr/scripts/sip/}}} fourni, via la classe {{{Manager}}} un binding simple pour contrôler à distance asterisk. Il convient d'ajouter une fonction par action lorsque cela est nécessaire et d'éviter d'utiliser en production la fonction {{{action}}}.
 * extensions.conf pour le plan de numérotation. Un graphe de ce dernier est disponible à cette adresse : [[http://doc.crans.org/asterisk/]]

== Les scripts AGI ==

{{{AGI}}} est l'acronyme de {{{Asterisk Gateway Interface}}}. Ils se trouvent dans le dossier {{{/var/lib/asterisk/agi-bin}}} et permettent de faire plein de choses compliquées (jouer ou enregistrer du son, envoyer du texte, lire les chiffre tapée au clavier, etc.) comme le montre le fichier {{{agi-test.agi}}}

Les scripts agi du crans sont dans {{{/usr/scripts/sip/agi/}}} et ne font rien de bien compliqué : 
 * {{{history}}} permet de mettre à jour le journal d'appel dans django et de vérifier les quotas d'appel
 * {{{sms_delay}}} de garder un message textuel en attendant que son destinataire se connecte


Il est préférable d'utiliser la commande {{{AGI}}} d'asterisk plutôt que la commande {{{SHELL}}} au sens où cette première est sensée être plus sûr : il est assuré qu'asterisk attende la fin de l'exécution de la commande avant de faire quoi que ce soit (raccrocher, fermer des canaux, etc.) et ne l'interrompe pas.

== Messagerie ==

=== Mettre un message personnalisé à la main ===
 * il suffit de mettre un fichier {{{temp.EXT}}} où {{{EXT}}} correspond au format du fichier (mp3, wav, alaw, gsm…) dans le dossier {{{/var/spool/asterisk/voicemail/666/ID/}}} où {{{ID}}} est l'identifiant asterisk.

----
 * CatégorieCrans
 * CatégoriePagePublique
 * CatégoriePageNonTerminée