Nuevo dominio

Hola amigos…

Poseemos nuevo dominio al cual pertenece este blog y es:

www.cosmosnet.co

Voicemail, configuracion

El proyecto P.I.C.A pretende tener un servicio de mensajes de voz que se envian a cualquier servidor de correo electronico o un sevidor de correos “local”.

Para empezar, asterisk permite tener dos diversos tipos de almacenamiento para estos mensajes, y son:

Almacenamiento ODBC (por medio de una base de datos)

Almacenamiento IMAP (por medio de un servicio IMAP)

En el momento de la compilacion de asterisk 1.4.21 en la opcion que a continuacion aparece:

9.  Voicemail Build Options
**************************************************
Asterisk Module and Build Option Selection
**************************************************

Press ‘h’ for help.

( ) 1.  ODBC_STORAGE
[ ] 2.  IMAP_STORAGE

Podemos seleccionar esta opcion.

Desde mi punto de vista personal y por la experiencia que me encontre al intentar configurar asterisk con IMAP, no les recomiendo para NADA esta opcion, o por lo menos en la version 1.4.21. No entrare en detalles.

Como el proyecto P.I.C.A No tendra una base de datos, tampoco se empleara esta opion, por lo que recomiendo no habilitarlas y tener en nuestro servidor Linux Centos un servicio de correo electronico como SENDMAIL ya que con este se envian correos electronicos de una manera automatica, solamente editando algunas cosas del voicemail.

En esta excelente pagina, que dicho sea de paso me ha servido demasiado y cuyo autor es un caballero, podran encontrar un paso a paso de la configuracion correcta del voicemail yo me encargare de dar algunos consejos y algunas cosas que se omitieron alli:

http://www.voztovoice.org/?q=node/53

Para empezar con mis consejos, primero que todo esta pagina es una excelente guia y ayuda pero tengan en cuenta lo siguiente:

Por cada usuario del sistema operativo, se crea automaticamente un usuario de correo voicemail, y podemos tener un servicio de webmail como squirrelmail para poder visualizar nuestro servidor de correos como usuarios de este.

En la parte del archivo de configuracion voicemail.conf, es importante en esta opcion:

mailcmd=/usr/sbin/sendmail -t

Empelar un usuario de correo que se encargara de enviar a los diversos correos el archivo de voicemail del mensaje que se deja y se hace de la siguiente forma:

Partamos de la base que hemos configurado en el sistema un usuario que se encargara de esta operacion, puede ser asterisk y la opcion en el archivo quedara asi:

mailcmd=/usr/sbin/sendmail -v -t -f asterisk@correo

con esta opcion estamos autorizando un usuario diferente al usuario root del sistema, para que se encargue de esta operacion.

En la parte de usuarios voicemail es importante tener en cuenta:

configurar correctamente y apropiadamente los usuarios en los archivos extensions.conf sip.conf (o iax.conf, depende el protocolo que se emplee) y por supuesto voicemail.conf

Vayamos por partes, en el archivo sip.con es importante que cada usuario que se cree tenga la opcion:

mailbox=usuario@default

De lo contrario no se enviaran los mensajes de voz porque el asterisk NO reconoco como un usuario valido.

En el dialplan y el archivo extensions.conf es importante emplear la funcion:

Voicemail o VoicemailMain por ejemplo:

Digamos que se posee una extension con el numero 10

[10]

exten => 10,1,Answer()

;exten => 10,n,VoiceMail(10@default,u)

exten =>10,n,Hangup()

En el anterior dialplan nos estamos asegurando que el mensaje sera enviado al correo que corresponde en voicemail para la extension 10

La u en la funcion voicemail, corresponde al tipo de mensaje que se dara, en este caso a no esta disponible la xtension en el momento.

En la parte del archivo voicemail.conf, debemos tener:

10 => 10, Usuario sip , correo_usuario_sip@micorreo

Es importante verificar que esten editados correctamente estos items en los tres archivos anteriores.

 

Extensions.conf, el archivo para crear el dialplan

