Visão Geral

O SIP Caller se conecta ao seu Sistema Telefônico como um ramal remoto. Portanto, para usar o SIP Caller com o FreePBX, você precisará criar um ramal para ele, e depois obter as credenciais SIP.

Criar um ramal no FreePBX

Para criar um ramal no FreePBX, proceda da seguinte forma:

1. No console de administração, vá em "Connectivity" > "Extensions".
   
2. Selecione o menu "Add Extension" > "Add New SIP [chan_pjsip] Extension".

3. Digite o número do ramal no campo "User Extension", e atribua um nome de exibição, e opcionalmente um Identificador de Chamada de saída.
4. Você precisará dos valores de "User Extension" e "Secret", então copie-os e mantenha-os à mão quando for configurar o ramal no SIP Caller.
5. Na aba "Advanced", procure a opção "Outbound Concurrency Limit" e defina o valor para o número de chamadas simultâneas que você deseja que o SIP Caller faça.
6. Clique no botão "Apply config" no canto superior direito, para que o PBX comece a funcionar com este ramal.

Obter credenciais do FreePBX

O SIP Caller exigirá os valores de "User Extension" e "Secret" obtidos na etapa anterior. Ao configurar o ramal no SIP Caller, você precisará usar esses valores da seguinte forma:

• Nome de Usuário: User Extension
• ID de Autenticação: User Extension
• Senha: Secret

Para instruções detalhadas sobre como configurar o Sistema Telefônico no SIP Caller, confira aqui.

Opcional - Instalar o SIP Caller Queues Monitor para Asterisk

O SIP Caller oferece suporte à execução de campanhas no modo "Discador Preditivo" ou "Discador Progressivo". Isso significa que o número de chamadas feitas será ajustado em tempo real, considerando o número de agentes disponíveis na fila para atender essas chamadas. Para isso, o SIP Caller precisa saber o status da fila, ou seja, o número de chamadas em espera e o número de agentes disponíveis e ocupados. Essa informação é reportada ao SIP Caller pelo módulo "SIP Caller Queues Monitor", que deve ser instalado no servidor do PBX. Isso não é necessário para executar campanhas no modo "Discador de Potência". Este módulo também é necessário para acionar os callbacks quando chamadas em fila são abandonadas ou atendidas.

Para instalar o "SIP Caller Queues Monitor" para Asterisk, proceda da seguinte forma:

1. O módulo "SIP Caller Queues Monitor" se conecta ao seu servidor FreePBX / Asterisk usando a Asterisk Manager Interface (AMI). Portanto, você precisará criar um usuário para que o SIP Caller se conecte através deste protocolo. Ao usar o FreePBX:
   • Vá em Settings > Asterisk Manager Users, e clique no botão "Add Manager".

• Digite um nome, por exemplo "sipcaller", e configure as restrições de rede conforme necessário (o módulo só se conectará localmente).

• Na aba Permissions, o SIP Caller requer que você habilite as permissões "System" > "Read", "Call" > "Read", "Call" > "Write" e "Agent" > "Read".

2. Ao usar uma versão diferente do Asterisk, você precisará editar o arquivo de configuração "/etc/asterisk/manager.conf", e adicionar um usuário para o SIP Caller lá:

   [sipcaller]  
   secret=a_strong_password_here  
   deny=0.0.0.0/0.0.0.0  
   permit=127.0.0.1/255.255.255.0  
   read=system,call,agent
   write=call

3. No console de administração do SIP Caller, vá em Settings > API Keys, e crie uma Chave de API atribuindo a função "Phone System Queues Monitor". Essa Chave de API será usada pelo módulo "SIP Caller Queues Monitor" para se conectar à API REST do SIP Caller e reportar o status das filas em tempo real.
4. Vá em Phone Systems > Edit your Phone System > aba Queues Monitor, e siga as instruções para instalar o módulo "SIP Caller Queues Monitor" no seu servidor Asterisk. Você precisará de acesso SSH com um usuário que possa executar comandos como root via `sudo`.
5. Ao executar o script de instalação no seu servidor FreePBX/Asterisk, você precisará fornecer as seguintes informações:
   • O Token da Chave de API criada acima.
   • O número da porta em que a Asterisk Management Interface (AMI) está escutando requisições (por padrão 5038).
   • O nome de usuário a ser usado para se conectar à AMI (este é o usuário criado na etapa anterior).
   • A senha atribuída a esse usuário.