Visão Geral

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

Este guia descreve os passos para criar e configurar um ramal na Central Telefônica 3CX v20, com todas as configurações necessárias para o seu correto funcionamento com o SIP Caller.

Criar um ramal na Central Telefônica 3CX

Para criar um ramal na Central Telefônica 3CX, proceda da seguinte forma:

1. No Cliente Web, vá em "Admin" > "Users" > "Add User".

2. Digite o número do ramal no campo "Extension", e defina um primeiro e último nome adequados.

3. Na aba "Options", desmarque a opção "Block remote non-tunnel connections". Isso é necessário porque o SIP Caller se conectará ao seu Sistema Telefônico a partir da nuvem.
4. Na aba "IP Phone", clique no botão "Configure a Phone".
   
5. Selecione a opção "I will configure the phone myself" e depois clique em "Next".
   
6. Selecione a opção "Local LAN / VPN", e no menu suspenso "Select Interface", escolha o endereço IP público do seu servidor da Central Telefônica 3CX.
7. A tela seguinte mostrará as credenciais que você precisará configurar no SIP Caller. Copie os valores dos campos "Extension Number", "Authentication ID" e "Authentication Password". Se o campo "Registrar SIP Port" tiver um valor diferente de 5060, copie esse valor também.
8. Clique em "Save" para armazenar os detalhes do usuário no 3CX.
9. Certifique-se de que existe uma regra de saída (outbound rule) configurada para este ramal, para que, quando chamadas de saída forem feitas, o 3CX possa roteá-las corretamente através do SIP Trunk de sua escolha.

Obter credenciais da Central Telefônica 3CX

O SIP Caller exigirá os valores de "Extension Number", "Authentication ID" e "Authentication 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: Authentication ID
• Senha: Authentication 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 a Central Telefônica 3CX

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". Como consequência, esse recurso requer que você esteja executando o 3CX localmente (on-premise) ou em servidor próprio (self-hosted) (Hosted by 3CX ou Small Business não são suportados). 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 a Central Telefônica 3CX, proceda da seguinte forma:

1. 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.
2. 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 3CX:
   • Ao executar o 3CX no Linux, você precisará de acesso SSH com um usuário que possa executar comandos como root via `sudo`.
   • Ao executar o 3CX no Windows, você precisará abrir uma janela do PowerShell usando a opção de menu de contexto `Run as administrator`.

SIP Caller vs Discador CFD

Criar um discador básico para a Central Telefônica 3CX com o CFD pode ser bastante desafiador, mesmo para programadores experientes, sem falar que ele não fornecerá nenhum dos recursos que o SIP Caller oferece.

Usando o SIP Caller, você terá um discador completo funcionando em questão de minutos, sem necessidade de programação, e nada para instalar no seu Sistema Telefônico.¹

Na tabela a seguir, você encontrará uma comparação detalhada de recursos entre o SIP Caller e um Discador CFD.

Recurso	SIP Caller	Discador CFD
Configuração em 5 minutos	✓	✗
Relatórios históricos	✓	✗
Relatórios em tempo real	✓	✗
Detecção de secretária eletrônica	✓	✗
Conversão de texto em fala sem custo adicional 2	✓	✗
Modelos de Fluxo de Chamada	✓	✗
Disposição de chamada com código de status SIP	✓	✗
Tempo limite de tentativa de chamada controlável	✓	✗
Continua funcionando após reinício dos serviços do Sistema Telefônico	✓	✗
Configuração simples de regras de saída 3	✓	✗
Suporta 3CX On-Premise	✓	✓
Suporta 3CX Self Hosted	✓	✓
Suporta 3CX Hosted by 3CX 1	✓	✗
Suporta 3CX Small Business 1, 4	✓	✗

Footnotes

1. As edições Hosted by 3CX e Small Business têm suporte apenas para executar campanhas no modo "Discador de Potência". Os modos "Discador Preditivo" e "Discador Progressivo" exigem a instalação do módulo "SIP Caller Queues Monitor", que reporta o status das filas em tempo real ao SIP Caller, e isso só pode ser feito quando você tem acesso ao servidor 3CX. ↩ ↩² ↩³

2. Cada plano inclui uma quantidade de caracteres de TTS gratuitos. Se sua conta exceder essa quantidade, você precisará adquirir caracteres de TTS adicionais. ↩

3. O SIP Caller se conecta ao seu Sistema Telefônico como um ramal remoto, e dessa forma você pode configurar seu Sistema Telefônico com regras de saída que podem ser restritas a este ramal específico. As chamadas feitas por um discador CFD são iniciadas pela URA "Make Call", que não pode ser configurada como um ramal ou grupo de regra de saída. ↩

4. Mesmo que o SIP Caller ofereça suporte ao 3CX Small Business, esse cenário pode gerar problemas porque o servidor 3CX é compartilhado com empresas diferentes nesse caso. Como consequência, se um endereço IP do SIP Caller for colocado na lista negra por este servidor 3CX porque outro usuário digitou credenciais erradas, esse bloqueio pode afetar sua conta. ↩