El dialplan esta contenido en el archivo extensions.conf que a su vez se ubica en el directorio /etc/asterisk, este archivo es una especie de script donde viene detallado la configuracion de nuestras extensiones.

Extensions.conf
Como se expreso anteriormente, este archivo permite tener la configuracion de las extensines y para empezar detallaremos en que consiste y como esta conformado este archivo.
Extensions.conf esta compuesto de tres partes funda,mentales que son [general] y [globals]

Contexto [general]
El contexto [general] configura unas pocas opciones generales como son:
static: Indica si se ha de hacer caso a un comando “save dialplan” desde la consola. Por defecto es “yes”. Funciona en conjunto con “writeprotect”
writeprotect: Si writeprotect=no y static=yes se permite ejecutar un comando “save dialplan” desde la consola. El valor por defecto es ” no” .
autofallthrough: Si está activado y una extensión se queda sin cosas que hacer termina la llamada con BUSY, CONGESTION o HANGUP Si no está activada se queda esperando otra extensión. Nunca debería suceder que una extensión se quede sin cosas que hacer como explicaremos posteriormente.
clearglobalvars: Si está activado se liberan las variables globales cuando se recargan las extensiones o se reinicia Asterisk.
priorityjumping: Si tiene valor ‘yes’, la aplicación soporta ‘jumping’ o salto a diferentes prioridades. En desuso
En general estas opciones no son muy importantes y se pueden dejar tal y como aparecen por defecto.

Contexto [globals]
En este contexto se definen las variables globales que se van a poder utilizar en el resto de los contextos. Por ejemplo
CONSOLE=Console/dsp: indica que cuando hagamos referencia a la variable CONSOLE estamos llamando a /Console/dsp
Las variables suelen ponerse siempre en mayusculas para diferenciarlas posteriormente.
Las variables suelen ponerse siempre en mayusculas para diferenciarlas posteriormente.
contexts, extensions, y variables

Context
El contexto evita que las extensiones entren en una confusion, ya que por medio de este le podemos dar y asignar ciertas caracteristicas, despues mas adelante del manual, se explicara con un ejemplo sencillo.
El nombre del contexto debe ir entre corchetes de este tipo [nombre_contexto], cada contexto tiene una lista de comandos y las diversos usuarios sip o iax pueden pertenecer a estos contextos. Un dialplan puede contar con diversos contextos en la configuración.

Extensions

Las extensiones poseen la siguiente sintaxis:

exten => EXTENSION, PRIORIDAD, COMANDO(ARGUMENTOS)

Existen numerosos comandos o funciones en el dialplan y se especificaran mas en detalle en el punto “Principales funciones o comandos del dialplan”.

Existen 3 tipos de extensiones que son:
constant extension
wildcard extension,
special extension

Funciones del dialplan

El dialplan maneja una serie de funciones que son la base de la configuracion de asterisk, a continuacion estan explicadas de una manera general, esta lista fue tomada de:

http://voip.megawan.com.ar/doku.phpasterisk_funciones_del_dialplan

Funciones generales

• Función Authenticate: Autenticar a un usuario
• Función VMAuthenticate: Autenticar a un usuario basado en el archivo voicemail.conf
• Función Curl: Permite obtener URLs externos. También soporta el posteo. Ha sido reemplazado por CURL.
• Función DUNDiLookup: buscar un número usando DUNDi
• Función Page: enviar un mensaje Pager (nuevo en asterisk versión 1.2)
• Función SendDTMF: Envía dígitos DTMF
• Función SendImage: Envia un archivo de imagen
• Función SendText: Enviar a un cliente un mensaje de texto
• Función SendURL: Enviar a un cliente una URL para mostrar
• Función System: Ejecutar un comando del sistema
• Función Transfer: Transferir al usuario que llama a un interno remoto.
• Función TrySystem: Ejecutar un comando del sistema y siempre retornar 0
• Función Wait: Espera por una cierto tiempo
• Función WaitExten: Espera por una cierto tiempo
• Función WaitForRing: Espera a la aplicacion Ring
• Función WaitMusicOnHold: pone música en espera

Administración de llamadas

