Configuração de telefones SIP

Sua própria central telefônica no painel de administração consegue receber chamadas não só no navegador e no aplicativo, mas também em telefones IP de escritório comuns: um aparelho de mesa na recepção, um telefone DECT com o garçom, um interfone na entrada de serviço ou um adaptador para um telefone analógico antigo. Qualquer um deles se conecta da mesma forma: você cria um ramal para o funcionário no painel de administração, obtém cinco valores e os insere no telefone.

Nesta página está o que é igual para todas as marcas: onde obter os dados de acesso, o que eles significam, o que é necessário da rede do estabelecimento e quando o telefone precisa ser redefinido para as configurações de fábrica. Instruções passo a passo com as telas de telefones específicos estão na tabela «Instruções por marca» abaixo.

Abrir: Painel de administração → Telefonia → aba «Funcionários e grupos» (admin.cenaly.com/telephony?tab=extensions).

Encontrar seu telefone#

Digite o modelo da etiqueta na parte inferior do aparelho ou da tela de inicialização — a instrução específica para ele será aberta, junto com sua seção de redefinição para as configurações de fábrica.

Dados de acesso#

Os dados de acesso são emitidos por ramal, e não por telefone: cada colaborador (ou posto de trabalho — “Bar”, “Recepção”) tem seu próprio número interno e sua própria conta. Um mesmo ramal pode ser registrado em vários dispositivos ao mesmo tempo — por exemplo, em um telefone de mesa e no aplicativo.

Onde obter:

1. Telefonia → “Colaboradores e grupos”. Quando você cria um operador, a janela “Credenciais do ramal” é exibida imediatamente.
2. Se a janela foi fechada, a senha não pode ser visualizada — armazenamos apenas o hash dela. Clique em “Redefinir senha” no operador: uma nova senha aparecerá e a antiga deixará de funcionar.
3. Os mesmos dados estão no cadastro do colaborador (Colaboradores → colaborador → ramal).

O botão “Copiar todas as configurações” copia a janela inteira como um único texto — prático para enviar ao colaborador por mensageiro. O botão “Mostrar QR” é destinado a telefones de software, mas os scanners deles esperam em primeiro lugar o link de autoconfiguração do próprio serviço: o Zoiper pode ser testado, já as versões atuais do Linphone não aceitam esse código — detalhes em “Softphones”. Aparelhos de mesa não entendem QR e são configurados por campos.

O que inserir em qualquer telefone#

Se o seu aparelho não tiver uma página própria na tabela abaixo, estes valores bastam — eles são iguais para todas as marcas:

A plataforma não tem configuração automática “por botão” (auto-provisioning a partir do nosso servidor): o telefone é configurado manualmente pelos campos acima ou — para um parque de telefones — pelo seu próprio servidor de provisionamento.

Rede do estabelecimento#

O telefone precisa apenas de acesso de saída à internet até o endereço da central — não é preciso redirecionar portas no roteador:

• UDP 5060 — sinalização (registro, chamadas);
• UDP 10000–20000 — voz (RTP). O contorno compartilhado usa 10000–10200, a máquina dedicada — toda a faixa;
• UDP 123 — hora (NTP), UDP 53 — DNS.

Três coisas que mais quebram a telefonia:

1. SIP ALG no roteador (“SIP Helper”, “SIP Passthrough”). O roteador “ajuda” o SIP e reescreve os pacotes — o telefone se registra, mas a chamada cai após 30 segundos ou só se ouve um lado. Desative o SIP ALG nas configurações do roteador.
2. Wi-Fi com isolamento de clientes. A rede de visitantes do estabelecimento geralmente impede que os dispositivos se vejam — o telefone não encontrará o computador do qual você o está configurando. Conecte o telefone à rede interna, de preferência por cabo.
3. Alimentação. A maioria dos telefones de escritório é alimentada por PoE (802.3af) a partir do switch; se o switch não tiver PoE — é preciso uma fonte de alimentação, que muitas vezes é vendida separadamente.

Em detalhes — onde desativar o SIP ALG em roteadores de marcas populares, NAT duplo, Wi-Fi e VLAN, quanta internet é necessária por chamada: “Rede, roteador e internet”.

