Asterisk Console:
Per aprire una console asterisk basta lanciare: asterisk -rv
L’opzione v indica il livello di verbosing; vvv livello 3, vv livello 2, ecc…

Lista dei comandi più utili:
(la sintassi può variare in base alla versione di asterisk)

* Primario Telefonico (Primary Line), Dahdi:

*CLI> pri show span X            ; dove X è il channel PRI dell'EuroISDN (normalente 1)
*CLI> pri intense debug span X   ; abilita la modalità di debuggin intense
*CLI> dahdi show channels        ; lista dei canali dahdi presenti
*CLI> core show channels         ; lista dei canali attivi (core level)
*CLI> voicemail show users       ; Visualizza informazioni delle caselle dei messaggi vocali attivi, visualizza il numero dei messaggi nuovi (NewMsg)

* Console debugging:

*CLI> core set debug X           ; dove X è un numero, abilita/disabilita il livello di debugging
*CLI> core set verbose X         ; dove X è un numero, abilita/disabilita il livello di verbosing
*CLI> sip set debug peer 699     ; dove XXX è l'estensione, abilita/disabilita il debugging di un peer SIP specifico
*CLI> sip set debug off          ; disabilita tutti i debug SIP attivi

* Comandi Protocollo SIP:

*CLI> sip show peers             ; visualizza informazioni di tutti i peer SIP configurati in Asterisk
*CLI> sip show peer XXX          ; dove XXX è un'estensione, visualizza la configurazione corrente di un peer SIP
*CLI> sip show channels          ; visualizza tutti i canali SIP al momento attivi
*CLI> sip show channel XXXXXX    ; dove XXXXXX è il `Call ID`, visualizza tutte le informazioni di un dato canale SIP attivo
*CLI> sip show registry          ; lista dei peer SIP registrati

* Comandi Protocollo IAX:

*CLI> iax2 show peers             ; visualizza informazioni di tutti i peer IAX configurati in Asterisk
*CLI> iax2 show peer XXX          ; dove XXX è un'estensione, visualizza la configurazione corrente di un peer IAX
*CLI> iax2 show channels          ; lista dei peer IAX registrati

* Comandi di Reload:


*CLI> dialplan reload             ; Reload del dialplan
*CLI> iax2 reload                 ; Reload del modulo iax2 (eseguire dopo aver effettuato cambi di configurazione IAX)
*CLI> sip reload                  ; Reload del modulo sip (eseguire dopo aver effettuato cambi di configurazione SIP)
*CLI> module reload               ; Reload di tutti i moduli asterisk


Il caso più classico dove questa funzionalità trova applicazione è nei sistemi per call center, dove il supervisore ha la necessità di interagire con l’operatore principalmente al fine di:

- Controllare la qualità: Il supervisore monitorizza il servizio che l’operatore offre al cliente.
- Training: Il supervisore interagisce con l’operatore al fine di aiutarlo ad offrire un buon servizio telefonico (whisper mode).

Asterisk implementa la funzione chanspy(). Analizziamo il seguente esempio per capire come funziona:

[macro-spy]
exten => s,1,Answer(1)
exten => s,n,Authenticate(1234)
exten => s,n,ChanSpy(SIP/${ARG1}|o)
exten => s,n,Hangup

In questo esempio, la macro “spy” viene protetta con password (1234) grazie alla funzione Authenticate di Asterisk. L’accesso alle funzionalità di monitoraggio quindi rimane ristretta a tutti coloro che conoscono la chiave d’accesso.
La macro “spy” si aspetta un valore ${ARG1} che risulta essere l’estensione che si desidera ascoltare.
Nel dialplan associato alle estensioni del centralino telefonico aggiungiamo una linea simile alla seguente:

exten => _*666X.,1,Macro(spy,${EXTEN:4})

Il supervisore quindi, semplicemente digita *666 seguito dall’estensione, digiterà la password e potrà iniziare l’ascolto telefonico.

La funzione ChanSpy ha differenti opzioni. Riportiamo le principali e più utili:
- b: Si spia solo i canali attivi su bridged calls.
- r([basename]): Registra la sessione di monitorizzazione nella directory spool di asterisk nel caso non sia presente un basename differente.
- w: ‘whisper’, il supervisore può parlare con l’agente che si sta spiando.
- W: ‘private ‘whisper’, il supervisore può parlare con l’agente che si sta spiando ma non può ascoltare il cliente.

Database: per aggiungere una data “bankholiday” al database asterisk si utilizzerà il comando ‘database’ come nell’esempio sottostante, sostiuendo la YYYYMMDD (key) con il giorno desiderato (es. 20101225):


asterisk -rx 'database put bankholiday YYYYMMDD 1'


Dialplan: la funzione DB_EXISTS restituirà valore 1 se la chiave YYYYMMDD esiste. Nel esempio sottostante il dialplan continuerà l’esecuzione della macro “reception” se il  giorno risulta non essere nel database, mentre salterà al menu vocale “menu-reception” durante i giorni festivi presenti nel db interno.


[macro-reception]
include = default
exten => s,1,GotoIf(${DB_EXISTS(bankholiday/${STRFTIME(${EPOCH},,%Y%m%d)})}?closed,1)
...
exten => closed,1,NoOp("closed")
...


… approfondimento qui

Consideriamo l’esempio di un centralino telefonico con un messaggio di benvenuto in due lingue, italiano e inglese. Per discriminare i numeri telefonici italiani ricerchiamo le cifre “0″ e “3″ rispettivamente per i numeri di rete fissa e i numeri gsm.

Tutte le chiamate che iniziano con una cifra differente o che si effettuano con il numero nascosto si rindirizzeranno sul messaggio in inglese.

exten => s,n,GotoIF(${REGEX(“^[3,0]” ${CALLERID(num):0:1})}”]?it,1:en,1)
exten => it,1,Background(welcome-it)
exten => it,n,…
exten => en,1,Background(welcome-en)
exten => en,n,…

Il cellulare si collegherà automaticamente alla struttura wireless grazie al modulo WiFi integrato, effettuando automaticamente il login sul server Asterisk. Un’icona sulla schermata principale del telefonino indicherà lo stato del servizio VoIP.

Asterisk interpreta il cellulare come qualcunque altro apparato VoIP e perciò non occorre nessuna configurazione specifica. Questa è la porzione più rilevante dell’output di un telefonino Nokia collegato ad Asterisk.

Codecs : 0×106 (gsm|ulaw|g729)
Codec Order : (g729:20,ulaw:20,gsm:20)
Auto-Framing: No
Status : OK (32 ms)
Useragent : E66-1 RM-343 200.21.118
Reg. Contact : sip:113@192.168.0.200;comp=sigcomp;transport=UDP

Per configurare un account SIP in sistemi Symbian basta seguire semplici passi come nell’esempio sottostante. Si assume come estensione Asterisk l’account sip “113″, password “1234″, server Asterisk raggiungibile all’indirizzo IP 192.168.0.200.

Menu –> Tools –> Settings –> Connections –> SIP settings
Service profile: IETF
Public user name: sip:113@192.168.0.200
Use Compression: NO
Registration: Always on
Use Security: NO
—> Proxy server
Proxy server address: sip:192.168.0.200
Realm: asterisk
User name: 113
Password: 1234
Allow loose rout.: YES
Transport type: UDP
Port: 5060
—> Registrar server
Registrar server address: sip:192.168.0.200
Realm: asterisk
User name: 113
Password: 1234
Allow loose rout.: YES
Transport type: UDP
Port: 5060

Menu –> Tools –> Settings –> Connections –> Internet telephone
Options –> New profile, select SIP profile