• Función Answer: Contestar un canal si suena
• Función Busy: Indicar la condición de ocupado y esperar el corte
• Función ChanIsAvail: Comprobar si el canal está disponible
• Función Congestion: Indicar congestión y esperar el corte
• Función Dial: Establecer una llamada y conectarla con el canal actual
• Función DISA: DISA (Acceso directo al sistema interno)
• Funcion Hangup: corte incondicional
• Función RetryDial: Hacer una llamada, reintentando en caso de falla permitiendo un interno opcional de salida.
• Función Ringing: Indicar el ringing

Identificación del que llama

• Función CallingPres: Cambiar la presentación para el callerid
• Función LookupBlacklist: buscar el nombre/número de CallerID en la lista negra de una base de datos.
• Función LookupCIDName: buscar el nombre de CallerID de una base de datos local.
• Función PrivacyManager: Requerir que se ingrese el número de teléfono si no se envió ningún CallerID.
• Función SetCallerID: setea el CallerID. Ha sido reemplazado por CALLERID.
• Función SetCallerPres: Ajuste independiente de canal para la presentacion del que llama.
• Función SetCIDName: Fija el nombre de CallerID. Ha sido reemplazado por CALLERID.
• Función SetCIDNum: Fija solamente el número de identificación del que llama (no el nombre). Ha sido reemplazado por CALLERID.
• Función SoftHangup: hace un Hangup en otro canal
• Función Zapateller: Bloquea a los telemarketers

ADSI

• Función ADSIProg: Cargar scripts ADSI de Asterisk en un teléfono
• Función GetCPEID: Obterner la identificación de CPE ADSI.

Manejo de la base de datos

• Función DBdel: Suprimir un valor de la base de datos.
• Función DBdeltree: Suprimir una familia o arbol de valores de la base de datos.
• Función DBget: Obtener un valor de la base de datos. Ha sido reemplazado por la Función DB.
• Función DBput: Almacenar un valor en la base de datos. Ha sido reemplazado por la Función DB.
• Función MYSQL: Realiza varias actividades en la base de datos de MySQL
• Función DBQuery: Ejecuta sentencias predefinidas en servidores de MySQL, y envia los resultados nuevamente al dialplan.

Ver base de datos de asterisk para más información.

Integración de Aplicaciones

• Función AGI: Ejecuta una aplicación de AGI
• Función DeadAGI: Ejecuta un AGI en un canal colgado
• Función EAGI: Ejecuta una aplicación de AGI
• Función EnumLookup: busca un numero en ENUM
• Función ExternalIVR: Ejecuta un generador de IVR externo
• Función Macro: implementación de macros
• Función NoOp: Ninguna operación. Puede imprimir valores en la consola para debuggear.
• Función Perl: el res_perl es el mod_perl de Apache, pero para el asterisk
• Función PHP: integra PHP en asterisk sin necesidad de AGI
• Función Read: Lee una variable con DTMF
• Función TXTCIDName: busca el nombre del que llama de un registro TXT
• Función UserEvent: Enviar un acontecimiento arbitrario a la interfaz de manager

Control de flujo y tiempos

• Función AbsoluteTimeout: setea el tiempo máximo absoluto para una determinada llamada
• Función DigitTimeout: Fija el intervalo máximo entre los dígitos
• Función Gosub: Saltar a una subrutina y volver
• Función GosubIf: Salto condicional a una subrutina y vuelta
• Función Goto: ir a una prioridad particular, un interno, o un contexto particular
• Función GotoIf: función Goto condicional
• Función GotoIfTime: Goto condicional en el tiempo actual
• Función Random: Hacer un salto al azar en tu dialplan
• Función ResponseTimeout: setea el máximo tiempo de espera de respuesta
• Función Return: retorno de un Gosub o de un GosubIf
• Función StackPop: borra una direccion de retorno sin volver
• Función While: Comienza un loop While
• Función EndWhile: Terminar un loop While
• Función ExecIf: Exec condicional

Manipulación de variables y strings

