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 Yeastar, você precisará criar um ramal para ele, e depois obter as credenciais SIP.

Criar um ramal no Yeastar

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

1. No console de administração, vá em "Extension and Trunk" > "Extension" > "Add".
   
2. Digite um nome para o ramal, atribua um Identificador de Chamada (Caller ID), e opcionalmente um Identificador de Chamada de saída.
3. Configure o parâmetro "IP Phone Concurrent Registrations" com um valor maior que 1 (pelo menos 2). O SIP Caller se registrará uma vez para verificar as credenciais, e uma segunda vez para fazer chamadas a partir de um serviço diferente.
4. Na aba Advanced, certifique-se de configurar os parâmetros Transport e SRTP com os mesmos valores que você definirá no lado do SIP Caller ao criar o ramal.
5. Na aba Security, você pode restringir o registro para que seja feito apenas a partir dos endereços IP do SIP Caller. Além disso, você deve desmarcar a opção "Disable Outbound Calls" e opcionalmente "Disable Outbound Calls outside Business Hours". Se você planeja fazer chamadas internacionais com o SIP Caller, então também desmarque a opção "Disallow International Calls". Por fim, certifique-se de que o parâmetro "Outbound Call Frequency Restriction" esteja configurado para permitir fazer chamadas com a frequência necessária para suas campanhas.
6. Você precisará dos valores de "Extension Number", "Registration Name" e "Registration Password", então copie-os e mantenha-os à mão quando for configurar o ramal no SIP Caller.
7. No console de administração, vá em "Security" > "Security Rules" > aba "Allowed IPs", e adicione os endereços IP do SIP Caller. Você pode copiá-los assim que selecionar a região a partir da qual você operará.
8. Clique no botão "Apply" no canto superior direito, para que o PBX comece a funcionar com esta configuração.

Obter credenciais do Yeastar

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

• Nome de Usuário: Extension Number
• ID de Autenticação: Registration Name
• Senha: Registration Password

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, ou em um servidor Linux que possa ser usado para esse propósito quando não houver acesso ao servidor Yeastar. 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 Yeastar 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 Yeastar:
   • Vá em Integrations > AMI, e habilite o AMI.
   • O SIP Caller requer que você habilite as permissões "System" > "Read", "Call" > "Read", "Call" > "Write" e "Agent" > "Read".

• Defina o Nome de Usuário e a Senha, e depois adicione o endereço IP a partir do qual você se conectará, ou seja, o endereço IP do servidor Linux no qual você está instalando o módulo. Ao instalar localmente, digite "127.0.0.1" para o endereço IP.

2. 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.
3. Vá em Phone Systems > Edit your Phone System > aba Queue Monitoring, 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`.
4. Ao executar o script de instalação no seu servidor Yeastar, 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 (isso ficará visível no Yeastar após salvar as alterações do AMI).
   • 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.