Actualizado 08 septiembre 2009

En el archivo voicemail.conf es donde se configura todo lo relacionado con el buzon de voz. Si recibimos una llamada y no contestamos o la línea está ocupada, entrará en función el contestador, grabará el mensaje de voz dejado por quien llama y nos enviará un correo electrónico para avisarnos. Además podemos anexar el mensaje de voz al correo electrónico en el formato audio que nos más guste. Este archivo se encuentra normalmente en la carpeta /etc/asterisk (distribución Centos).

Mostraré todas las opciones que podemos configurar. Todas las opciones/parámetros que tienen un punto y coma por delante es porque no las estoy usando en mi configuración

__________________________________________________________________________________________

; Correo de voz Configuración

[general]

format=gsm|wav ; el codec audio utilizado para grabar los mensajes de voz dejados en el contestador

serveremail=asterisk@voztovoice.org ; el remitente del correo electrónico que nos avisa de una nuevo mensaje de voz

attach=yes ; Si attach está en yes el mensaje de voz se enviará como anexo al correo electronico
maxmsg=100 ; numero máximo de mensajes de voz para cada casilla configurada
maxsecs=300 ; numero máximo de segundos por cada mensaje  de voz

minsecs=3 ; numero mínimo de segundos para que un mensaje de voz sea reconocido como tal y enviado a la casilla del destinatario.

maxgreet=60 ; podemos grabar un mensaje de bienvenida para nuestro buzon de voz personal. Este parámetro define la duración máxima del mensaje

skipms=3000 ; cuando escuchamos los mensaje de voz, si configurado, podemos usar el teclado para adelantar o atrasar el mensaje mismo. Por ejemplo: hundiendo el numero 8 nos adelantamos de 3000 milisegundos, es decir 3 segundos, con el 9 nos devolvemos de 3 segundos

maxsilence=10 ; si mientras se graba un mensaje de voz hay un silencio de 10 segundos, la llamada se termina y también la grabación

silencethreshold=128 ; este numero representa el nivel de audio y  sirve para definir que se considera silencio. Más bajo el numero, más sensible al ruido

maxlogins=3 ; numero máximo de veces que nos podemos equivocar insertando la contraseña para entrar a nuestra buzon de voz

moveheard=yes ; Una vez escuchados los mensajes de voz podemos pasarlos a la carpeta OLD (viejos) en automático sino tenemos que hacerlo desde el menú del contestador

userscontext=default ; el contexto predefinido para los usuarios de las casillas de voz

;externnotify=/usr/bin/myapp ; si cada vez que recibimos un mensaje de voz queremos arrancar un programa tenemos que configurarlo aquí

;smdienable=yes ; esto es para configurar SMDI (Simple Message Desk Interface).
;smdiport=/dev/ttyS0 ; pueden encontrar más información en la carpeta doc de las fuentes de asterisk

;externpass=/usr/bin/myapp ; Si queremos que un programa arranque cada vez que cambiamos la contraseña de nuestro buzon de voz tenemos que configurarlo aquí

;externpassnotify=/usr/bin/myapp ; si externpass está configurado y queremos que la contraseña se actualice también en voicemail.conf tenemos que configurar este parámetro

directoryintro=dir-intro ; el mensaje de introducción de la aplicación directory (para buscar las extensiones en la centralita)

charset=ISO-8859-1 ; el estándar ISO para los mensajes de texto que se enviaran para notificar la llegada de un nuevo mensaje de voz

pbxskip=yes ; quitar la la abreviación [PBX] en el remitente del mensaje

fromstring=VozToVoice ; el nombre que aparecerá como remitente del correo electrónico

usedirectory=yes ; Los mensajes de voz que recibimos podemos reenviarlos a otro usuarios/extensiones del servidor Asterisk. También podemos dejar directamente mensajes de voz en determinados buzones. Esta opción permite buscar en el directorio la persona a la que queremos dejar o reenviar el correo de voz

;odbcstorage=asterisk ;podemos guardar los mensajes de voz en un base de datos usando el driver ODBC. Aquí es donde hay que configurar esta opción

;odbctable=voicemessages; el nombre de la tabla de la base de datos donde guardar los mensajes de voz

