Documentação do softphone

Visão geral

O 4e1 é o softphone oficial da 4e1 para telefonia IP (VoIP). Conecta-se automaticamente ao servidor pbx.4e1.com.br, sem necessidade de configurar domínio ou proxy manualmente.

Recursos principais:

• Identidade visual 4e1 (ícone, bandeja e logo na tela de conta)
• Conta simplificada: ramal, senha, protocolo e publicar presença
• Servidor SIP fixo: pbx.4e1.com.br
• Codecs G.729 (prioritário), G.711 A-law e G.711 μ-law
• SRTP opcional automático ao usar transporte TLS
• Reescrever IP sempre ativado (NAT traversal)
• Verificação de atualização a cada inicialização
• Central de ajuda integrada em 4e1.com.br/softphone/help

Requisitos mínimos:

• Windows 10 ou superior (32 bits)
• Conexão com a internet
• Fone de ouvido ou headset com microfone
• Conta SIP (ramal) fornecida pela 4e1

Instalação

1. Baixe o instalador em 4e1.com.br/softphone ou pelo link de atualização do próprio app.
2. Execute o arquivo 4e1-x.y.z.exe como administrador (ex.: 4e1-3.24.0.1.exe).
3. Siga o assistente e conclua a instalação.
4. Na primeira execução, informe ramal e senha.

Configurar conta

Na primeira execução — ou em Menu → Conta — aparece o formulário simplificado com o logo 4e1:

Configurado automaticamente:

Ramal

O ramal é o identificador da sua conta no PBX 4e1. Exemplos: 1152001, 1001, 205.

Boas práticas:

• Informe apenas o ramal, sem @domínio
• Não compartilhe ramal e senha
• Para alterar a senha: Menu → Conta → Salvar

Senha

A senha autentica seu ramal em pbx.4e1.com.br.

• Armazenada localmente de forma criptografada
• Alteração: Menu → Conta → Senha → Salvar (re-registra automaticamente)
• Esqueceu a senha: solicite reset ao administrador do PBX

Protocolo de transporte

Define como a sinalização SIP trafega entre o softphone e o servidor.

Ao selecionar TLS, a criptografia de mídia SRTP opcional é ativada automaticamente. Com TCP ou UDP, SRTP permanece desativado.

Publicar presença

Com esta opção ativada (padrão), o softphone informa ao PBX seu status:

Desative apenas se orientado pelo administrador. Com presença ativa, o registro SIP pode usar a porta 5161.

Fazer e receber chamadas

Discar

1. Digite o número ou ramal no teclado
2. Clique em Chamar ou pressione Enter

Atender

• Clique em Atender no popup de chamada recebida
• Ou use o botão do headset (se configurado)

Durante a chamada

A aba Chamadas lista entrantes, saídas e perdidas.

Presença e Não perturbe

No menu ou ícone de status: Online, Ausente, Ocupado / Não perturbe (DND).

• Em chamada: status ocupado
• Inatividade: pode mudar para ausente (timeout configurado)

O status Não perturbe só é exibido quando o DND está realmente ativo no cliente (não confundir com presença BUSY genérica).

Codecs de áudio

O PBX e o softphone negociam o codec em comum durante a chamada. Usuários avançados: Menu → Configurações → Codecs de áudio.

TLS e criptografia SRTP

Confirme com o administrador se o pbx.4e1.com.br está configurado para TLS antes de usar esse protocolo.

Atualizações automáticas

O 4e1 consulta o manifesto de versão em:

https://4e1.com.br/softphone-update.txt

Quando verifica:

• A cada inicialização do aplicativo
• Manualmente: Menu → Atualizações

Formato do manifesto (3 linhas):

https://4e1.com.br/downloads/4e1-3.24.0.1.exe
3.24.0.1
Texto do changelog exibido no popup

Fluxo para o usuário

1. Ao iniciar, o app compara a versão instalada com a do site
2. Se houver versão maior, aparece: "Deseja atualizar agora?"
3. Ao confirmar, o navegador abre o link HTTPS de download
4. Execute o instalador 4e1-x.y.z.exe e conclua

Versão instalada visível em Menu → Ajuda (ex.: v3.24.0.1).

Solução de problemas

Não registra no servidor

• ☐ Ramal e senha corretos
• ☐ Internet funcionando
• ☐ Firewall permite saída para pbx.4e1.com.br (TCP/UDP)
• ☐ Antivírus não bloqueia microsip.exe

Sem áudio (chamada conecta, mudo)

• ☐ Microfone correto em Configurações → Dispositivos de áudio
• ☐ Volume do Windows e do fone
• ☐ Teste com outro headset
• ☐ Em RDP: microfone local pode não estar disponível

Chamadas não chegam

• ☐ Softphone registrado (status verde)
• ☐ Apenas uma instância do ramal ativa
• ☐ Contatos duplicados/fantasma no PBX — contate o administrador

Update não aparece

• ☐ Versão instalada menor que a publicada no manifesto
• ☐ softphone-update.txt acessível (HTTP 200)
• ☐ URL de download em HTTPS em 4e1.com.br
• ☐ Teste: Menu → Atualizações
• ☐ Confirme versão em Menu → Ajuda

Suporte

Ao abrir chamado, informe:

• Versão (Menu → Ajuda)
• Ramal (sem senha)
• Protocolo (TCP / TLS / UDP)
• Descrição do problema e horário
• Log, se possível (Menu → Ver arquivo de log)

Apêndice — âncoras do softphone

O app abre https://4e1.com.br/softphone/help#codigo. Âncoras disponíveis:

Softphone 4e1 — série 3.24.x · base MicroSIP 3.22.3 customizado · PBX pbx.4e1.com.br