Manual Consola de Agente WebRTC

Rev 1.1

Manual Consola de Agente

WebRTC

By mreyesvera@digital-merge.com
1

Manual Consola de Agente WebRTC

Rev 1.1

Introduccin.
Gracias por instalar el Addon Consola de Agente WebRTC. Este Addon le permitir tener una consola
de agente para el mdulo de Call Center de Elastix con un telfono y servicio de Mensajera
Instantnea basados en el API WebRTC SIPML5 embebidos en dicha consola.

Background.
Este conjunto de RPMs provee el soporte para el gateway WebRTC2SIP de la empresa Doubango, as
como la edicin de la consola de agente del mdulo de callcenter para usar un telfono basado en la
API SIPML5 tambin de la empresa Doubango.

Notas.
Esta diseado solo para trabajar en modo CallBack Login en la consola de agente del mdulo de
callcenter, ya que al ser una API basada en javascript al refrescar la pgina se pierde el registro y por
ende la conexin con la consola de agente del mdulo de callcenter.
El soporte de WebRTC en los exploradores es muy limitado es por esta razn que se recomienda usar
Google Chrome solamente.

Tabla de Dependencias.
Paquete
elastix-agent_console_webrtc-0.11.noarch
webrtc2sip-2.5.1r114-DMv1Elastix.i386.rpm
doubango-2.0r985-DMv1.i386.rpm

ffmpeg-1.2-DMv1.i386.rpm
x264-snapshot20130810.2245DMv1.i386.rpm
libvpx-1.2.0-DMv1.i386.rpm
yasm-1.2.0-DMv1.i386.rpm
libsrtp-1.4.5-DMv1.i386.rpm
libtool-2.4.2-DMv1.i386.rpm

Dependencias

Descripcin

webrtc2sip, elastix-callcenter

Provee el telfono web en la consola de

agente del mdulo de callcenter.
Screen, doubango framework
Provee el media gateway webrtc2sip
para la interaccin websocket<>asterisk.
Libtool, ffmpeg, openssl, libvpx, libsrtp Provee el framework para que el
gateway
webrt2sip
trabaje
correctamente.
Libvpx, x264, yasm, libvpx
Provee el soporte de conversin al
gateway webrtc2sip.
Provee el codec x264 al gateway
webrtc2sip.
Provee el codec VP8 al gateway
webrtc2sip.
Facilita la compilacin de FFMPEG.
Provee srtp al gateway webrtc2sip.
Facilita la compilacin del framework
de doubango.

By mreyesvera@digital-merge.com
2

Manual Consola de Agente WebRTC

Rev 1.1

Instalacin.
Para instalar el Addon descrguelo desde el MarketPlace de Elastix o bien desde la consola de Linux
ejecute:
yum install y elastix-agent_console_webrtc-0.1-1.noarch

Configuracin del Servicio de Chat.

El servicio de chat viaja a travs de SIP, y es el servidor Asterisk quien se encarga de manejar, procesar
y entregar los mensajes de texto. Es por esta razn que el servicio de mensajera requiere de la versin
11.5 de Asterisk para funcionar, versiones menores no sern capaces de entregar los mensajes de texto.
Para habilitar el servicio en el PBX debe seguir estos pasos:

1. Habilitar el acceso a "UNEMBEDDED PBX". Vaya al men SECURITYAdvanced y

habilite el acceso.
2. Vaya al men PBXUnembedded PBX e ingrese utilizando los datos que creo en el paso anterior.
3. Ir al men "tools"
4. Ir al submen "Asterisk Sip Settings"

By mreyesvera@digital-merge.com
3

Manual Consola de Agente WebRTC

Rev 1.1

5. Aadir el campo: accept_outofcall_message = yes

6. Dar click en Add Fields.
7. Aadir el campo: outofcall_message_context = sipsms

8. Salvar y recargar.

By mreyesvera@digital-merge.com
4

Manual Consola de Agente WebRTC

Rev 1.1

