Manual do Usuário - TchêFone VoIP

1. O que é o TchêFone VoIP

O TchêFone VoIP é um aplicativo de telefonia pela internet que permite realizar e receber chamadas usando ramais SIP.

Com ele, você pode:

Cadastrar manualmente uma conta SIP;
Buscar ramais automaticamente pela Central Telefônica VoIP da instituição ou empresa;
Realizar chamadas pelo discador;
Receber chamadas no aplicativo;
Acessar contatos do telefone;
Acessar contatos da Central Telefônica VoIP, quando disponível;
Consultar histórico de chamadas realizadas, recebidas e não atendidas;
Escolher o modo de funcionamento em segundo plano: Sempre conectado ou Economia de bateria.

            O app pode ser usado tanto com ramais cadastrados manualmente quanto com ramais
            fornecidos por uma empresa ou instituição cadastrada.
        

Voltar ao topo

2. Primeiro acesso

Ao abrir o aplicativo, você verá a tela inicial com as principais opções:

Adicionar SIP manualmente;
Login pela Central Telefônica VoIP;
Ramais salvos;
Discador;
Contatos;
Histórico de chamadas;
Menu lateral, onde ficam opções como Configurações, Login/Logout e Sair do aplicativo.

            Você pode usar o aplicativo com uma conta SIP cadastrada manualmente ou com ramais
            buscados pela Central Telefônica VoIP.
        

O suporte a notificações push para acordar o aplicativo e receber chamadas em segundo plano está disponível apenas para empresas ou instituições previamente cadastradas.

Voltar ao topo

3. Permissões necessárias

Notificações

Permite que o app mostre chamadas recebidas, chamadas não atendidas, a notificação do serviço SIP e avisos importantes, inclusive quando estiver em segundo plano.

Microfone

Necessário para realizar e receber chamadas.

Contatos

Necessário apenas se você quiser visualizar os contatos salvos no telefone dentro do app.

Para receber chamadas corretamente, é recomendado permitir notificações e acesso ao microfone.

Voltar ao topo

4. Adicionar uma conta SIP manual

Toque em Adicionar SIP.
Preencha os campos solicitados.
Escolha se deseja definir a conta como padrão.
Escolha se deseja Auto Conectar ao abrir o app.
Toque em Salvar ou Salvar e registrar.

Campos normalmente solicitados:

Nome da conta;
Nome de exibição;
Usuário ou ramal;
Senha;
Servidor SIP;
Porta;
Transporte: UDP, TCP ou TLS.

Após conectar, a conta aparecerá como registrada na tela de ramais salvos.

Voltar ao topo

5. Login pela Central Telefônica VoIP

Quando sua empresa ou instituição disponibiliza ramais via sistema central, você pode buscar suas contas automaticamente.

O Token identifica a empresa ou instituição responsável pela Central Telefônica VoIP. A partir dele, o aplicativo busca automaticamente as configurações necessárias para acessar os ramais, a agenda da central e os recursos de push, quando disponíveis.

Toque em Login.
Informe o Token fornecido pela empresa ou instituição.
Informe o Usuário.
Informe a Senha.
Escolha se deseja salvar as credenciais.
Toque em Buscar ramais.

As contas vindas da Central Telefônica VoIP:

Não podem ser editadas manualmente;
Podem ser removidas do aparelho;
Podem ser conectadas ou desregistradas;
Podem ter a opção Auto Conectar ativada ou desativada.

            Se o token for alterado, o aplicativo buscará novamente as configurações vinculadas
            ao novo token informado.
        

Voltar ao topo

6. Tela de ramais salvos

Na tela Ramais salvos, você pode visualizar todas as contas cadastradas no aplicativo.

Cada conta mostra:

Nome do ramal;
Usuário e servidor;
Transporte utilizado;
Status de registro em destaque;
Origem da conta: Manual ou API;
Opção de conta padrão;
Opção Auto Conectar, quando disponível.

O status do ramal aparece em destaque ao lado do transporte, indicando rapidamente se o ramal está registrado, conectando, desconectado ou com falha.

Status possíveis

Registrado: o ramal está conectado e pronto para efetuar e receber chamadas.
Conectando: o app está tentando registrar o ramal.
Desconectado: o ramal está salvo, mas não está registrado.
Falha: ocorreu algum erro ao tentar registrar o ramal.

Voltar ao topo

7. Conectar ou desregistrar um ramal

Na tela de ramais salvos:

Toque em Conectar para registrar o ramal.
Toque em Desregistrar para desconectar o ramal.