• Función ImportVar: setear el valor de una variable
• Función Math: Realiza cálculos (simples). Ha sido reemplazada por la Función MATH.
• Función SetGlobalVar: setear el valor de una variable. Ha sido reemplazada por la Función GLOBAL.
• Función Set: setea las variables de canal o los valores de las funciones
• Función DBRewrite: Ejecuta expresiónes regulares de Perl y substituciónes desde una base de datos de MySQL.

Sonidos: Playback

• Función Background: poner un sonido mientras que se ejecutan otros comandos
• Función BackgroundDetect: pone un sonido de fondo y activa la deteccion de habla.
• Función ControlPlayback: pone un sonido con controles de rebobinado, adelanto y de salida.
• Función DateTime: Decir la fecha y/o el tiempo (obsoleto)
• Función Echo: envia un eco de todo lo que dice el usuario
• Función Festival: decir un texto con el sintetizador de voz Festival
• Función Flite: decir un texto con el sintetizador de voz Festival Lite (tiene una respuesta más rápida que el Festival)
• Función Milliwatt: Genera un tono constante de 1000Hz en 0dbm (ulaw)
• Función MP3Player: pone un sonido MP3
• Función MusicOnHold: pone música en espera indefinidamente
• Función Playback: pone un sonido
• Función Playtones: pone una lista de tonos mientras que ejecuta otros comandos
• Función Progress: poner audio temprano al que llama antes de contestar la línea
• Función SayUnixTime: Decir la fecha y/o tiempo
• Función SayAlpha: dice Alfa
• Función SayDigits: dice dígitos
• Función SayNumber: dice números
• Función SayPhonetic: dice fonética
• Función SetMusicOnHold: setea la clase de música en espera por default
• Función SetLanguage: Cambia el lenguaje para los archivos de sonido
• Función StopPlaytones: deja de poner una lista de tonos

Ver los archivos de sonidos del asterisk para más información.

Sonidos: Grabación y Monitoreo

• Función ALSAMonitor: monitorear la consola de ALSA
• Función ChangeMonitor: Cambiar el nombre del fichero de monitoreo de un canal
• Función ChanSpy: Escucha una llamada
• Función Dictate: grabar y reproducir un dictado
• Función MixMonitor: Graba y mezcla los 2 canales de una llamada nativamente.
• Función Monitor: grabar una conversación de teléfono a un archivo de sonido
• Función Record: grabar la entrada de voz de un usuario a un archivo
• Función StopMonitor: deja de monitorear un canal

Funciones SIP

• Función SIPdtmfMode: Cambia el modo DTMF de una llamada SIP
• Función SIPGetHeader: Obtiene cualquier encabezado de un mensaje SIP INVITE ( substituido por SIP_HEADER() )
• Función SIPAddHeader: Agrega un encabezado a un mensaje SIP INVITE de salida.

Funciones ZAP

• Función Flash: envia un Flash en un Trunk Zap
• Función ZapBarge: escucha en un canal Zap
• Función ZapSendKeypadFacility: Envia dígitos fuera de banda sobre una PRI
• Función ZapRAS: Proporcionar un servicio de datos ISDN
• Función ZapScan: explorar los canales Zap para monitorear llamadas

Ver canales ZAP de Asterisk, zapata.conf para más información.

Voicemail y Conferencias

• Función Directory: Proporcionar un directorio de internos del voicemail
• Función HasNewVoicemail: si hay nuevo voicemail salta a la prioridad + 101
• Función MailboxExists: Comprueba si existe la casilla
• Función MeetMe: conferencia simple MeetMe
• Función MeetMeAdmin: Administración de la conferencia de MeetMe
• Función MeetMeCount: Conteo de participantes de una conferencia MeetMe
• Función VoiceMail: Dejar un mensaje de voicemail
• Función VoiceMailMain: Ingresar al sistema de voicemail
• Función VMAuthenticate: Autenticar un usuario basado en el archivo voicemail.conf

Ver voicemail.conf para más información.

Colas de espera y administración de Agentes

