Guia de solução de problemas
Este guia aborda problemas comuns e soluções para TapAlert no Android e no iOS.
1. Problemas de envio de SMS
1.1 SMS direto Não enviando (Android)
Sintoma: você toca em "Enviar alerta", mas o SMS falha. O histórico de alertas mostra um erro para um ou mais destinatários.
- Sem sinal de celular: verifique a barra de status. A página Status do aplicativo mostra o status atual do seu celular.
- Sem cartão SIM: SMS direto requer um cartão SIM funcional. Verifique o status do SIM na página Status.
- Permissões: Garantir permissão de SMS é permitida nas configurações do telefone.
- Formato inválido: use o formato internacional com o código do país (por exemplo, +34600123456).
1.2 Twilio SMS não é enviado
Sintoma: o alerta falha com uma mensagem de erro Twilio.
- Internet necessária: Twilio precisa de Wi-Fi ou dados de celular.
- Credenciais: verifique o SID da conta, o token de autenticação e o número de telefone Twilio em Configurações.
- Limitações da avaliação: contas de avaliação só podem ser enviados para números de telefone verificado.
- Saldo: verifique seu saldo de Twilio conta.
1.3 Problemas do compositor de SMS para iOS
Sintoma: no iPhone, o compositor de SMS abre, mas a mensagem não é entregue.
- Sinal: o aplicativo Mensagens precisa de sinal de celular (ou chamada WiFi, se estiver ativo).
- Cancelamento: se você tocar em Cancelar no compositor, o alerta será cancelado.
- Número inválido: o iOS colocará a mensagem na fila e falhará silenciosamente. Verifique se há pontos de exclamação vermelhos no aplicativo Mensagens.
2. Problemas de redundância de e-mail
2.1 Falha no teste de e-mail
- Configurações de SMTP: verifique o host e a porta (Gmail/iCloud usa 587).
- Senha de aplicativo: a maioria dos provedores exige uma Senha de aplicativo se a 2FA estiver ativada.
- Internet: o e-mail requer uma conexão de dados ativa.
3. Problemas de Localização
3.1 Localização ausente no alerta
- Permissões: Garantir Localização a permissão está definida como "Durante o uso" ou "Sempre".
- GPS desativado: verifique se os serviços de localização do telefone estão ativados.
- Recepção: ambientes internos ou áreas densas podem causar tempo limite do GPS.
4. Conectividade e status
4.2 Significados dos ícones de escudo
- Verde: pronto para entrega confiável de SMS/Twilio.
- Laranja: Incerto. Somente WiFi, sem Twilio. Chamadas WiFi podem funcionar.
- Vermelho: desconectado. Tanto o celular quanto o WiFi estão desligados.
5. Problemas com temporizador de check-in
5.1 O temporizador não dispara
- Aplicativo fechado: evite forçar o fechamento do aplicativo. No iOS, você deve toca na notificação para acioná-la.
- Otimização da bateria: defina TapAlert como "Irrestrito" nas configurações de bateria do Android.
- Notificações: Garantir permissões de notificação são concedidas.
6. Problemas de voz para texto
6.1 O reconhecimento de voz não funciona
- Permissões: Garantir são concedidas permissões de microfone e reconhecimento de fala (iOS).
- Internet: a maioria dos mecanismos de reconhecimento exige uma conexão ativa para processamento.
- Linguagem errado: o reconhecimento usa a configuração de idioma atual do aplicativo. Verifique **Configurações > Linguagem**.
7. Problemas com Contatos e destinatários
7.1 Não consigo ver Contatos
- Acesso limitado ao iOS: se você escolheu anteriormente "Selecione Contatos...", vá para **Configurações > Privacidade e segurança > Contatos > TapAlert** e mude para **"Todos Contatos"**.
- Android Permissões: Garantir **Contatos** a permissão está definida como "Permitir" nas configurações do sistema.
- Formato: Garantir números incluem o código do país com um prefixo **+**.
8. Problemas de compra no aplicativo
8.2 Comprado, mas ainda exibido Livre
- Restaurar compras: na tela de atualização, toque em **Restaurar**botão para revalidar sua compra na loja.
- Same Account: Garantir you're signed in with the same store conta used for the original purchase.
9. Problemas com widgets (Android)
9.1 Widget não aparece
- Adição manual: tente adicionar o widget em **Configurações > Widget > Adicionar** no aplicativo se ele não aparecer no seletor de widget do sistema.
- Otimização da bateria: a otimização agressiva pode impedir que o widget inicie o aplicativo corretamente.
10. Problemas de notificação
10.2 Destinatários que não percebem chamadas/SMS
- iPhone: peça aos destinatários que ativem **Desvio de Emergência** para seu número de contato.
- Android: faça com que os destinatários definam a prioridade de notificação como **"Alto"** ou **"Urgente"** para suas mensagens.
11. Problemas de comportamento do aplicativo
11.1 Alerta dispara imediatamente ao abrir
Vá para **Configurações** e desative **"Início automático ao iniciar"**. Este recurso é destinado a pânico físicobotãos.
12. Problemas específicos do iOS
12.1 Twilio versus Mensagens iOS
- Twilio (Automático): envio silencioso em segundo plano, requer internet.
- Mensagens iOS (Manual): Requer que você toque em Enviar no compositor, funciona via celular.
13. Android-Problemas específicos
13.1 Otimização da bateria
Alguns fabricantes (Xiaomi, Samsung, Huawei) exigem etapas manuais para evitar que o aplicativo seja encerrado em segundo plano. Verifique as configurações da bateria do seu telefone para **"Sem restrições"**.
14. Dicas Gerais
✅ Antes de uma emergência
- Envie um alerta de teste para verificar a configuração.
- Verifique a página Status para conectividade.
- Garantir todas as permissões são concedidas.