Como saber que o telefone se conectou#

• No telefone some a inscrição como “No Service” / “Unregistered”, e na linha aparece um ícone de registro ou o nome.
• No painel administrativo (Telefonia → “Colaboradores e grupos”) acende um ponto verde no operador, ao lado — a hora da última atividade e a string com que o telefone se identificou (por exemplo Yealink SIP-T31G 124.86.0.130). O status vem da central e é atualizado no máximo uma vez por minuto.
• Chamada de teste: disque do telefone o número interno de um colega — ou, de outro ramal, ligue para este.
• Teste de áudio: disque *43 — a central devolve a você a sua própria voz. O registro e o áudio quebram separadamente, e o ponto verde não diz nada sobre o áudio: veja “Verificação da qualidade da conexão” abaixo.

Verificação da qualidade da ligação#

O telefone se registrou — isso ainda não significa que será possível ouvir nele. O registro e o áudio passam por canais diferentes e falham separadamente: o registro é a porta 5060, e a voz é um fluxo RTP separado nas portas 10000–20000. O ponto verde no painel de administração fica aceso até quando a voz não passa de jeito nenhum.

Por isso a central telefônica tem um número de serviço *43 — teste de eco. Disque nele a partir do telefone configurado:

1. A central atende e, após um segundo, emite um sinal de discagem curto.
2. Em seguida, ela devolve a você a sua própria voz: fale no aparelho — você se ouve.
3. Fale por uns dez segundos, e não apenas um — caso contrário, a verificação não terá tempo de se medir (o porquê — abaixo).
4. Terminou — basta desligar (ou pressionar #, e então soará um segundo sinal de discagem).

A verificação não custa nada, não liga para ninguém e não incomoda ninguém: ela não sai dos limites da sua central. Pode ser feita quantas vezes quiser, inclusive em uma unidade em operação no horário de pico.

O que o resultado significa#

O sinal de discagem soa antes do eco de propósito: ele testa uma direção sozinho, antes que o microfone entre em ação. Daí quatro desfechos diferentes — e são quatro defeitos diferentes:

O atraso no eco é normal e equivale ao tempo de ida até a central e volta: até 300 ms quase não se percebe. Se a própria voz retorna com um atraso perceptível (meio segundo ou mais), a ligação será desconfortável para os clientes — a culpa é do canal, e não do telefone.

Números em vez de sensações#

O ouvido responde honestamente "ruim", mas não responde "o quanto" — e conversar com a operadora ou com quem configurou o roteador exige números. Por isso, cada verificação *43 entra no registro de chamadas (Telefonia → Registro) como uma chamada interna, e a ela se anexa o que foi medido:

• perda de pacotes (loss) — até 1 % é imperceptível, acima de 3 % se ouve como "borbulhado" e sílabas somem;
• jitter (jitter) — a variação no tempo de chegada dos pacotes; até 30 ms o telefone suaviza sozinho, após 50 ms o áudio começa a falhar;
• atraso (rtt) — ida e volta; até 150 ms a conversa é natural, após 300 ms os interlocutores começam a se interromper. Telefones que não enviam RTCP não mostram o atraso — isso é "não medido", e não "zero";
• contadores de pacotes (rx / tx) — quanto chegou e quanto saiu. Zero em rx é exatamente "a central não ouve você".

Esse mesmo registro é a resposta pronta para a operadora: data, hora, perdas e jitter de um aparelho específico.

Ao contrário: deixe a central ligar sozinha#

No painel de administração, cada aparelho tem um cartão (clique na tag de hardware na linha do ramal), e nele há a aba "Verificação" e o botão "Ligar para o aparelho". Você clicou — a central liga para o telefone desse ramal e exibe na tela "Verificação de conexão"; você atende, ouve "fale — você se ouvirá", o sinal de discagem e, em seguida, a mesma verificação. O resultado vai para o mesmo registro com os mesmos números.

Isso não substitui o *43, mas é a sua segunda metade: o *43 discado à mão verifica o caminho a partir do telefone, e a ligação da central verifica o caminho até o telefone. Daí a resposta para a reclamação mais comum, "o ponto está verde, mas as chamadas recebidas não tocam": o telefone atualiza o registro sozinho, por dentro, então no painel de administração ele parece ativo — mas a chamada recebida já não chega até ele (vínculo expirado no roteador, keep-alive curto, firewall). O telefone tocou — o caminho existe; ficou mudo — procure o roteador.

O que é importante saber de antemão:

• quem atende é você mesmo: se dá para ouvir no aparelho, nem o botão nem o painel de administração sabem;
• se houver vários aparelhos no ramal, tocará um deles — verificar um telefone específico do par é mais confiável discando *43 nele mesmo;
• em um número herdado da operadora não há botão: esse telefone está registrado em uma central de terceiros;
• o botão só aparece quando a sua central sabe fazer esse tipo de ligação. Sem o botão — funciona o *43 manual.

Quando fazer#

• Logo após conectar o telefone — antes que o aparelho seja entregue ao funcionário. É o único momento em que um defeito de áudio é detectado de graça, e não por meio de uma reclamação de cliente.
• Após qualquer trabalho na rede — trocaram o roteador ou a operadora, moveram o telefone para outra tomada ou rede, atualizaram o firmware.
• Quando reclamarem da qualidade — primeiro *43 do mesmo aparelho: em um minuto ele separa "ligação ruim do nosso lado" de "ligação ruim do lado de quem ligou".

Redefinição para as configurações de fábrica#

A redefinição é necessária com mais frequência do que parece, e em cada página de marca ela é descrita separadamente (pelo aparelho e pela interface web). Quando não dá para ficar sem ela:

• O telefone foi comprado de segunda mão ou veio do operador anterior. Dentro ficaram contas de outra pessoa e, principalmente, o endereço do servidor de autoconfiguração do provedor anterior: o telefone vai baixar obedientemente a configuração alheia e sobrescrever a sua a cada reinicialização. O sintoma é “configurei, tudo funcionava, de manhã de novo não registra”.
• A senha de administrador da interface web foi esquecida. Não é possível recuperá-la, só redefinir.
• O telefone se comporta de forma estranha após uma atualização de firmware ou experimentos com as configurações — a redefinição sai mais barata do que a investigação.

O que é apagado: contas, configurações de rede (IP estático, VLAN), idioma, agendas e histórico de chamadas. O firmware permanece. Após a redefinição: idioma → fuso horário → rede (se não for DHCP) → conta.

Como isso é feito em cada marca — em uma única tabela (pelo aparelho, sem senha, pela interface web, senha após a redefinição): «Redefinição de fábrica: todos os modelos».

Instruções por marca#

Uma página — uma família de telefones com interface web comum. Em cada uma: como descobrir o IP, a senha de fábrica, a tela da conta com captura de tela da documentação do fabricante, verificação, reset para as configurações de fábrica e os erros típicos dessa marca.

Telefones por software (Zoiper, Linphone, MicroSIP, aplicativo no smartphone) são configurados com os mesmos campos — passo a passo para cada cliente: «Softphones». Clientes para os quais há instrução:

⚠️ O recebimento de chamadas em segundo plano no Android não é garantido. O Android suspende aplicativos em segundo plano (modo Doze) e interrompe a conexão ao passar do Wi-Fi para a rede móvel — o registro se perde sem aviso, e a chamada não chega ao telefone. Permita que o aplicativo funcione em segundo plano, desative a otimização de bateria para ele e ative o push — o risco diminui, mas não desaparece. Onde não se pode perder a chamada, coloque um aparelho de mesa.

Se algo não funciona#

Primeiro, disque *43 — o teste de eco em dez segundos dirá onde está o problema: no registro, no áudio ou na rede. Depois, siga pelo sintoma:

Se não registra#

Em ordem, do mais comum ao mais raro — independentemente da marca:

1. O login foi digitado incompleto. É necessário sip-…-<número>, e não o próprio número. Verifique os dois campos — User Name e Auth Name.
2. A senha está desatualizada. Alguém clicou em "Redefinir senha" — a antiga já não funciona. Não tente adivinhar, emita uma nova.
3. O endereço do servidor está errado. No estabelecimento com máquina dedicada, o endereço é próprio, e não o genérico sip.<domínio>. Copie da janela.
4. Transporte TCP em caso de "silêncio". Se o telefone não recebe nem mesmo a recusa — mude para UDP.
5. Rede. O roteador bloqueia UDP 5060, o SIP ALG está ativado, o telefone está no Wi-Fi de visitantes.
6. Provisionamento de terceiros. As configurações "mudam sozinhas" — veja "Redefinição para os padrões de fábrica".
7. Firmware errado. Aparelhos com firmware Microsoft Teams / Skype for Business / Zoom (Yealink, Poly, AudioCodes, Cisco têm desses) não se registram em uma central SIP comum enquanto não receberem o firmware SIP. Por fora, o modelo é o mesmo — verifique pela tela de inicialização.

Se depois disso não funcionou — na página da marca há uma lista das mensagens exatamente desse aparelho e o que elas significam.

Perguntas frequentes#

Como verificar a conexão sem ligar para pessoas de verdade?#

Disque do telefone *43 — a central devolve a você a sua própria voz (teste de eco). Isso verifica exatamente o áudio, e não o registro, não custa nada e não incomoda ninguém: a chamada não sai da sua central. A explicação do que significa cada resultado está na seção "Verificação da qualidade da conexão".

Qual telefone comprar?#

Para o balcão e o escritório — qualquer telefone SIP de mesa da tabela; os mais populares e baratos — Yealink T31/T33, Grandstream GRP2601/2602, Fanvil X3/X4. Para garçons e o salão — base DECT com fones (Yealink W70B, Grandstream DP752, Gigaset N670) — uma base cobre o salão, os fones no bolso. Para hotel — modelos para hotelaria sem botões extras (Fanvil série H, Snom HD1xx). Para um telefone analógico antigo — adaptador ATA (Grandstream HT801). O principal é que o modelo suporte SIP aberto: aparelhos "só para Teams" e "só para Zoom" não servem.

É possível colocar um mesmo ramal em dois telefones?#

Sim: uma conta se registra em vários dispositivos ao mesmo tempo (por exemplo, telefone de mesa e aplicativo), a chamada chega em todos. Se for preciso que toquem em sequência ou simultaneamente para pessoas diferentes — isso é um grupo de toque em "Telefonia → Grupos de toque", e não uma conta compartilhada.

O ramal interno de um funcionário foi trocado — é preciso reconfigurar o telefone?#

Sim. O login contém o número, portanto o novo número é uma nova conta e uma nova senha. No telefone, é preciso reescrever o login (nos dois campos) e a senha.

É necessário IP estático ou redirecionamento de portas?#

Não. O telefone estabelece a conexão com a central por conta própria, de dentro da sua rede; não são necessárias conexões de entrada externas. O redirecionamento de portas no roteador não é necessário e é prejudicial.

Existe configuração automática por endereço MAC (provisioning)?#

Não. A plataforma não mantém um servidor de configuração automática: o telefone é configurado com os campos da janela "Credenciais do ramal". Para um parque de dezenas de aparelhos, use seu próprio servidor de provisionamento — nas páginas das marcas há um bloco recolhido "Configuração automática do parque" com os nomes dos parâmetros.

Há suporte a criptografia (TLS/SRTP)?#

No momento, não: o registro é feito por UDP/TCP na porta 5060, a voz — por RTP aberto. Não ative TLS/SRTP no telefone "por via das dúvidas" — ele não vai se registrar.

Seções relacionadas#

• Funcionários e turnos — para quem emitir ramais
• Chamada do site e Retorno de chamada — as chamadas dos clientes chegam nos mesmos ramais
• Requer atenção — chamadas perdidas na lista geral de tarefas
• Código de linha *código*número e plano de discagem do telefone — se o telefone não disca o código da operadora ("verifique o número")
• Chamadas distintas em telefones SIP — um toque próprio para chamada de cliente, de colega e de transferência