• Función AddQueueMember: Agrega dinámicamente miembros de la cola de espera
• Función AgentCallbackLogin: callback a un agente
• Función AgentLogin: pide al agente que se logee
• Función AgentMonitorOutgoing: graba la llamada saliente del agente
• Función ParkAndAnnounce: estacionar una llamada y anunciarla
• Función ParkedCall: Contestar una llamada estacionada
• Función PauseQueueMemeber: pone en pausa a un agente
• Función Queue: pone una llamada entrante en una cola de espera
• Función RemoveQueueMember: Quita dinámicamente a miembros de una cola de espera
• Función UnpauseQueueMemeber: Rehabilita a un agente

Alarma de Monitoreo

• Función AlarmReceiver: Emular el protocolo Contact ID receptor de alarmas de Ademco

Radio Amateur

• Función Rpt: soporte para conectar Radio aficionados y repetidores comerciales de 2 vias

Funciones externas (no estan en el CVS)

• Función App_dbodbc: Modificandores del Dialplan usando unixODBC
• Función DynExtenDB: Almacenar los internos en una base de datos
• Función Iconv: convertir sets de caracteres.
• Función LDAPget: Obtener un valor de un servidor de directorio LDAP
• Función CallingCard: Diseñada para Postgres
• Función PPPD: Conector al demonio de PPP
• Función Backticks: Almacenar el resultado de un comando del shell en una variable de Asterisk
• Función ASR: reconocimiento de voz multilingue profesional para el asterisk

Aplicaciones Bristuff y zaphfc

• Función PickUp: atender un canal
• Función PickUpChan: Tomar el canal especificado
• Función PickDown: Colgar una llamada que suena
• Función Steal: Asumir el control de una llamada establecida
• Función Devstate: Generar un evento de cambio de estado del dispositivo (en uso, ocupado, sonando)
• Función Segfault: Matar al Asterisk con un segfault
• Función ZapEC: Permitir o anular la cancelación de eco para Zap

Funciones para los canales Sirrix

• Función SrxEchoCan: Inhabilitar/permitir la cancelación de eco
• Función SrxDeflect: Desviar una llamada entrante
• Función SrxMWI: setear/resetear MessageWaitingIndication (MWI) en un grupo de Sirrix

Archivos configurables asterisk

La configuración principal de ASTERISK se basa entre otros, en los siguientes archivos de configuración:
zaptel.conf / zapata.conf: Configuración de líneas y extensiones analógicas y digitales.

capi.conf: Configuración de líneas y extensiones RDSI básicas.

sip.conf: Configuración de extensiones y conexiones con Operadores IP u otros ASTERISK.

h323.conf / oh323.conf: Configuración de conexiones con Operadores IP.

mgcp.conf: Configuración de extensiones MGCP.

iax.conf: Configuración de extensiones y conexiones con Operadores IP u otros ASTERISKs.

voicemail.conf: Configuración del Sistema de Mensajería.

extensions.conf: Configuración del Plan de numeración interno y externo.

musiconhold.conf: Configuración del Sistema de música en espera.

res_odbc.conf: Configurar odbc para base de datos utilizada en asterisk.
Existen ademas mas archivos de configuracion que se utilizan dependiendo las necesidades de la implementacion que se desee implementar, entreo otrso tenemos:

adsi.conf, cdr_tds.conf, indications.conf, privacy.conf, adtranvofr.conf, codecs.conf, logger.conf, queues.conf, agents.conf, dnsmgr.conf manager.conf, res_odbc.conf, alarmreceiver.conf, dundi.conf,  meetme.conf , rpt.conf, alsa.conf, enum.conf, mgcp.conf         rtp.conf, asterisk.adsi, extconfig.conf, misdn.conf,  asterisk.conf, extensions.ael   modem.conf, sip_notify.conf, cdr.conf,   modules.conf, skinny.conf, cdr_custom.conf, features.conf,  telcordia-1.adsi, cdr_manager.conf    festival.conf, osp.conf,  cdr_odbc.conf, iax.conf, oss.conf, vpb.conf, cdr_pgsql.conf, iaxprov.conf, phone.conf

A medida que vayamos avanzando, trataremos de explicarlos todos los archivos configurables en asterisk.