Quando um ramal é desregistrado manualmente, o aplicativo entende que o usuário não deseja receber chamadas por aquele ramal enquanto ele estiver desconectado.

Para voltar a receber chamadas por esse ramal, toque em Conectar novamente.

            Desregistrar manualmente um ramal é diferente de o app ser pausado pelo modo Economia de bateria.
            No desregistro manual, o aplicativo respeita a escolha do usuário e não tenta reativar aquele ramal
            automaticamente por push enquanto ele permanecer desregistrado manualmente.
        

Voltar ao topo

8. Auto Conectar

A opção Auto Conectar define se o ramal deve ser registrado automaticamente ao abrir o aplicativo.

Quando ativada

O app tenta registrar o ramal ao iniciar;
O ramal pode ficar disponível para chamadas mais rapidamente;
Em ramais da Central, o app também pode reativar os recursos de push vinculados ao ramal.

Quando desativada

O ramal permanece salvo, mas não registra automaticamente;
O usuário precisa tocar em Conectar manualmente.

            Essa opção é configurada por ramal. Você pode deixar um ramal com Auto Conectar ativado
            e outro ramal com Auto Conectar desativado.
        

O Auto Conectar do ramal é diferente do modo global do aplicativo. O Auto Conectar define quais ramais registram ao abrir o app. Já o modo global define como o app se comporta em segundo plano.

Voltar ao topo

9. Conta padrão

A conta padrão é usada preferencialmente para realizar chamadas.

Abra Ramais salvos.
Marque a opção de conta padrão no ramal desejado.

Se houver apenas um ramal registrado, o aplicativo usa automaticamente esse ramal para chamadas.

Voltar ao topo

10. Usar o discador

Toque no ícone do Discador.
Digite o número ou ramal desejado.
Toque no botão de chamada.

O discador só fica disponível quando há pelo menos um ramal registrado.

Se existir apenas um ramal registrado, o aplicativo poderá usar automaticamente esse ramal para realizar a chamada.

Voltar ao topo

11. Receber chamadas

Quando uma chamada chegar, o aplicativo poderá exibir:

Tela de chamada recebida;
Notificação de chamada;
Botões para atender ou recusar.

Na tela de chamada, você pode:

Atender;
Encerrar;
Silenciar o microfone;
Ativar ou desativar o viva-voz.

            Em empresas ou instituições cadastradas com suporte a push, o aplicativo pode receber
            uma notificação para reativar o ramal quando necessário.
        

Recebimento com push

Quando a empresa ou instituição possui suporte a push, o TchêFone pode acordar o aplicativo automaticamente quando uma chamada estiver chegando para um ramal vinculado ao aparelho.

Esse recurso é usado principalmente quando:

O aplicativo está em segundo plano;
O app foi removido dos recentes em modo Economia de bateria;
O ramal não está registrado naquele momento, mas possui push ativo;
O servidor identifica que precisa acordar o app antes de entregar a chamada.

Ao receber o push, o app inicia temporariamente o serviço SIP, restaura as contas salvas, registra o ramal necessário e aguarda a chamada chegar. Quando a chamada SIP chega, a tela de chamada ou a notificação de chamada recebida é exibida.

Em modo Economia de bateria, depois que o app acorda por push e registra o ramal, ele pode voltar automaticamente ao estado de economia após a chamada terminar ou após um período sem chamada.

O push não deve ser confundido com desregistro manual. Se o usuário tocar em Desregistrar em um ramal, o app respeita essa escolha e não deve acordar automaticamente aquele ramal enquanto ele permanecer desregistrado manualmente.

Em modo Economia de bateria, chamadas em segundo plano dependem do push quando esse recurso estiver disponível para a empresa ou instituição. Sem push, a opção mais segura para receber chamadas é usar o modo Sempre conectado.

Voltar ao topo

12. Contatos do telefone

O aplicativo pode listar os contatos salvos no aparelho.

Abra o menu ou a opção de contatos.
Escolha Contatos do telefone.
Permita o acesso aos contatos, se solicitado.

O app evita contatos duplicados com o mesmo nome e número.

            Números com +55 podem ser exibidos sem o código do país.
            Essa formatação é apenas visual para contatos do telefone.
        

Voltar ao topo

13. Contatos da Central Telefônica VoIP

Quando disponível, o app pode listar contatos e ramais da Central Telefônica VoIP.

Os números são tratados como ramais;
Não é aplicada formatação de telefone celular;
Pode aparecer o nome da central, quando houver mais de uma.

