Pular para o conteúdo principal

Atender no celular (Linphone)

Você pode usar seu celular como ramal pra receber e fazer chamadas pelo Adonix, sem precisar estar no computador. O app que usamos é o Linphone — gratuito, disponível pra Android e iOS, e que se conecta direto na nossa central via SIP seguro (TLS).

Quando você termina a configuração, o ramal toca simultaneamente no navegador desktop e no celular. Você atende onde estiver mais cómodo.

Importante Pra receber chamadas com o celular bloqueado ou em segundo plano, é obrigatório seguir todas as etapas — principalmente as permissões de bateria. Sem isso, o Android mata o Linphone e as ligações entrantes não chegam.

Etapa 1 — Instalar o Linphone​

Baixa o app oficial:

Abre o app pela primeira vez e aceita as permissões básicas (microfone, notificações). Se aparecer assistente de configuração, pula ou cancela — vamos configurar pelo Adonix.

Etapa 2 — Aplicar a configuração do seu ramal​

Você não precisa digitar nada manualmente — o Adonix gera um QR code e um link de instalação automática.

Opção A — Pelo desktop (recomendado)​

  1. No navegador do computador, entra no Adonix
  2. Vai em Chamadas → clica no botão Configurar celular no canto superior direito
  3. Clica em "Gerar QR code"
  4. No celular, abre o Linphone, vai pro assistente de configuração e escolhe "Escanear QR code"
  5. Aponta a câmera do celular pro QR no monitor
  6. O Linphone importa as credenciais e mostra "Configuração aplicada"

Opção B — Pelo próprio celular (sem desktop)​

  1. No celular, abre o Adonix (PWA instalado ou pelo navegador)
  2. Vai em Perfil → Telefone Mobile
  3. Clica em "Gerar QR code"
  4. Clica no botão "Abrir direto no Linphone"
  5. O Linphone abre automaticamente e aplica as configurações

Opção C — Colando a URL manualmente​

Se nenhuma das opções acima funcionar:

  1. Na tela de configuração do Adonix, clica em "Copiar" ao lado da URL
  2. Cola num app de notas ou navegador no celular
  3. Toca no link → o Linphone abre e aplica

O QR code expira em 5 minutos Se demorar pra escanear, gere um novo. É proteção: quem escanear o QR registra seu ramal no celular dele.

Etapa 3 — Liberar permissões no Android (CRÍTICO)​

Esta etapa é a mais importante. Sem ela, o Android mata o Linphone em background depois de alguns minutos e você simplesmente para de receber chamadas.

3.1 — Manter o app ativo via serviço​

  1. Abre o Linphone
  2. Vai em Configurações (ícone de engrenagem)
  3. Procura por Avançado
  4. Encontra "Manter aplicativo ativo via serviço" (ou Keep alive service) e confirma que está LIGADO

Vai aparecer uma notificação persistente no Linphone tipo "Linphone está rodando". Não arraste pra fechar — essa notificação é o que mantém o serviço vivo.

3.2 — Desativar otimização de bateria​

  1. Sai do Linphone
  2. Vai nas Configurações do Android
  3. Entra em Apps (ou Aplicativos)
  4. Procura Linphone na lista e abre
  5. Toca em Bateria
  6. Escolhe "Sem restrições" ou "Desativar otimização" (o nome muda por fabricante)

3.3 — Iniciar automaticamente (Xiaomi, Honor, Huawei, Oppo)​

Fabricantes chinesas têm controles extras de bateria que matam apps mesmo com as configurações acima. Se você tem um celular dessas marcas:

  • Xiaomi/Redmi: Configurações → Apps → Linphone → Iniciar automaticamente = ON. Também: Configurações → Bateria → Bloqueador de apps → Linphone → desativado.
  • Honor/Huawei: Configurações → Apps → Linphone → Inicialização → liberar iniciar automaticamente, iniciar secundariamente e executar em background.
  • Oppo/Realme: Configurações → Bateria → Uso de energia em background → Linphone → permitir.

3.4 — Não force-stop o app​

Nunca arrasta o Linphone pra fechar pelo seletor de apps recentes. Se você fizer isso, o Android entende que você quer encerrar e vai matar o serviço.

Etapa 4 — Testar​

  1. Pede pra alguém ligar no número da sua empresa (ou liga você mesmo de outro número)
  2. O celular deve tocar mesmo se estiver com a tela bloqueada
  3. Atende no Linphone normalmente

