👨‍👩‍👧 Guia de configuração assistida pela família

Visão geral: Como funciona o Magic Link

A funcionalidade Magic Link permite que uma pessoa com conhecimentos tecnológicos ("o administrador") faça todo o trabalho de configuração e o partilhe como um link especial. Quando o idoso toca nesse link no seu telemóvel, o TapAlert aplica automaticamente a configuração completa — contactos, mensagens, definições e tudo — num único passo.

Admin's phone                         Senior's phone
─────────────────────────────────     ─────────────────────────────────
1. Open Admin Setup screen       →    (senior does nothing yet)
2. Fill in all configuration
3. App tests and validates
4. Generate Magic Link           →    (link shared via WhatsApp, email, etc.)
                                       5. Senior taps the link
                                       6. TapAlert opens and asks to confirm
                                       7. Senior taps "Apply" → app is ready!

O idoso nunca precisa de escrever nada nem navegar pelas definições.

Antes de começar: O que vai precisar

Consoante a forma como pretende configurar a entrega de alertas, reúna o seguinte antes de começar:

Sempre necessário

• O primeiro nome do idoso (para personalizar as mensagens de alerta)
• Números de telefone das pessoas que devem receber os alertas (família, vizinhos, etc.)

Opcional: Para SMS automatizados via Twilio

Se pretende que os alertas sejam enviados automaticamente sem que qualquer app no telemóvel do idoso precise estar aberta:

• Uma conta Twilio (versão de avaliação gratuita disponível em twilio.com)
• Account SID do Twilio (do painel da consola Twilio)
• Auth Token do Twilio (do painel da consola Twilio)
• Um número de telefone Twilio, OU um nome de remetente alfanumérico (ex.: "TapAlert") se o seu país o suportar
• O seu próprio número de telefone — a app enviará um SMS de teste para verificar que o Twilio funciona

Opcional: Para redundância de e-mail

Se pretende que os alertas sejam enviados também por e-mail para além de SMS:

• Um endereço de e-mail dedicado para envio (Gmail, Outlook, iCloud, Yahoo ou personalizado)
• Uma Palavra-passe de aplicação para essa conta (ver Passo 4 abaixo)

Passo 1: Abrir a configuração de administrador no seu telemóvel

1. Instale o TapAlert no seu próprio telemóvel (precisa da app para gerar o Magic Link).
2. Abra o TapAlert.
3. Se ainda não concluiu o onboarding, percorra os ecrãs de permissões. No último ecrã, toque em «Configurar para outra pessoa».
4. Se o TapAlert já está instalado, vá a Definições → role até ao fim → toque em «Configuração admin / Magic Link».

O ecrã de configuração de administrador abrirá. Percorra as secções — preencherá cada uma nos passos seguintes.

Passo 2: Introduzir o nome do idoso

Na secção «Informação do utilizador» no topo do ecrã:

• Nome do idoso — Escreva o seu primeiro nome (ex.: «Maria»). Este nome aparece nas mensagens de alerta para que os destinatários saibam quem a enviou.

Passo 3: Configurar o envio de SMS (Twilio)

Opção A: Sem Twilio (a mais simples)

Deixe o botão «Ativar SMS do Twilio» desativado.

• No Android, a app envia SMS diretamente com o cartão SIM — sem necessidade de Twilio.
• No iPhone, a app abre a app Mensagens já preenchida e o idoso toca em Enviar uma vez. Simples mas requer um passo extra.

Opção B: Com Twilio (recomendado para automação completa)

1. Ative «Ativar SMS do Twilio».
2. Introduza o Account SID da consola Twilio (começa com «AC…»).
3. Introduza o Auth Token da consola Twilio (toque no icone de olho para mostrar/ocultar).
4. Escolha como identificar o remetente:
   • Numero Twilio — Introduza o numero Twilio (ex. +12015551234). Selecione primeiro a bandeira do pais.
   • Nome remetente — Ative «Usar nome alfanumerico» e escreva um nome curto (ex. «TapAlert»). Nota: nao suportado em todos os paises (ex. EUA).
5. O seu numero — Introduza o seu numero. A app envia um SMS de teste para confirmar que o Twilio funciona antes de gerar o link.

Passo 4: Configurar alertas por e-mail (opcional)

Os alertas por e-mail enviam uma cópia de cada alerta para os destinatários com endereço de e-mail. É uma cópia de segurança útil se o SMS falhar.

1. Ative «Ativar redundância de e-mail».
2. Selecione o seu fornecedor de e-mail: Gmail, Outlook, Hotmail, Yahoo Mail, iCloud Mail (definições preenchidas automaticamente) ou SMTP personalizado.
3. Introduza o endereço de e-mail de envio — idealmente um endereço dedicado, não a caixa pessoal do idoso.
4. Introduza a palavra-passe de aplicação para essa conta.

Como obter uma palavra-passe de aplicação

As palavras-passe de e-mail normais nao funcionam. Os fornecedores de e-mail requerem palavras-passe de aplicacao para apps que se ligam via SMTP.