Para acessar a agenda da Central, é necessário estar logado na Central Telefônica VoIP com um token válido.

Voltar ao topo

14. Histórico de chamadas

O aplicativo pode registrar chamadas:

Realizadas;
Recebidas;
Não atendidas.

O histórico ajuda a identificar chamadas recentes e retornar ligações com mais facilidade.

            Chamadas não atendidas podem gerar indicação visual no aplicativo e notificação no telefone,
            conforme as permissões concedidas.
        

Voltar ao topo

15. Configurações do aplicativo

A tela de Configurações permite escolher como o TchêFone VoIP deve se comportar em segundo plano.

Para acessar:

Abra o Menu lateral.
Toque em Configurações.
Escolha entre Sempre conectado ou Economia de bateria.

            Essa configuração é global do aplicativo. Ela não substitui o Auto Conectar individual dos ramais.
        

Voltar ao topo

16. Modos de conexão em segundo plano

O TchêFone VoIP possui dois modos principais de funcionamento em segundo plano.

Sempre conectado

É o comportamento recomendado para quem deseja maior disponibilidade para receber chamadas.

Mantém o serviço SIP ativo;
Mantém uma notificação persistente enquanto o serviço estiver em execução;
Tenta manter registrados os ramais com Auto Conectar ativado;
É a melhor opção para receber chamadas com maior disponibilidade;
Pode consumir mais bateria.

Use Sempre conectado se você precisa receber chamadas com mais regularidade ou se sua empresa/instituição ainda não possui push configurado.

Economia de bateria

É indicado para reduzir o consumo de bateria quando você não precisa manter o serviço SIP ativo o tempo todo.

Não tenta manter o serviço SIP vivo permanentemente;
Ao remover o app dos recentes, o aplicativo tenta desregistrar os ramais e marcar o app como em economia;
Os ramais com Auto Conectar continuam sendo registrados ao abrir o app;
Chamadas em segundo plano passam a depender mais do push, quando disponível;
Quando acordado por push, o app registra temporariamente o ramal para receber a chamada;
Após a chamada ou após um período sem chamada, o app pode voltar automaticamente ao estado de economia;
Pode reduzir o consumo de bateria.

No modo Economia de bateria, se o app for removido dos recentes, uma notificação informativa pode aparecer avisando que o serviço SIP foi pausado e que chamadas em segundo plano podem depender do push. Essa notificação é removida automaticamente quando o app é aberto novamente.

Como funciona o push no modo Economia

O app é removido dos recentes ou entra em estado de economia.
O app tenta desregistrar os ramais e informa ao servidor que está dormindo.
Quando uma chamada chega, o servidor verifica se existe push ativo para o ramal.
Se necessário, o servidor envia um push para acordar o aplicativo.
O app acorda em segundo plano, restaura as contas salvas e registra o ramal necessário.
A chamada é entregue ao aplicativo e a tela/notificação de chamada recebida é exibida.
Depois da chamada, ou se nenhuma chamada chegar em um período de segurança, o app volta a dormir.

            Durante o tempo em que o app está acordando por push, quem está ligando pode ouvir tom de chamada
            enquanto o servidor aguarda alguns segundos para o ramal registrar e receber a ligação.
        

Se o usuário desregistrar manualmente um ramal, o push daquele ramal deve ser respeitado como desativado para este aparelho até que o usuário toque em Conectar novamente.

Estimativa de consumo de bateria

O consumo de bateria pode variar conforme o modelo do aparelho, versão do Android, qualidade da internet, uso de Wi-Fi ou dados móveis, intensidade do sinal, quantidade de ramais, frequência de renovação do registro SIP, uso de chamadas e configuração de push da empresa ou instituição.

Sempre conectado: tende a ter consumo médio, pois mantém o serviço SIP ativo, a notificação persistente e os ramais com Auto Conectar registrados em segundo plano. Em uso comum, pode representar aproximadamente 2% a 8% de bateria ao longo do dia, podendo variar para mais ou para menos conforme o aparelho e a rede.
Economia de bateria: tende a ter consumo baixo a médio, pois não tenta manter o serviço SIP vivo permanentemente após o app ser removido dos recentes. Quando há push disponível, o app acorda apenas quando necessário para receber chamadas. Em uso comum, pode representar aproximadamente 0,5% a 3% de bateria ao longo do dia, dependendo do uso e da disponibilidade de push.
App fechado, ramais desregistrados ou sem push: tende a ter consumo muito baixo, pois não mantém ramais SIP registrados. Nessa situação, o recebimento de chamadas pode não ocorrer até que o app seja aberto novamente, salvo quando houver push disponível e ativo.

            As porcentagens são apenas estimativas. O consumo real pode mudar bastante de um aparelho para outro.
            Redes móveis com sinal fraco, troca constante entre Wi-Fi e dados móveis, vários ramais registrados ou muitas chamadas
            podem aumentar o consumo.
        