; Change the from, body and/or subject, variables:
;     VM_NAME, VM_DUR, VM_MSGNUM, VM_MAILBOX, VM_CALLERID, VM_CIDNUM,
;     VM_CIDNAME, VM_DATE
;
; Note: The emailbody config row can only be up to 512 characters due to a
;       limitation in the Asterisk configuration subsystem.
;emailsubject=[PBX]: New message ${VM_MSGNUM} in mailbox ${VM_MAILBOX}
; The following definition is very close to the default, but the default shows
; just the CIDNAME, if it is not null, otherwise just the CIDNUM, or "an unknown
; caller", if they are both null.
;emailbody=Dear ${VM_NAME}:\n\n\tjust wanted to let you know you were just left a ${VM_DUR} long message (number ${VM_MSGNUM})\nin mailbox ${VM_MAILBOX} from ${VM_CALLERID}, on ${VM_DATE}, so you might\nwant to check it when you get a chance.  Thanks!\n\n\t\t\t\t--Asterisk\n

Todo el bloque de arriba son las variables y el texto del correo electrónico que enviaremos para notificar la llegada de un nuevo mensaje de voz. Lo podemos modificar y adaptarlo a nuestras exigencias.

pagerfromstring=VozToVoice ; si enviamos un aviso también a un Pager esta línea define el remitente del mensaje
pagersubject=Nuevo VM ; el objeto del mensaje al Pager
pagerbody=Nuevo mensaje de ${VM_DUR} de duración en la casilla ${VM_MAILBOX}\nde ${VM_CALLERID}, en ${VM_DATE} ; el cuerpo del mensaje

mailcmd=/usr/sbin/sendmail -t ; sendmail es el programa predefinido para enviar los correos electrónicos

; Si en lugar ODBC queremos usar el protocolo IMAP para guardar nuestros mensajes de voz, aquí va indicada la ;configuración.

;imapgreetings=no; para guardar el mensaje de bienvenida en la carpeta de IMAP.  Igual a no si no usamos IMAP

;greetingsfolder=INBOX ; Si imapgreetings es igual a yes aquí es donde definimos la carpeta donde guardar el mensaje audio de bienvenida

;imapparentfolder=INBOX ; si queremos crear una carpeta dentro de la carpeta INBOX para cada buzon de voz

tz=central ; huso horario predefinido para indicar la fecha y la hora del correo de voz recibido

attach=yes; Si es igual a yes el mensaje de voz se anexará al correo electrónico de notifica

attachfmt=wav El formato audio con que se enviará el mensaje audio anexo al correo electrónico

saycid=yes; Si es igual a yes antes de escuchar el correo de voz se escuchará el identificativo (numero de teléfono o extensión) de quien lo dejó

sayduration=no; Anunciar o no la duración del correo de voz

saydurationm=2; Definir la duración mínima del correo de voz para que sea anunciada (en minutos)

dialout=phones; Contexto de utilizar para efectuar llamadas desde el menú del contestador [opción 4 del menú avanzado]

sendvoicemail=yes ; permitir o no de enviar un correo de voz a otra extensión [opción 5 del menú avanzado]

; callback=fromvm; Contexto para llamar desde el menu del buzon de voz al remitente de un mensaje de voz

; exitcontext=fromvm ; Contexto donde enviar el usuario si mientras usa los menú del buzon  oprime el tecla * o 0

review=yes; Si es igual a yes permite a quien está dejando un correo de voz de escucharlo antes de enviarlo

; operator=yes; permite a quien llama de presionar 0 antes/después/mientras está dejando un correo de voz para buscar una operadora

; envelope=no ; antes de reproducir el mensaje audio, reproduce los datos del mensaje

; delete=yes; Si es igual a yes y activado una vez que se notifique la llegada de un correo de voz, éste se borrará del servidor

; volgain=0.0; si el correo de voz se grabó con un volumen muy bajo con esta opción podemos mejorar su calidad. Para que se pueda utilizar debemos tener instalado sox

; nextaftercmd=yes; ir al correo de voz que sigue si presionamos las teclas 7 o 9 (borrar/guardar el mensaje corriente)

forcename=yes; Obligar cada usuario con buzon de voz a grabar su nombre la primera vez que accede. Un usuario se considerará nuevo si su contraseña coincide con el numero de su extensión

forcegreetings=no; parecido al de arriba. Obliga el nuevo usuario a grabar un mensaje de bienvenida

hidefromdir=no; el usuario no aparecerá en el directorio

tempgreetwarn=yes; recordar al usuario que el mensaje de bienvenida temporáneo es él que se está usando

;vm-password=custom_sound ; configurar un archivo de voz distinto para pedir la contraseña de la casilla

; vm-newpassword=custom_sound ; como arriba para cuando se avisa de insertar una nueva contraseña para el buzon
; vm-passchanged=custom_sound ; Voz personalizada para decir "Tu contraseña ha sido cambiada"

; vm-reenterpassword=custom_sound ; Voz personalizada para decir "Introduce nuevamente tu contraseña seguida del botón numeral