Gmail

1. Vá a myaccount.google.com → Segurança
2. Ative a verificacao em 2 passos se nao estiver já ativa
3. Volte a Segurança → «Palavras-passe de aplicacao»
4. Crie uma nova palavra-passe de aplicacao, nomeie-a «TapAlert», copie o codigo de 16 caracteres

Outlook / Hotmail

1. Va a account.live.com/proofs/manage
2. Em «Palavras-passe de aplicacao», crie uma nova chamada «TapAlert»

Yahoo Mail

1. Va a account.yahoo.com/security
2. Em «Palavras-passe de aplicacao», gere uma chamada «TapAlert»

iCloud Mail

1. Va a appleid.apple.com → Inicio de sessao e Seguranca → Palavras-passe especificas para apps
2. Clique no botao +, nomeie-o «TapAlert» e copie a palavra-passe

Passo 5: Adicionar contactos de emergência

Na secção «Contactos de emergência», para cada pessoa que deve receber os alertas do idoso:

1. Introduza o nome no campo Nome (ex.: «Carlos» ou «Dr. García»).
2. Introduza o número de telefone — selecione primeiro a bandeira do país correto e depois escreva o número.
3. Toque no botão + azul para os adicionar à lista.
4. Repita para cada contacto. Pode adicionar quantos precisar (até 50 com premium; a versao gratuita suporta 1).

Para remover um contacto, toque no ícone da lata do lixo vermelha junto ao nome.

Passo 6: Escrever mensagens de alerta pré-configuradas

Na secção "Mensagens de alerta", pode escrever até 3 mensagens prontas a usar:

• Mensagem 1 — A mensagem de emergência principal (ex.: "Preciso de ajuda, ligue para mim")
• Mensagem 2 — Uma mensagem "Estou bem" ou de check-in (ex.: "Estou bem, não se preocupem")
• Mensagem 3 — Outra mensagem personalizada (ex.: "Caí, por favor venham")

Estes aparecerão como botões grandes no ecrã principal do idoso para que possa enviar um alerta com um único toque, sem escrever nada.

Passo 7: Escolher as definições da app

Na secção "Definições da app", configure o comportamento da app para o idoso:

Contagem decrescente da alerta

Quantos segundos aguardar após o idoso tocar no botão de alerta antes de enviar realmente.

• 0 segundos — envia imediatamente, sem possibilidade de cancelamento
• 3–10 segundos — recomendado para a maioria dos idosos; dá tempo para cancelar se premido por engano
• 15–30 segundos — se o idoso tende a tocar acidentalmente

Modo de ativação

• Toque único — toque uma vez para iniciar a contagem decrescente (mais fácil para idosos com mobilidade limitada)
• Manter premido — mantenha o botão premido para confirmar (evita envios acidentais)

Aparência

• Padrão do sistema — segue a definição de modo claro/escuro do telmóvel
• Modo claro — fundo sempre claro
• Modo escuro — fundo sempre escuro (mais suave para os olhos com pouca luz)

Idioma

Selecione o idioma para a interface da app. Disponível: English, Español, Català, Français, Deutsch, Italiano, Nederlands, Português, Euskara, Galego.

Passo 8: Gerar e partilhar o Magic Link

Depois de preencher todas as secções:

1. Deslize até ao fundo do ecrã.
2. Toque no botão "Gerar e partilhar Magic Link" (botão azul grande).

O que acontece a seguir:

Fase de teste (demora alguns segundos):

• Se o Twilio estiver ativado: a app envia um SMS de teste real para o seu número de telmóvel para verificar que funciona. Deve recebê-lo em segundos.
• Se o e-mail estiver ativado: a app envia um e-mail de teste para o endereço de e-mail que introduziu. Verifique a sua caixa de entrada.
• Se os testes falharem, aparece uma mensagem de erro. Verifique as suas credenciais e tente novamente.

Fase de partilha:

• A folha de partilha do sistema abre automaticamente.
• Envie o Magic Link ao idoso via WhatsApp, iMessage, e-mail, SMS ou qualquer app de mensagens que use.

Passo 9: O idoso abre o Magic Link

No telmóvel do idoso (com o TapAlert instalado):

1. O idoso recebe a mensagem que enviou.
2. Toca no link.
3. O TapAlert abre automaticamente e mostra um ecrã de confirmação: "Pronto para configurar o TapAlert para [Nome]?" com um resumo do que será configurado.
4. O idoso toca em "Sim, configurar" (ou botão equivalente).
5. A app aplica toda a configuração instantaneamente.
6. Aparece uma mensagem de sucesso e a app abre no ecrã principal — pronta a usar.

Só isso. O idoso não precisa de introduzir definições, escrever credenciais nem tomar decisões.

Se o TapAlert ainda não estiver instalado no telmóvel do idoso

1. Primeiro instale o TapAlert na App Store (iOS) ou Google Play (Android).
2. Passe pelo ecrã de permissões (localização, microfone, contactos, notificações).
3. Depois toque no Magic Link — será aplicado durante o processo de ativação.