Para maior disponibilidade de chamadas, prefira Sempre conectado. Para reduzir consumo de bateria e aceitar maior dependência de push, use Economia de bateria.

Remover dos recentes / Clear all

Em alguns aparelhos, o botão Clear all ou a ação de remover o app dos recentes pode encerrar o aplicativo.

No modo Sempre conectado, o app tenta manter o serviço ativo.
No modo Economia de bateria, o app tenta desregistrar os ramais antes de encerrar o serviço.
Se houver push disponível, o app pode ser acordado novamente quando uma chamada chegar.

Em modo Economia de bateria, remover o app dos recentes pode interferir no recebimento de chamadas, especialmente se a empresa ou instituição não possuir push configurado.

Diferença entre Auto Conectar e modo global

Auto Conectar: opção individual de cada ramal, usada para registrar o ramal ao abrir o app.
Modo global: configuração do aplicativo que define se o serviço SIP será mantido em segundo plano.
Push: recurso da empresa ou instituição que pode acordar o app quando uma chamada chegar.

            Exemplo: um ramal pode estar com Auto Conectar ativado e o aplicativo estar em Economia de bateria.
            Nesse caso, o ramal registra ao abrir o app. Se o app for removido dos recentes, o ramal pode ser desregistrado
            e voltar a depender do push para acordar quando uma chamada chegar.
        

Voltar ao topo

17. Sair do aplicativo

Ao usar a opção Sair do aplicativo, o app desregistra os ramais, encerra o serviço SIP e deixa de manter os ramais ativos em segundo plano.

Minimizar

Quando você apenas minimiza o app, ele pode continuar com o serviço em execução para manter os ramais disponíveis, dependendo do modo selecionado nas Configurações.

Quando o app está minimizado, uma notificação persistente pode aparecer no telefone indicando que o serviço SIP está em execução e pronto para receber chamadas.

Sair do aplicativo

Quando você sai pelo menu, o app desregistra as contas e encerra o serviço. Essa opção deve ser usada quando você realmente não deseja manter o softphone ativo.

Use a opção Sair do aplicativo somente quando realmente desejar encerrar o funcionamento do softphone. Para continuar disponível para chamadas, apenas minimize o aplicativo ou use o modo Sempre conectado.

Remover dos recentes

Remover o app dos recentes não é a mesma coisa que usar a opção Sair do aplicativo. O comportamento pode variar conforme o modo escolhido nas Configurações e conforme o fabricante do aparelho.

            No modo Economia de bateria, ao remover o app dos recentes, o TchêFone tenta desregistrar os ramais,
            remove a notificação persistente após alguns segundos e pode exibir um aviso informativo.
        

Se sua empresa ou instituição possui push ativo, o app pode ser acordado novamente quando uma chamada chegar para um ramal com push habilitado e que não esteja desregistrado manualmente.

Forçar parada do aplicativo pelas configurações do Android ou pelo ambiente de desenvolvimento pode impedir o recebimento de push até que o app seja aberto novamente.

Voltar ao topo

18. Logout da Central Telefônica VoIP

O logout da Central Telefônica VoIP desconecta apenas a sessão da central/API.

Ao continuar, o usuário ficará sem acesso aos recursos vinculados à Central Telefônica, como a agenda da central, mas os ramais já salvos neste aparelho serão mantidos e continuarão disponíveis para efetuar e receber ligações.

Contas manuais não são removidas pelo logout da Central.

O logout da Central é diferente de sair do aplicativo. Para encerrar os ramais e parar o serviço SIP, use a opção Sair do aplicativo.

Voltar ao topo

19. Dicas de uso

Mantenha o aplicativo atualizado;
Permita notificações;
Não force o fechamento do aplicativo se quiser receber chamadas constantemente;
Verifique se há internet disponível;
Confirme se o ramal aparece como Registrado antes de realizar chamadas;
Use Auto Conectar nos ramais que deseja registrar ao abrir o app;
Use o modo Sempre conectado se quiser maior disponibilidade para receber chamadas;
Use o modo Economia de bateria se quiser reduzir o consumo e aceitar depender mais do push em segundo plano;
Se a empresa ou instituição não utiliza push, prefira o modo Sempre conectado para receber chamadas com mais segurança;
Use Sair do aplicativo apenas quando quiser encerrar os ramais.