Operacin.
Una vez que se ha completado la instalacin se deber configurar el mdulo de call center para trabajar
en
modo
CallBack
Login
como
lo
describe
el
manual
oficial
del
mdulo(http://www.elastix.org/index.php/en/product-information/manuals-books.html#iccelxen).
Al acceder al men de Call Center aparecer un nuevo men llamado WebRTC Agent Console:

By mreyesvera@digital-merge.com
5

Manual Consola de Agente WebRTC

Rev 1.1

Deber acceder en modo Callback Login una vez que ingrese ver la siguiente consola de agente:

Ubicacin del Telfono.

Ubicacin de la consola de Mensajera Instantnea.

By mreyesvera@digital-merge.com
6

Manual Consola de Agente WebRTC

Rev 1.1

Elementos del Telfono.

Cuadro de texto para marcacin. Aqu aparecern los nmeros marcados antes y durante la
llamada.
Etiqueta del estado de la conexin. Aqu aparecer el estado de la conexin con el servidor
Asterisk.
Dialpad. Se utiliza para enviar dgitos o tonos DTMF durante la llamada.
Botn Call. En llamada saliente permite enviar la llamada. En llamada entrante cambiar el
texto a Answer y servir para contestar la llamada entrante.
Botn Hangup. En llamada activa se utiliza para terminar la llamada. En llamada entrante
cambiar el texto a Reject y servir para rechazar la llamada entrante.
Etiqueta de estado de la llamada. Aqu aparecer el estado de la llamada activa.

By mreyesvera@digital-merge.com
7

Manual Consola de Agente WebRTC

Rev 1.1

Ventana de Chat.

Lista de Contactos SIP. Aqu se desplegarn todos los contactos SIP creados desde el men del
PBX. Cabe mencionar que es probable que no todos los contactos estn usando la consola de
agente de WebRTC y al enviar un mensaje no pase nada. Al cambiar entre contactos la ventana
de chat limpiar el historial de la conversacin.
Mensaje de texto enviado. Todos los mensajes de texto enviados aparecern con el formato de la
imagen, precedidos por el smbolo >.
Mensaje de texto recibido. Todos los mensajes recibidos aparecern con el formato de la
imagen, precedidos por la hora en que se recibi el mensaje y el peer que lo enva.
Cuadro de texto para escribir los mensajes a enviar.
Botn SEND. Sirve para enviar los mensajes de texto, se puede presionar el botn o bien usar la
tecla ENTER.
By mreyesvera@digital-merge.com
8

Manual Consola de Agente WebRTC

Rev 1.1

Habilitar el uso de los medios de Audio.

La primera vez que se reciba o se haga una llamada ser necesario que usted habilite el uso de los
medios de audio en el explorador, si no hace esto no ser capaz de contestar o enviar una llamada.
Esto se logra presionando el Botn Permit o Permitir de la notificacin emergente debajo de la
URL:

Una vez que se da click en Permitir la llamada podr ser recibida o enviada.

Llamada saliente

Llamada Entrante

By mreyesvera@digital-merge.com
9

Manual Consola de Agente WebRTC

Rev 1.1

Gateway WebRTC2SIP.
El addon usa e media Gateway webrtc2sip para hacer la conexin de la llamada entre Asterisk y el
explorador web.
El Gateway es ejecutado durante la instalacin y aadido para ejecutarse durante el arranque del
sistema. El Gateway corre detrs de una sesin screen y puede acceder en cualquier momento a la
sesin con el comando:
screen r wrtc
Para salir de la sesin sin detener el Gateway utilice la combinacin de teclas: CTRL+A+D.

Detener el Gateway.
Para detener el media Gateway deber entrar en la sesin screen con el comando:
screen r wrtc
Y despus ejecutar: quit+ENTER.
Al detener el servicio ningn cliente podr utilizar la consola de Agente WebRTC.

Arrancando el Gateway.
Para ejecutar el Gateway despus de detenerlo por alguna tarea de depuracin ejecute el siguiente
comando:
screen -dmS wrtc /usr/local/sbin/webrtc2sip --config=/usr/local/sbin/config.xml

By mreyesvera@digital-merge.com
10

Manual Consola de Agente WebRTC

Rev 1.1

Configurando el Gateway.
El Gateway est configurado por default pero usted puede cambiar los DNS para un mejor
funcionamiento o la lista de codecs soportados.
El archivo de configuracin config.xml se encuentra en /usr/local/sbin. Para cambiar los DNS utilice
su editor de texto preferido y cambie la IP entre las lneas:
<nameserver id=1>10.0.1.1</nameserver>
<nameserver id=2>8.8.8.8</nameserver>
Para cambiar la lista de codecs soportados cambie las lneas:
<codecs>pcma;pcmu;gsm;</codecs>
Todos los cambios hechos requieren reiniciar el Gateway. Para ms informacin acerca de la
configuracin del Gateway vaya a esta URL: http://webrtc2sip.org/technical-guide-1.0.pdf

By mreyesvera@digital-merge.com
11

Manual Consola de Agente WebRTC

Rev 1.1

FAQS
1. Necesito acceso a Internet aunque este en mi RED LOCAL?
S, es necesario el uso de internet para tener acceso a los servidores ICE que determinarn la IP
a usar en la transaccin SDP.
2. Estoy dentro de una RED LOCAL, sin embargo, el SDP usa la IP Pblica de mi RED y no tengo
audio. Qu puedo hacer?
Por alguna razn los servidores ICE determinaron que la mejor IP a usar era la IP pblica y esto
causa que no haya audio una solucin al problema es editar el archivo:
/var/www/html/modules/agent_console_webrtc/themes/default/js/ml5.js
Descomentar la lnea de los servidores ICE y cambiarla por esto:
ice_servers: [{url:stun:null}],
De este modo usar siempre la IP local.
3. Entra una llamada, contesto, pero el audio tarda unos segundos en aparecer. Qu puedo
hacer?
Esto tambin se debe a que la negociacin del servidor ICE no ha terminado, para obtener el
audio en una RED LOCAL de forma inmediata aplicar la solucin del punto 2. Para una red
remota no hay solucin.

4. El Gateway tiene soporte para G729?

No, el Gateway no tiene soporte para G729, por ahora solo soporta G711, GSM y algunos
codecs de video no habilitados.
5.

Todas las funciones estndar del mdulo de call center siguen activas?
S, el funcionamiento debe ser igual que la consola estndar.

6. Puedo recibir llamadas pero al hacer una llamada nunca se contacta con asterisk. Qu puedo
hacer?
Esto suele pasar porque el Gateway es incapaz de resolver el nombre de host asterisk, para
solucionarlo abrir el archivo /etc/hosts y aadir a la seecin de localhost la palabra asterisk.

By mreyesvera@digital-merge.com
12

Manual Consola de Agente WebRTC

Rev 1.1

By mreyesvera@digital-merge.com
13