Passo 10: Verificar que tudo funciona

Após aplicar o Magic Link, faça um teste rápido:

1. Abra o TapAlert no telmóvel do idoso.
2. Deve ver o nome do idoso no ecrã inicial.
3. Toque num dos botões de alerta.
4. Aguarde a contagem decrescente (ou envie imediatamente se a contagem for 0).
5. Confirme que todos os contactos configurados recebem o SMS (e o e-mail, se configurado).
6. Verifique que o texto da mensagem e o link de localização estão corretos.

Após a Configuração: O que o idoso vê

A app do idoso abre diretamente no ecrã do Modo Pânico — um botão de emergência simples em ecrã inteiro. A interface é concebida para ser usada sem ler nada:

• Grande botão vermelho SOS ao centro — toque para enviar um alerta de emergência
• Grande botão verde OK abaixo — toque para enviar uma mensagem "Estou bem"
• Deslize para a esquerda para ver os botões de mensagens pré-configuradas (se as mensagens foram configuradas)

O idoso nunca precisa de ir às Definições ou compreender como funciona.

Configurar vários idosos

Pode configurar o TapAlert para vários idosos sem começar do zero de cada vez:

1. Após gerar o primeiro Magic Link, toque em "Configurar outro idoso" na caixa de diálogo de conclusão.
2. O formulário limpa o nome e os contactos do idoso, mas mantém as suas credenciais Twilio, definições de e-mail e preferências da app.
3. Altere apenas o que é diferente (nome, contactos, mensagens) para o próximo idoso.
4. Gere e partilhe um novo Magic Link.

Resolução de problemas

Erro "Validação falhada" ao gerar o link

• Verifique que todos os campos obrigatórios estão preenchidos (assinalados com uma mensagem de erro vermelha).
• Se o Twilio estiver ativado, certifique-se de que o Account SID, Auth Token e número de telmóvel estão corretos.
• Se o e-mail estiver ativado, verifique a Senha da App — as senhas de conta normais não funcionam.

O idoso não recebeu o SMS de teste

• Verifique que o número de telmóvel do Twilio está ativo e não é um número de teste enviando para números não verificados.
• No trial gratuito do Twilio, só pode enviar para números de telmóvel que verificou na Consola Twilio. Adicione os contactos do idoso como números verificados, ou atualize para uma conta paga.
• Verifique que o formato do número de telmóvel está correto (código de país incluído).

O Magic Link não abre o TapAlert

• Certifique-se de que o TapAlert está instalado no telmóvel do idoso.
• Em alguns telmóveis Android, mantenha o link premido e escolha "Abrir com TapAlert" em vez de um browser.
• Se um browser abrir, copie o URL completo e cole-o novamente no browser — na segunda tentativa, o sistema geralmente oferece o TapAlert como opção.

O idoso toca acidentalmente no botão errado

• Aumente a Contagem decrescente da alerta para 10–15 segundos — isso dá tempo para cancelar antes de enviar.
• Ou mude para o Modo manter premido (modo de ativação = manter) para que o botão requeira uma pressão deliberada.
• Pode atualizar estas definições gerando um novo Magic Link com as definições corrigidas e enviá-lo para o telmóvel do idoso.

O SMS Twilio funciona mas o e-mail não

• Causa mais comum: os destinatários não têm endereços de e-mail guardados. Verifique os destinatários no ecrã de Destinatários da app.
• Certifique-se de que a Senha da App está correta e não expirou. As Senhas de App do Gmail e Outlook podem ser revogadas — gere uma nova se necessário.

Notas de segurança e privacidade

• O payload do Magic Link está codificado mas não encriptado. Qualquer pessoa que o intercepte pode ler a configuração, incluindo credenciais Twilio. Partilhe-o apenas diretamente ao idoso.
• TapAlert não tem servidores — o Magic Link é processado inteiramente no dispositivo do idoso. Nenhum dado é enviado para o serviço TapAlert.
• As credenciais Twilio no link são armazenadas localmente no dispositivo do idoso em armazenamento seguro (encriptado) após serem aplicadas.
• Se acredita que um Magic Link foi interceptado, rode o seu Auth Token do Twilio na Consola Twilio imediatamente e gere um novo Magic Link.

Cartão de referência rápida (para imprimir para o idoso)

┌─────────────────────────────────────────────┐
│            YOUR TAPALERT BUTTONS            │
│                                             │
│  🔴  Big red button  →  Send EMERGENCY      │
│                          alert to family    │
│                                             │
│  🟢  Green button    →  Send "I'm OK"       │
│                          message            │
│                                             │
│  📱  Swipe left      →  More message        │
│                          options            │
│                                             │
│  ────────────────────────────────────────   │
│  After tapping, you have N seconds          │
│  to cancel before it sends.                 │
│  Just press the X button to cancel.         │
└─────────────────────────────────────────────┘

Preencha o tempo de contagem decrescente que configurou (ex.: "10 segundos").