; vm-mismatch=custom_sound; Voz personalizada de "la contraseña insertada y repetida no son iguales"

listen-control-forward-key=# ; tecla numérica para adelantar el mensaje que se está escuchando

listen-control-reverse-key=*; tecla numérica para ir atrás en el mensaje que se está escuchando

listen-control-pause-key=0; tecla numérica para poner en pausa el mensaje

listen-control-restart-key=2; tecla numérica para volver a escuchar el mensaje desde el inicio

listen-control-stop-key=13456789; teclas numéricas para parar el mensaje y volver al menú del contestador

backupdeleted=100; numero máximo de mensajes en la carpeta "borrados"

[zonemessages]
colombia=America/Bogota|'vm-received' aebY 'digits/at' HM
eastern=America/New_York|'vm-received' Q 'digits/at' IMp
central=America/Chicago|'vm-received' Q 'digits/at' IMp
central24=America/Chicago|'vm-received' q 'digits/at' H N 'hours'
military=Zulu|'vm-received' q 'digits/at' H N 'hours' 'phonetic/z_p'
european=Europe/Copenhagen|'vm-received' a d b 'digits/at' HM

; En el bloque de arriba definimos la zonas horarias que podemos usar en el contestador. Si por ejemplo tenemos usuarios de distintos continentes, podemos definir por cada uno su huso horario y de esta forma configurar la fecha y hora exactas de los mensajes de voz de su buzon

[default] ; aquí empieza la configuración de las casillas para los usuarios pertenecientes al contexto default

;maxmsg=50 ; define el numero máximo de correos de voz por cada carpeta de un determinado contexto (en este caso el contexto es default)

;cada casilla sigue estas reglas

numero extensión => contraseña, nombre apellido, correo electrónico, correo pager,opciones separadas por el signo |

Aquí abajo van algunos ejemplos
;4200 => 9855,Mark Spencer,markster@linux-support.net,mypager@digium.com,attach=no|serveremail=myaddy@digium.com|tz=central|maxmsg=10
;4300 => 3456,Ben Rigas,ben@american-computer.net
;4310 => -5432,Sales,sales@marko.net,,tz=colombia
;4069 => 6522,Matt Brooks,matt@marko.net,,|tz=central|attach=yes|saycid=yes|operator=yes|moveheard=yes|sayduration=yes|saydurationm=1
;4073 => 1099,Bianca Paige,bianca@biancapaige.com,,delete=1
;4110 => 3443,Rob Flynn,rflynn@blueridge.net
;4235 => 1234,Jim Holmes,jim@astricon.ips,,Tz=european

[other] ;other es otro contexto con sus opciones y sus usuarios (por ejemplo si el mismo servidor está siendo utilizado por dos empresas distintas

;directoryintro=dir-company2; mensaje de bienvenida del directorio de la empresa 2
;1234 => 5678,Company2 User,root@localhost

;[acme] ; tercero contexto para otra empresa
;tz=eastern
;111 => 7383,Pete,pete@acme-widgets.com,,tz=central
;112 => 6262,Nancy,nancy@acme-widgets.com
__________________________________________________________________________________________

Ahora que tenemos nuestro contestador bien configurado como lo utilizamos en nuestra centralita? Tenemos que modificar el archivo extensions.conf y añadir algo parecido en el contexto donde tienen acceso las extensiones de nuestra centralita.

[internal]

exten => 97,1,Answer(); abre el canal (contesta)
exten => 97,n,VoiceMailMain(${CALLERID(num)}@default); envía la llamada directamente a la casilla de la extensión que está llamando en el contexto default
exten => 97,n,Hangup(); termina la llamada

97 es el numero que desde nuestro teléfono IP o softphone tenemos que marcar para acceder a nuestra casilla personal

exten => 2000,1,Dial(SIP/2000,30,r); llamada a la extensión 2000 por 30 segundos. Quien llama escuchará el sonido del timbre (opción r)
exten => 2000,n,GotoIf($["${DIALSTATUS}" = "BUSY"]?busy:unavail); según si la línea está ocupada o nadie contesta se continuará en el dialplan en las prioridadades definidas con las etiquetas (unavail), no disponible, o (busy), ocupado.
exten => 2000,n(unavail),Voicemail(2000@default,u); se activará el contestador anunciando que la extensión llamada no está disponible (opción u) y después del tono podremos dejar un mensaje
exten => 2000,n,Hangup(); se terminará la llamada
exten => 2000,n(busy),VoiceMail(2000@default,b); se activará el contestador anunciando que la extensión llamada está ocupada (opción b) y que despues del tono podremos dejar un mensaje
exten => 2000,n,Hangup(); se terminará la llamada

Complicado? No se :)