Solução de falhas do gateway Android: detecção, repouso e entrega
Doze sintomas com suas causas habituais e correções, a ordem em que convém verificá-los e o checklist de vigília que evita a falha mais comum: um telefone que adormece em silêncio enquanto trabalha.
Verifique nesta ordem
Cada passo tem um resultado esperado; pare no primeiro que falhar.
Mesma rede
Confirme que o PC e o telefone estão na mesma LAN (ou que a VPN está ativa). Resultado esperado: os dois mostram endereços da mesma sub-rede.
Endereço alcançável
Abra o IP e a porta do telefone em um navegador do PC. Resultado esperado: o painel do app carrega. Se não carregar, o problema é de rede, não de software.
App de SMS padrão
Verifique se o app ainda tem o papel de SMS padrão. Resultado esperado: tem; sem ele, as respostas recebidas nunca chegam ao gateway.
Otimização de bateria excluída
Exclua o app da otimização de bateria e de qualquer lista de «sono profundo» do fabricante. Resultado esperado: o app sobrevive à noite com a tela desligada.
Firewall e porta
Deixe o app de desktop passar pelo firewall do PC e confirme que a porta corresponde à do painel do app. Resultado esperado: o dispositivo aparece online no SMS Deliverer.
Envio de teste
Envie uma mensagem para o seu próprio número. Resultado esperado: ela sai do telefone em segundos e o relatório é atualizado. Se falhar aqui, a causa é a SIM ou a operadora, não o vínculo.
A tabela de doze falhas
| # | Sintoma | Causa habitual | Correção |
|---|---|---|---|
| 1 | Conexão recusada | Sub-rede diferente ou isolamento de Wi-Fi para convidados | Mesma rede para os dois dispositivos; desative o isolamento AP no roteador |
| 2 | Painel inacessível após reiniciar o roteador | O DHCP deu ao telefone um novo IP | Reserve um IP fixo para o telefone; adicione o dispositivo novamente |
| 3 | O navegador chega ao painel, o app não | O firewall do PC bloqueia o app de desktop | Permita o SMS Deliverer no firewall para redes privadas |
| 4 | Dispositivo adicionado, mas nunca online | Porta incorreta | Leia novamente a porta no painel do app; não presuma 8080 |
| 5 | O app para de enviar à noite | A otimização de bateria o encerra | Exclua o app; mantenha o carregador conectado |
| 6 | O app morre em segundo plano em poucas horas | Gerenciador de bateria do fabricante (economia de energia agressiva do OEM) | Adicione o app à lista de protegidos ou «nunca dormir» do fabricante; mantenha o telefone na energia |
| 7 | Os envios funcionam, as respostas nunca chegam | O app não é o app de SMS padrão | Restaure o papel de SMS padrão nas configurações do Android |
| 8 | Mensagens presas na fila | Telefone offline, ou SIM ausente ou desativada | Verifique o estado do dispositivo e depois a SIM no próprio telefone, com um SMS manual |
| 9 | SMS funciona, MMS falha | Configurações ou política de MMS da operadora | Confirme primeiro que o MMS funciona manualmente no telefone; consulte a página de MMS para os limites de tamanho |
| 10 | Sem relatórios de entrega | A operadora não os devolve, ou não foram solicitados | Ative a solicitação de relatórios; aceite que algumas operadoras nunca os enviam |
| 11 | Sem sinal onde o telefone está | Posição ou cobertura de banda | Mova o telefone para perto de uma janela; consulte o mapa de cobertura da operadora |
| 12 | Funciona por VPN, mas com timeouts | Latência e quedas do túnel | Mantenha o telefone na LAN quando possível; se a VPN for obrigatória, espere sondagens mais lentas |
O checklist de vigília
- Carregador sempre conectado; um telefone gateway é infraestrutura, não um celular de uso pessoal.
- App excluído da otimização de bateria e da lista de sono profundo do fabricante.
- Wi-Fi configurado para continuar conectado durante o repouso (política de repouso de Wi-Fi do Android).
- IP fixo reservado no roteador, para que o PC nunca perca o endereço.
- O bloqueio de tela e o tempo de espera podem ficar como estão; não param o app depois que a otimização é desativada.
- Após uma reinicialização, abra o app uma vez: se ele reinicia sozinho varia conforme a versão do Android e não foi verificado por nós.
Quando o problema é a operadora, não o app
Se o SMS de teste manual pelo app de mensagens do próprio telefone também falhar, o vínculo está bem e o problema é a SIM ou a operadora: saldo esgotado, plano alterado ou número bloqueado por envio tipo máquina. Nenhuma configuração do gateway corrige isso; a operadora corrige. Para os limites de envio que levam até aí, consulte limites de envio.
Este guia faz parte do cluster de gateway Android: visão geral, multi-SIM, limites de envio, solução de falhas.
Perguntas sobre falhas do gateway
O PC diz que não detecta o telefone. Por onde começo?
Abra o IP e a porta do telefone em um navegador do PC, na mesma rede. Se o painel não carregar, é um problema de rede: sub-rede, isolamento de convidados ou um IP alterado. Se carregar, verifique o firewall e a porta que você digitou.
Por que o app para de enviar durante a noite?
Otimização de bateria. O Android e os gerenciadores de energia do fabricante suspendem apps em segundo plano; exclua o app gateway dos dois e mantenha o telefone no carregador. É a causa individual mais comum de mensagens perdidas.
Por que as mensagens enviadas funcionam, mas as respostas nunca chegam?
O app perdeu o papel de SMS padrão. O Android só entrega os SMS recebidos ao app de mensagens padrão, então restaure esse papel nas configurações do telefone.
Preciso manter a tela ligada?
Não. Depois que a otimização de bateria é excluída e com o telefone na energia, a tela pode bloquear e apagar; o app continua funcionando.
E se um SMS manual pelo próprio telefone também falhar?
Então o problema é a SIM ou a operadora, não o gateway: verifique saldo e estado do plano, e se o número foi bloqueado por envio em massa, só a operadora pode restaurá-lo.