Instalando o zimlet Asterisk no Zimbra 6.0.X

Quem utiliza o Zimbra sabe muito bem que os zimlets podem agregar recursos muito interessantes à ferramenta.

Dentro da grande gama de opções disponíveis na galeria, um zimlet que merece destaque é o de integração com o Asterisk (Asterisk PBX Integration).

A integração com o Asterisk permite que sejam realizadas ligações com um simples clique do mouse. Bastar clicar no número telefônico desejado na interface web do Zimbra (na lista de endereços ou no corpo de um e-mail, por exemplo) que a ligação é efetuada.

E como funciona ?

Ao clicar no número telefônico, o Zimbra (utilizando-se da AMI – Asterisk Manager Interface) faz o Asterisk discar para o ramal do usuário. Quando o usuário atende a ligação, o Asterisk então disca para o número de destino estabelecendo a chamada.

Certamente esse é um recurso muito útil, mas que, no entanto, tem um processo de instalação um pouco complicado se a versão do Zimbra for a 6.0.X.

Instalando o zimlet Asterisk PBX no Zimbra

Antes de mais nada é preciso ter ciência de que a última versão oficial desse zimlet (0.65) não é compatível com o Zimbra 6.0.X, o que impossibilita sua instalação.

Pesquisando nos fóruns do Zimbra encontrei um post que possui uma versão modificada que atende os requisitos do Zimbra 6.0.X. Baixe o zimlet compatível aqui.

Vamos então a instalação:

Logue como root no servidor zimbra e acesse o diretório /opt/zimbra/jetty/webapps/zimlet/WEB-INF ;
Renomeie o subdiretório lib para lib.old, por exemplo;
Crie os seguintes links simbólicos com os comandos:

ln -s /opt/zimbra/jetty/webapps/zimbra/WEB-INF/lib /opt/zimbra/jetty/webapps/zimlet/WEB-INF
ln -s /opt/zimbra/jetty/webapps/zimbra/WEB-INF/tags /opt/zimbra/jetty/webapps/zimlet/WEB-INF
ln -s /opt/zimbra/jetty/webapps/zimbra/WEB-INF/tlds /opt/zimbra/jetty/webapps/zimlet/WEB-INF
ln -s /opt/zimbra/jetty/webapps/service/WEB-INF/zimbra.tld /opt/zimbra/jetty/webapps/zimlet/WEB-INF

Instale o zimlet Asterisk PBX pela interface administrativa do Zimbra ;
Configure o Asterisk para ativar a AMI (Asterisk Manager Interface), editando o arquivo /etc/asterisk/manager.conf e alterando a opção enabled para yes. Crie também um usuário com todos poderes, que será posteriormente configurado no zimlet. Por exemplo:

[zimbra]
secret = password
read = system,call,log,verbose,command,agent,user,config, command,dtmf,reporting,cdr,dialplan,originate
write = system,call,log,verbose,command,agent,user,config, command,dtmf,reporting,cdr,dialplan,originate

Baixe o arquivo de configuração modelo (o arquivo gerado pelo zimlet tem um problema nas tags que dificulta seu uso) e edite-o colocando os dados de seu servidor Asterisk;
Logado como usuário zimbra em seu servidor, importe o arquivo de configuração modificado com o comando: zmzimletctl configure /path/do/arquivo/ch_bnc_asterisk_config.xml ;
Remova do diretório /opt/zimbra/jetty/webapps/zimlet/WEB-INF/lib, se existirem, os arquivos asterisk-java-1.0.0-m1.jar e/ou asterisk-java-1.0.0-m2.jar ;
Reinicie o mailboxd com o comando: zmmailboxdctl restart

Pronto, a instalação foi concluída.

Configuração do usuário

Para começar a discar, antes de mais nada, é necessário que o usuário configure o zimlet. Para isso ele deve clicar na opção Asterisk Integration do menu Zimlets da sidebar esquerda.

Configurando o zimlet

Na tela de preferências é preciso configurar obrigatoriamente o ramal e o contexto com o qual serão realizadas as chamadas (não esqueça de fornecer essa informação para seus usuários).