Se o celular não tocou:

  • Verifica se a notificação persistente do Linphone ainda está visível
  • Confirma se o app abriu e está mostrando "Conectado" / "Registrado" no topo
  • Tenta destrancar o celular, abrir o Linphone manualmente, e ligar de novo — se tocar agora, é problema de bateria/auto-start (volta nas etapas 3.2 e 3.3)

Como fazer chamadas​

Abre o Linphone e digita o número no teclado:

  • Para um ramal interno: digita só o número do ramal (ex: 1002)
  • Para um celular brasileiro: digita DDD + número (ex: 48999999999)
  • Para fixo brasileiro: digita DDD + número (ex: 4830000000)

Sem prefixo internacional Não coloca +55 nem 0 na frente. Nossa central já trata o roteamento. Se você colocar prefixo, pode dar erro de "usuário não encontrado".

Toca no botão verde de chamada. A primeira chamada pode demorar 1-2 segundos pra completar — isso é normal.

Como transferir uma chamada​

Você pode transferir uma chamada em curso pra outro ramal de duas maneiras:

Opção A — Transferência atendida (recomendada)​

Permite você falar com o colega antes de passar a chamada.

  1. Durante a chamada, toca em Nova chamada (ou New Call)
  2. A chamada original fica em hold automaticamente
  3. Abre o teclado e disca o ramal de destino (ex: 1002)
  4. Quando o colega atender, explica a situação
  5. Toca em Transferir (ícone de seta) e confirma
  6. As duas chamadas se conectam e você sai da linha

Opção B — Transferência cega (direta)​

Passa a chamada sem falar com o colega antes.

  1. Durante a chamada, toca em Transferir
  2. Vai aparecer uma lista de contatos do celular — ignora essa lista
  3. No campo de busca/topo, digita o ramal (ex: 1002)
  4. Toca pra confirmar
  5. A chamada é redirecionada imediatamente e você sai da linha

Na transferência cega, você não fica pra confirmar se o colega atendeu — se ninguém atender no destino, a ligação cai.

Trocando de ramal ou removendo a configuração​

Se você precisar reconfigurar (mudou de ramal, vai usar outro celular, etc.):

  1. No Linphone: Configurações → Contas
  2. Toca na conta atual e escolhe Excluir
  3. Volta no Adonix e gera um QR code novo pelo Etapa 2

Resolução de problemas​

"Não consegui completar a ligação" / "Parâmetros de mídia incompatíveis"​

Sua configuração ficou desatualizada. Remove a conta no Linphone (Configurações → Contas → Excluir) e reaplica o provisioning pelo Adonix.

"Usuário não encontrado" ao discar​

Você provavelmente colocou um prefixo internacional (+55) no Linphone manualmente. Vai em Configurações → Conta → Editar e remove qualquer prefixo configurado. Disca apenas o DDD + número.

Celular não toca quando estou com tela bloqueada​

99% dos casos: as permissões de bateria não foram liberadas. Volta nas etapas 3.1 → 3.2 → 3.3 e revisa cada uma. Em fabricantes chinesas (Xiaomi, Honor, Oppo), o passo 3.3 é o mais comum de esquecer.

Notificação "Linphone está rodando" desaparece sozinha​

Você arrastou ela pra fechar, ou o sistema a removeu. Reabre o Linphone e ela volta — mas isso indica que o Android não deu a permissão certa. Confere as etapas 3.1 e 3.2 de novo.

Áudio só de um lado durante a chamada​

Geralmente NAT/firewall na rede móvel. Tenta sair do WiFi e usar 4G (ou vice-versa) pra confirmar. Se persistir em ambas as redes, fala com o suporte.

Bateria acabando rápido​

O modo "Manter aplicativo ativo" usa mais bateria que o normal porque mantém uma conexão TLS sempre aberta com a central. Esperado consumir entre 10-20% extra por dia. Compromisso necessário pra receber chamadas confiavelmente.

Limitações conhecidas​

  • O Linphone não sincroniza com a sua agenda do Adonix — é um app separado, com configuração própria
  • Ligações pelo Linphone não aparecem automaticamente no histórico do Adonix vinculadas a um contato (ainda) — só ficam no log de chamadas do PBX
  • Push notification real (acordar o app sem ele estar rodando) não está disponível na nossa configuração atual; por isso o passo 3 é obrigatório
  • A transferência atendida funciona, mas só dentro da mesma chamada do Linphone — não dá pra transferir do desktop pro celular ou vice-versa