Alguns fabricantes de aparelhos podem aplicar restrições próprias de bateria. Se você tiver dificuldade para receber chamadas em segundo plano, verifique também as configurações de bateria do Android para o aplicativo.

Voltar ao topo

20. Problemas comuns

O discador está desabilitado

Provável causa: nenhum ramal está registrado.

Solução: abra Ramais salvos e toque em Conectar.

Não recebo chamadas

Verifique:

Se o ramal está registrado;
Se a internet está funcionando;
Se as notificações estão permitidas;
Se o app não foi fechado forçadamente;
Se a conta não foi desregistrada manualmente;
Se o modo Economia de bateria está ativo;
Se sua empresa ou instituição possui push configurado, quando necessário.

Recebi aviso de economia de bateria

Esse aviso pode aparecer quando o aplicativo é removido dos recentes em modo Economia de bateria. Ele informa que o serviço SIP foi pausado e que chamadas em segundo plano podem depender do push.

Ao abrir o aplicativo novamente, esse aviso é removido automaticamente.

O app acordou por push e depois voltou a dormir

Esse comportamento é esperado no modo Economia de bateria. O app pode acordar temporariamente para registrar o ramal e receber uma chamada. Depois que a chamada termina, ou se nenhuma chamada chegar após um período de segurança, ele pode desregistrar novamente e voltar ao estado de economia.

O ramal aparece desconectado ao abrir o app

Ao abrir o app, os ramais com Auto Conectar ativado devem tentar registrar novamente. Aguarde alguns segundos e verifique se o status muda para Conectando ou Registrado.

Se continuar desconectado, toque em Conectar no ramal desejado e verifique a internet, usuário, senha, servidor e porta SIP.

A chamada demora alguns segundos para tocar no app

Quando o app está em Economia de bateria e precisa ser acordado por push, pode existir uma pequena espera enquanto o servidor envia o push, o app registra o ramal e a chamada é entregue.

Durante esse intervalo, quem está ligando pode ouvir tom de chamada enquanto o processo é concluído.

A notificação persistente aparece no telefone

Isso é esperado quando o serviço SIP está em execução. Essa notificação indica que o aplicativo está mantendo os ramais disponíveis para receber chamadas.

A notificação persistente demora alguns segundos para sumir após Clear all

Isso é esperado no modo Economia de bateria. O aplicativo aguarda alguns segundos para tentar enviar o desregistro dos ramais ao servidor SIP antes de remover a notificação e parar o serviço.

O app está consumindo mais bateria do que eu esperava

Verifique:

Se o modo Sempre conectado está ativo;
Se há vários ramais com Auto Conectar ativado;
Se o aparelho está com sinal fraco de Wi-Fi ou dados móveis;
Se o aparelho alterna com frequência entre Wi-Fi e rede móvel;
Se há muitas chamadas ou tentativas de chamada;
Se o servidor SIP exige renovação de registro com muita frequência.

Para reduzir o consumo, use o modo Economia de bateria, lembrando que chamadas em segundo plano podem depender mais do push, quando disponível.

A chamada toca, mas a tela não aparece

Verifique se as notificações estão permitidas e se o aparelho não está bloqueando notificações em tela cheia.

O ramal fica em “Conectando”

Verifique:

Servidor SIP;
Porta;
Transporte;
Usuário e senha;
Conexão com a internet;
Se o servidor SIP ou PABX está acessível.

Não consigo fazer login

Verifique:

Token;
Usuário;
Senha;
Conexão com a internet;
Se a Central Telefônica VoIP está disponível.

Não vejo a agenda da Central

Verifique:

Se você está logado na Central Telefônica VoIP;
Se o token informado é válido;
Se sua empresa ou instituição possui agenda cadastrada;
Se há conexão com a internet.

Voltar ao topo

21. Segurança

O aplicativo utiliza as informações fornecidas pelo usuário para registrar ramais e permitir chamadas VoIP.

O token informado no login identifica a empresa ou instituição e permite que o aplicativo carregue as configurações corretas da Central Telefônica VoIP.

As credenciais da API podem ser salvas no aparelho somente se o usuário escolher essa opção.

O modo de funcionamento em segundo plano pode alterar a disponibilidade do ramal para receber chamadas, mas não altera os dados de autenticação do ramal.

Não compartilhe seu token, usuário, senha ou dados do ramal com terceiros.

Voltar ao topo