Child pages
  • Instalando o Q-Manager
Skip to end of metadata
Go to start of metadata

ATENÇÃO

Este documento está prevendo que você esteja usando uma versão do Asterisk em um DEBIAN ou SNEP
Caso esteja usando outras distribuições, veja nossa lista de documentação abaixo:

FREEPBX    

 

Para utilizar o  Q-Manager, você precisará ter instalado:

  • APP - itc-conector
  • Pacote - snep-q-manager 

 

As APIs da Opens fornecem um conjunto de recursos que podem ser incrementados utilizando um módulo local que conecta seu PBX baseado em Asterisk (SNEP, FreePBX, Elastix e outros) com os serviços da Cloud Opens.

Cases

Com nossas APIs em seu Asterisk você pode fazer várias integrações:

 

Pre-requisitos

Para utilizar estes recursos locais você precisará ter acesso de root na máquina rodando seu Asterisk além de:

  • Linux com kernel 64bits versão 3.10+
  • Asterisk 12+ 
  • Token Opens Cloud (verifique no seu cadastro com a Opens para ter acesso à seu token)

Instalação - Asterisk/Debian

Para instalar o módulo execute em seu terminal linux como usuário root:

Configurações em seu Asterisk

Você precisa incluir a rede privada da Aplicação na configuração do usuário snep (usuário padrão da aplicação) ou outro que você esteja usando no Asterisk Manager Interface (AMI). Para isso altere seu arquivo /etc/asterisk/manager.conf na sessão do usuário utilizado incluindo:

Dê um reload no módulo manager:

 

Você também deve liberar acesso a Asterisk Rest Interface (ARI) do seu Asterisk. Basta editar o arquivo /etc/asterisk/ari.conf : 

OBSERVAÇÃO: Caso você esteja usando SNEP, essa configuração não é necessária. Você pode pular e ir para o próximo passo.



Dê um reload no módulo res_ari.so:

Configurando seu TOKEN

Após a instalação e primeira coisa à fazer é inserir seu TOKEN para iniciar o usa da Aplicação.

Para isso basta acessar o IP de seu Asterisk via Browser na Porta 8080:

Erros Comuns

  • Erro depois que a máquina foi reiniciada

É comum quando a maquina reiniciar os containers não subirem automaticamente, ocasionando falha nos serviços vinculados ao itc-conector. Recomendamos adicionar os containers na inicialização da máquina. 

Basta adicionar as linhas abaixo (na mesma ordem citada) dentro do arquivo /etc/rc.local : 


Para subir os containers, você também pode executar essas linhas diretamente no shell da maquina.




Instalação do pacote snep-q-manager


Para instalar o snep-q-manager execute em seu terminal linux como usuário root:


Esse comando irá adicionar o repositório do SNEP em seu APT e logo após irá instalar o pacote snep-q-manager

Após o pacote ser instalado, deverá aparecer um diretório chamado snep-q-manager em /var/www/html/snep/modules/  e consequentemente também na interface gráfica. 

 

Webclient não efetua Login

Esse problema ocorre quando o navegador não está permitindo que a ferramenta execute as funções. Nesse caso basta colocar a permissão no navegador como "permitir sempre" para a pagina do Client. 

Segue print de exemplo:  

 

Utilizando SNEP, a primeira ligação em um operador toca normalmente porem as próximas não tocam mais

Isso acontece com o porque o Realtime do Asterisk está ativado e os ramais estão com o "call-limit" vazio. Segue abaixo a solução:

  • Via shell em seu SNEP, execute o script :  disable_realtime.sh  
    Esse script desabilitará o Realtime em seu Asterisk 
  • Execute o comando: 

  • Depois, você deverá ir na interface do SNEP, no cadastro de ramais e colocar o limite de chamadas simultâneas em todos os ramais. O minimo deverá ser "1"

 

Erro ao efetuar login de agente por telefone: nenhuma regra válida

 

Ao tentar efetuar o login por telefone, o Asterisk requisição para regra de negócio como se fosse uma chamada, e ocorre o erro de nenhuma regra válida.
SOLUÇÃO:
Verificar os includes nos arquivos:
vim /etc/asterisk/custom/preagi.conf
*O INCLUDE DEVE FICAR ACIMA DE QUALQUER CONTEXTO*****
#include snep/snep-q-manager.conf
Após:
vim /etc/asterisk/extensions.conf
*OS DOIS INCLUDES DEVEM FICAR DENTRO DO CONTEXTO DEFAULT******
#include snep/snep-features.conf
#include custom/preagi.conf
Caso tenha realizado alguma alteração nos arquivos, faça um dialplan reload no console do Asterisk.

 

  • No labels

1 Comment

  1. Perfect. 
    Congratulations Vincent!!