16/08/2013 Integração com Asterisk Versão 1.0 01/12/2014
Visão Resumida Data Criação 01/12/2014 Versão Documento 1.0 Projeto Responsáveis Revisores Integração do Citsmart com Asterisk Rosana Silva Godinho (Documentadora) Euler Ramos (Analista de Sistemas) Aprovador 2 de 22
Histórico de Revisão Data Versão Descrição Autor 01/12/2014 1.0 Elaboração do documento. Rosana Silva Godinho 3 de 22
Sumário 1. INTRODUÇÃO... 5 1.1. Objetivo... 5 1.2. Asterisk... 5 2. CONFIGURAÇÕES INICIAIS... 6 2.1. Configuração do LOG do JBoss 7... 6 2.2. Configuração dos Parâmetros do Citsmart... 19 7. UTILIZAÇÃO DA FUNCIONALIDADE DE VOIP... 20 4 de 22
Integração do Citsmart com Asterisk 1. INTRODUÇÃO 1.1. Objetivo Este documento tem o objetivo de orientar na configuração e utilização da funcionalidade de Atendimento (VoIP) que integra o Citsmart ao framework de PABX Asterisk. 1.2. Asterisk O Asterisk é um software de PABX que usa o conceito de software livre (GPL), criado pela Digium Inc. e uma base de usuários em contínuo crescimento. O Asterisk roda em plataforma Linux e outras plataformas Unix com ou sem hardware conectando a rede pública de telefonia, PSTN (Public Service Telephony Network). O Asterisk permite conectividade em tempo real entre as redes PSTN e redes Voip. Para esta funcionalidade estar disponível no Citsmart foi necessário a junção do mesmo com a tecnologia Asterisk. Dependendo do modo que foi implementado o PABX, o Citsmart irá conseguir obter as informações da origem e destino das ligações de duas formas: UniqueID é utilizado para vincular os canais de origem e destino; DiallingChanel é utilizado para descobrir qual canal originou tal ligação. 5 de 22
2. CONFIGURAÇÕES INICIAIS 2.1. Configuração do LOG do JBoss 7 Para que não sejam apresentadas as mensagens de INFO do Asterisk, que são constantes, no LOG do JBoss, proceda conforme os passos descritos abaixo: 1. Entre no servidor de aplicação JBoss, clique em Administration Console conforme indicado na figura abaixo: Figura 1 Servidor de Aplicação JBoss 7 2. Será apresentada a tela de administração do console do servidor de aplicação JBoss 7. 3. Adicione o console handler para o asterisk; a. Clique em Profile > Core > Logging > Handler > Console e no botão Add conforme indicado na figura abaixo: 6 de 22
Figura 2 Inserção do Console Handler b. Será exibida uma janela para informar os dados do console handler asterisk, informe os mesmos conforme apresentados na figura abaixo: 7 de 22
Figura 3 Cadastro do Console Handler c. Após informar os dados, clique no botão Save; d. Clique em AsteriskConsole que acabou de adicionar e edite suas informações; 8 de 22
Figura 4 Edição do Console Handler e. Marque o campo Auto flush e clique no botão Save conforme indicado na figura abaixo: Figura 5 Edição das Informações do Console Handler 9 de 22
Figura 6 Console Handler para Asterisk 4. Registre o handler de arquivo para o asterisk (essa configuração define o handler que criará o arquivo de LOG para o asterisk); a. Clique em File e logo em seguida clique no botão Add; 10 de 22
Figura 7 Inserção do Handler de Arquivo b. Será exibida uma janela para informar os dados do handler de arquivo para o asterisk, informe os mesmos conforme apresentados na figura abaixo: 11 de 22
Figura 8 Cadastro do Handler de Arquivo c. Após informar os dados, clique no botão Save; d. Clique em AsteriskFile que acabou de adicionar e edite suas informações; 12 de 22
Figura 9 Edição do Handler de Arquivo e. Marque os campos Append e Auto flush e clique no botão Save conforme indicado na imagem abaixo: Figura 10 Edição das Informações do Handler de Arquivo 13 de 22
5. Configure as categorias de LOG; Figura 11 Handlers de Arquivo para Asterisk a. Clique em Log Categories e logo em seguida clique no botão Add para adicionar uma categoria; 14 de 22
Figura 12 Inserção de Categorias de LOG b. Será exibida uma janela para informar dos dados da categoria, informe os mesmos conforme apresentados na figura abaixo: 15 de 22
Figura 13 Cadastro de Categoria de LOG c. Após informar os dados, clique no botão Save; 16 de 22
Figura 14 Categoria de LOG d. Clique na aba Handlers e logo em seguida no botão Add; Figura 15 Adição de Handlers da Categoria de LOG 17 de 22
e. Será exibida uma janela para informar o handler da categoria. Adicione o handler AsteriskConsole e AsteriskFile; Figura 16 Adição do Handler AsteriskConsole Figura 17 Adição do Handler AsteriskFile 18 de 22
Figura 18 Categoria de LOG para o Asterisk 6. Feito isso, feche a página de administração do console do servidor de aplicação JBoss 7 e reinicie o mesmo. 2.2. Configuração dos Parâmetros do Citsmart Para executar a funcionalidade de VoIP, é necessário configurar os seguintes parâmetros do sistema: 1. Parâmetro 177 Define se ativa ou não a integração ao Asterisk (Ex: S ou N - Default: N ): informar o valor S (sim) para habilitar a integração do Asterisk com o Citsmart e exibir o botão Atendimento na parte superior da tela principal do sistema; 2. Parâmetro 178 Ip do servidor Asterisk (Ex: 10.0.0.1): informar o IP do servidor do Asterisk para conexão; 3. Parâmetro 179 Usuário para acesso ao servidor Asterisk (Ex: admin): informar o usuário de acesso ao servidor Asterisk para realizar a conexão; 19 de 22
4. Parâmetro 180 Senha para acesso ao servidor Asterisk (Ex: *********): informar a senha de acesso ao servidor Asterisk para realizar a conexão; 5. Parâmetro 181 Intervalo em milisegundos para atualização e verificação Asterisk das ligações. (Ex: 1000 - Default: 2000 ): informar o intervalo de milisegundos; 6. Parâmetro 265 Algoritmo de captura das ligações Asterisk. ([Default] 1-UniqueID, 2-DialingChannel): definir o algoritmo que será utilizado para captura das ligações Asterisk. 7. UTILIZAÇÃO DA FUNCIONALIDADE DE VOIP Para trabalhar com a funcionalidade de VoIP é necessário registrar o ramal a ser utilizado para o atendimento, conforme os passos descritos abaixo: 1. Na tela inicial do Citsmart, clique em Atendimento, conforme indicado na imagem abaixo: Figura 19 - Funcionalidade de Atendimento (Voip) 2. É apresentada a janela Ramal contendo um campo, onde se informa o número do ramal a ser utilizado para o atendimento; 20 de 22
Figura 20 - Tela de Configuração do Ramal a. Informe o número do ramal e clique no botão Gravar para efetuar a operação. 3. Após a inserção do número do ramal, o sistema irá monitorá-lo, quando ocorrer uma chamara recebida, ou seja, quando uma ligação for direcionada para o número do ramal configurado, será exibida uma janela apresentando o número do telefone e o nome da pessoa que está ligando, conforme apresentada na imagem abaixo: Figura 21 - Tela de Aviso de Ligação É necessário que a pessoa que está ligando já possua cadastro no Citsmart, com os dados referentes. 4. Caso o atendente queira registrar uma solicitação de serviço/incidente, basta clicar no botão Cadastrar nova solicitação que será aberta uma janela para que uma nova solicitação seja criada; Obs.: Para efetuar o registro da solicitação de serviço, o solicitante, ou seja, a pessoa que está solicitando o serviço deve estar cadastro no sistema e vinculado ao mesmo contrato do atendente. 21 de 22
Figura 22 - Tela de Registro de Solicitação de Serviço/Incidente (Passo 1º) Figura 23 - Tela de Registro de Solicitação de Serviço/Incidente (Passo 2º) 22 de 22