Skip to end of metadata
Go to start of metadata

Pre-requisitos para o módulo Click-to-call


Para utilizar o módulo Click to Call em seu SNEP, você precisará ter instalado:
  • APP - itc-conector  

Instalação do ITC-CONECTOR

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.

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
  • Asterisk 12+ 
  • Token Opens Cloud (verifique no seu cadastro com a Opens para ter acesso à seu token)
  • Tokens adicionais
    • Cada módulo de integração possui seu próprio token. O token da Opens atende os serviços básicos, tais como click-to-call, gravação. Para integrações com outros sistemas como Pipedrive, PlugCRM, RD, você vai precisar dos tokens de cada um destes parceiros.

Instalação

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


OBS.: É durante a execução do comando acima que será solicitado a inclusão do seu TOKEN

No meio do processo, aparecerá a solicitação de seu TOKEN da seguinte maneira:

OPENS_TOKEN= 

Cole seu TOKEN e tecle ENTER para que o processo de instalação continue.

Integração outros Parceiros

Caso você esteja fazendo a integração com outros parceiros de Software você precisará dos tokens de acesso deles neste momento também.

Pipedrive

Tenha seu token em mãos antes de iniciar a instalação e durante o processo você será questionado por este token:

PIPEDRIVE_TOKEN= 

Cole seu TOKEN e tecle ENTER para que o processo de instalação continue.

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:

 

Erros Comuns

Alguns erros comuns e pre-requisitos que você deve cuidar:

  1. Estou pegando a seguinte mensagem de erro: "Error installing docker-engine". O que pode ser?
    Verifique se você tem repositórios externos para pacotes. Um erro comum é o instalador não ter todas as suas dependências resolvidas e isso geralmente acontece por fala de repositórios.
    Normalmente acima desta mensagem existe um detalhamento do pacote que não foi encontrado, como esta:



  2. As versões mais atuais do docker-engine exigem que o kernel seja 3.10 ou maior. Em alguns casos, o pacote do docker-engine pode até instalar corretamente porem o serviço não conseguirá executar até que o Kernel seja atualizado.

    Nesse caso, basta atualizar o kernel que o docker-engine conseguirá rodar corretamente. Segue abaixo um link de referência para atualizar o Kernel:

     https://wiki.debian.org/HowToUpgradeKernel
     
  3. É 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 : 



 


 

Configuração do módulo Click-to-call


Para configurar a funcionalidade de click-to-call em suas aplicações locais, como CRMs, ERPs, ou qualquer outra aplicação que utilizes você tem 2 caminhos possíveis:
  1. Se a sua aplicação possui uma integração oficial com o serviço de Cloud da Opens
  2. Se a sua aplicação possui uma integração com a solução local

Vamos detalhar as duas a seguir:

  1. Integração com a Solução de Cloud da Opens
    Esta integração permite que você vincule a ação de click-to-call com o usuário que está executando a ação e a Plataforma da Opens vai "encontrar" este usuário dentro da rede automaticamente, seja em seu ramal local, em seu celular ou qualquer outro meio de comunicação compatível com a Plataforma.

  2. Integração local
    Neste cenário a integração acontece diretamente com sua solução local de telefonia e exige que sua aplicação tenha acesso de rede ao módulo local da Plataforma da Opens que você instalou nos passos anteriores.
    Para configurar sua aplicação para utilizar este recurso sua aplicação deve ter a capacidade de fazer requisições HTTP GET ou POST passando como parâmetros os dados da ligação:
    1. Ramal Originador
    2. Telefone de Destino

    Para uma requisição do tipo GET, basta você apontar a requisição para o seguinte endereço e formato:

Exemplos de configurações em  alguns Sistemas

SIGMA

  • Sistema SIGMA permite através de uma única interface, o monitoramento de alarmes, vídeo, sistemas de localização por satélite e identificação de clientes em mapas interativos. SIGMA possui todas as informações de monitoramento de alarmes, acompanhado de dados técnicos, operacionais, administrativos e gerenciais.

  • Essa integração visa otimizar o processo de contato com os clientes das empresas de segurança sempre que um evento é gerado.

 

URL utilizada dentro do SIGMA: 

http://IP_DO_SNEP:3000/call/?ramal=[RAMAL]&exten=[TELEFONE]&token=SEU_TOKEN

Gravação:

http://IP_DO_SNEP/snep/arquivos/load.php?id=[ID]

SITUATOR 

URL utilizada dentro do Situator:


http://IP_DO_SNEP:3000/call/?token=SEU_TOKEN 

 

Configurações dentro do SNEP


Após as configurações já estarem prontas dentro de algum sistema, quando uma ação de click-to-call for acionada, uma ligação será gerada para o SNEP e seguirá o seguinte fluxo:

  • Tocará primeiro no ramal que solicitou a ligação;
  • Depois ligará para o número "clicado";


Para que a chamada possa chegar no ramal que solicitou a ligação, será preciso criar uma regra especifica para o click-to-call.
Quando a chamada é encaminhada para o ramal, será gerada uma ligação com destino a  "0000 + RAMAL" . 

Segue abaixo um exemplo de regra para o tratamento dessa chamada:



Basicamente, com essa regra, cortaremos os dígitos "0000" na frente do destino e discaremos para o ramal.

Após isso, o ramal deve atender a chamada e a ligação para o número externo seguirá o fluxo normal das regras de negócio. 

 

  • No labels