👨👩👧 Guida alla configurazione assistita dalla famiglia
Configurare TapAlert per un anziano con Magic Link
Questa guida è per familiari, caregiver e chiunque aiuti una persona anziana o meno esperta di tecnologia a configurare completamente TapAlert. Utilizzando la funzione Magic Link, puoi configurare l'intera app dal tuo dispositivo e consegnare una configurazione pronta all'uso con un solo tocco.
Panoramica: Come funziona Magic Link
La funzione Magic Link consente a una persona esperta di tecnologia ("l'admin") di fare tutto il lavoro di configurazione e condividerlo come link speciale. Quando l'anziano tocca quel link sul telefono, TapAlert applica automaticamente la configurazione completa — contatti, messaggi, impostazioni e tutto — in un solo passaggio.
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!
L'anziano non ha mai bisogno di digitare nulla o navigare tra le impostazioni.
Prima di iniziare: Cosa ti servirà
A seconda di come vuoi configurare la consegna degli avvisi, raccogli questi elementi prima di iniziare:
Sempre necessario
- Il nome dell'anziano (usato per personalizzare i messaggi di avviso)
- Numeri di telefono delle persone che devono ricevere gli avvisi (famiglia, vicini, ecc.)
Opzionale: Per SMS automatici tramite Twilio
Se vuoi che gli avvisi vengano inviati automaticamente senza che nessuna app sul telefono dell'anziano debba essere aperta:
- Un account Twilio (prova gratuita disponibile su twilio.com)
- Account SID di Twilio (dalla dashboard della console Twilio)
- Auth Token di Twilio (dalla dashboard della console Twilio)
- Un numero di telefono Twilio, OPPURE un nome mittente alfanumerico (es. "TapAlert") se il tuo paese lo supporta
- Il tuo numero di telefono — l'app invierà un SMS di prova per verificare che Twilio funzioni
Opzionale: Per la ridondanza e-mail
Se vuoi che gli avvisi vengano inviati anche via e-mail oltre agli SMS:
- Un indirizzo e-mail dedicato per l'invio (Gmail, Outlook, iCloud, Yahoo o personalizzato)
- Una password per l'app per quell'account (vedi il Passaggio 4 sotto)
Passo 1: Aprire la configurazione amministratore sul telefono
- Installa TapAlert sul tuo telefono (hai bisogno dell'app per generare il Magic Link).
- Apri TapAlert.
- Se non hai ancora completato l'onboarding, scorri le schermate dei permessi. Nell'ultima schermata, tocca «Configura per qualcun altro».
- Se TapAlert è già installato, vai su Impostazioni → scorri fino in fondo → tocca «Configurazione admin / Magic Link».
Si aprirà la schermata di configurazione amministratore. Scorri le sezioni — le compilerai nei passaggi seguenti.
Passo 2: Inserire il nome dell'anziano
Nella sezione «Informazioni utente» in cima alla schermata:
- Nome dell'anziano — Digita il suo nome (es. «Maria»). Questo nome appare nei messaggi di avviso così i destinatari sanno chi lo ha inviato.
Passo 3: Configurare l'invio di SMS (Twilio)
Opzione A: Senza Twilio (la più semplice)
Lascia il pulsante «Abilita SMS Twilio» disattivato.
- Su Android, l'app invia SMS direttamente tramite la SIM — Twilio non è necessario.
- Su iPhone, l'app apre l'app Messaggi già compilata e l'anziano tocca Invia una volta. Semplice ma richiede un passaggio in più.
Opzione B: Con Twilio (consigliato per la piena automazione)
- Attiva «Abilita SMS Twilio».
- Inserisci l'Account SID dalla console Twilio (inizia con «AC…»).
- Inserisci l'Auth Token dalla console Twilio (tocca l'icona occhio per mostrare/nascondere).
- Scegli come identificare il mittente:
- Numero Twilio — Inserisci il numero Twilio (es. +12015551234). Seleziona prima la bandiera del paese.
- Nome mittente — Attiva «Usa nome alfanumerico» e digita un nome breve (es. «TapAlert»). Nota: non supportato in tutti i paesi (es. USA).
- Il tuo numero — Inserisci il tuo numero. L'app invia un SMS di prova per confermare che Twilio funziona prima di generare il link.
Passo 4: Configurare gli avvisi e-mail (opzionale)
Gli avvisi e-mail inviano una copia di ogni avviso ai destinatari con indirizzo e-mail. È un utile backup se gli SMS falliscono.
- Attiva «Abilita ridondanza e-mail».
- Seleziona il tuo provider e-mail: Gmail, Outlook, Hotmail, Yahoo Mail, iCloud Mail (impostazioni compilate automaticamente) o SMTP personalizzato.
- Inserisci l'indirizzo e-mail da cui inviare — idealmente un indirizzo dedicato, non la casella personale dell'anziano.
- Inserisci la password per l'app per quell'account.
Come ottenere una password per l'app
Le normali password e-mail non funzionano. I provider e-mail richiedono password per l'app per le app che si connettono tramite SMTP.
Gmail
- Vai su myaccount.google.com → Sicurezza
- Abilita la verifica in 2 passaggi se non è già attiva
- Torna su Sicurezza → «Password per le app»
- Crea una nuova password per l'app, chiamala «TapAlert», copia il codice a 16 caratteri
Outlook / Hotmail
- Vai su account.live.com/proofs/manage
- In «Password per le app», creane una nuova chiamata «TapAlert»
Yahoo Mail
- Vai su account.yahoo.com/security
- In «Password per le app», generane una chiamata «TapAlert»
iCloud Mail
- Vai su appleid.apple.com → Accesso e sicurezza → Password specifiche per le app
- Clicca sul pulsante +, chiamalo «TapAlert» e copia la password
Passo 5: Aggiungere contatti di emergenza
Nella sezione «Contatti di emergenza», per ogni persona che deve ricevere gli avvisi dell'anziano:
- Inserisci il loro nome nel campo Nome (es. «Carlos» o «Dr. García»).
- Inserisci il loro numero di telefono — seleziona prima la bandiera del paese corretto, poi digita il numero.
- Tocca il pulsante + blu per aggiungerli alla lista.
- Ripeti per ogni contatto. Puoi aggiungerne quanti ne hai bisogno (fino a 50 con premium; la versione gratuita ne supporta 1).
Per rimuovere un contatto, tocca l'icona del cestino rosso accanto al suo nome.
Passaggio 6: Scrivi i messaggi di allerta preconfigurati
Nella sezione "Messaggi di allerta", puoi scrivere fino a 3 messaggi pronti all'uso:
- Messaggio 1 — Il messaggio di emergenza principale (es. "Ho bisogno di aiuto, chiamami")
- Messaggio 2 — Un messaggio "sto bene" o di controllo (es. "Sto bene, non preoccuparti")
- Messaggio 3 — Un altro messaggio personalizzato (es. "Sono caduto, venite per favore")
Appariranno come grandi pulsanti sulla schermata principale dell'anziano, consentendogli di inviare un'allerta con un solo tocco, senza digitare nulla.
- Tienili brevi e chiari — gli SMS hanno un limite di 160 caratteri per segmento
- Scrivi nella lingua che l'anziano e i suoi contatti utilizzano
- Lascia un messaggio vuoto se non hai bisogno di tutti e 3 gli spazi
Passaggio 7: Scegliere le impostazioni dell'app
Nella sezione "Impostazioni app", configura come si comporta l'app per l'anziano:
Conto alla rovescia dell'allerta
Quanti secondi attendere dopo che l'anziano preme il pulsante di allerta prima dell'invio effettivo.
- 0 secondi — invia immediatamente, nessuna cancellazione possibile
- 3–10 secondi — consigliato per la maggior parte degli anziani; dà tempo di annullare se premuto per sbaglio
- 15–30 secondi — se l'anziano tende a toccare accidentalmente
Modalità di attivazione
- Tocco singolo — tocca una volta per avviare il conto alla rovescia (più facile per anziani con mobilità ridotta)
- Tieni premuto — tieni il pulsante premuto per confermare (previene gli invii accidentali)
Aspetto
- Predefinito di sistema — segue l'impostazione modalità chiara/scura del telefono
- Modalità chiara — sfondo sempre chiaro
- Modalità scura — sfondo sempre scuro (più riposante per gli occhi in condizioni di scarsa illuminazione)
Lingua
Seleziona la lingua per l'interfaccia dell'app. Disponibili: English, Español, Català, Français, Deutsch, Italiano, Nederlands, Português, Euskara, Galego.
Passaggio 8: Genera e condividi il Magic Link
Una volta che tutte le sezioni sono compilate:
- Scorri fino in fondo allo schermo.
- Tocca il pulsante "Genera e condividi Magic Link" (grande pulsante blu).
Cosa succede dopo:
Fase di test (richiede alcuni secondi):
- Se Twilio è abilitato: l'app invia un vero SMS di test al tuo numero di telefono per verificare che funzioni. Dovresti riceverlo entro pochi secondi.
- Se l'e-mail è abilitata: l'app invia una e-mail di test all'indirizzo inserito. Controlla la tua casella di posta.
- Se i test falliscono, appare un messaggio di errore. Controlla le tue credenziali e riprova.
Fase di condivisione:
- Il pannello di condivisione del sistema si apre automaticamente.
- Invia il Magic Link all'anziano tramite WhatsApp, iMessage, e-mail, SMS o qualsiasi app di messaggistica che usi.
Passaggio 9: L'anziano apre il Magic Link
Sul telefono dell'anziano (con TapAlert installato):
- L'anziano riceve il messaggio che hai inviato.
- Tocca il link.
- TapAlert si apre automaticamente e mostra una schermata di conferma: "Pronto per configurare TapAlert per [Nome]?" con un riepilogo di ciò che verrà configurato.
- L'anziano tocca "Sì, configura" (o il pulsante equivalente).
- L'app applica l'intera configurazione istantaneamente.
- Appare un messaggio di successo e l'app si apre alla schermata principale — pronta all'uso.
Tutto qui. L'anziano non deve inserire impostazioni, digitare credenziali o fare scelte.
Se TapAlert non è ancora installato sul telefono dell'anziano
- Prima installa TapAlert dall'App Store (iOS) o Google Play (Android).
- Passa attraverso la schermata dei permessi (posizione, microfono, contatti, notifiche).
- Poi tocca il Magic Link — verrà applicato durante l'onboarding.
Passaggio 10: Verificare che tutto funzioni
Dopo aver applicato il Magic Link, fai un test rapido:
- Apri TapAlert sul telefono dell'anziano.
- Dovresti vedere il nome dell'anziano sulla schermata iniziale.
- Tocca uno dei pulsanti di allerta.
- Attendi il conto alla rovescia (o invia immediatamente se il conto alla rovescia è 0).
- Conferma che tutti i contatti configurati ricevono l'SMS (e l'e-mail, se configurata).
- Verifica che il testo del messaggio e il link della posizione siano corretti.
Dopo la configurazione: Cosa vede l'anziano
L'app dell'anziano si apre direttamente alla schermata della Modalità Panico — un semplice pulsante di emergenza a schermo intero. L'interfaccia è progettata per essere usata senza leggere nulla:
- Grande pulsante rosso SOS al centro — tocca per inviare un'allerta di emergenza
- Grande pulsante verde OK in basso — tocca per inviare un messaggio "Sto bene"
- Scorri a sinistra per vedere i pulsanti dei messaggi preconfigurati (se i messaggi sono stati configurati)
L'anziano non ha mai bisogno di andare nelle impostazioni o capire come funziona qualcosa.
Configurare più anziani
Puoi configurare TapAlert per più anziani senza ricominciare da capo ogni volta:
- Dopo aver generato il primo Magic Link, tocca "Configura un altro anziano" nella finestra di completamento.
- Il modulo cancella il nome e i contatti dell'anziano, ma mantiene le tue credenziali Twilio, le impostazioni e-mail e le preferenze dell'app.
- Modifica solo ciò che è diverso (nome, contatti, messaggi) per il prossimo anziano.
- Genera e condividi un nuovo Magic Link.
Risoluzione dei problemi
Errore "Validazione fallita" durante la generazione del link
- Verifica che tutti i campi obbligatori siano compilati (contrassegnati con un messaggio di errore rosso).
- Se Twilio è abilitato, assicurati che Account SID, Auth Token e numero di telefono siano corretti.
- Se l'e-mail è abilitata, verifica la Password dell'App — le normali password dell'account non funzioneranno.
L'anziano non ha ricevuto l'SMS di test
- Verifica che il numero di telefono Twilio sia attivo e non sia un numero di prova che invia a numeri non verificati.
- Nella prova gratuita di Twilio, puoi inviare solo a numeri di telefono che hai verificato nella Console Twilio. Aggiungi i contatti dell'anziano come numeri verificati, o aggiorna a un account a pagamento.
- Verifica che il formato del numero di telefono sia corretto (prefisso internazionale incluso).
Il Magic Link non apre TapAlert
- Assicurati che TapAlert sia installato sul telefono dell'anziano.
- Su alcuni telefoni Android, tieni premuto il link e scegli "Apri con TapAlert" invece di un browser.
- Se si apre invece un browser, copia l'URL completo e incollalo di nuovo nel browser — al secondo tentativo, il sistema di solito offre TapAlert come opzione.
L'anziano tocca accidentalmente il pulsante sbagliato
- Aumenta il Conto alla rovescia dell'allerta a 10–15 secondi — questo dà tempo di annullare prima dell'invio.
- O passa alla Modalità tieni premuto (modalità di attivazione = tieni premuto) in modo che il pulsante richieda una pressione prolungata deliberata.
- Puoi aggiornare queste impostazioni generando un nuovo Magic Link con le impostazioni corrette e inviandolo al telefono dell'anziano.
L'SMS Twilio funziona ma l'e-mail no
- Causa più comune: i destinatari non hanno indirizzi e-mail salvati. Controlla i destinatari nella schermata Destinatari dell'app.
- Assicurati che la Password dell'App sia corretta e non sia scaduta. Le Password dell'App di Gmail e Outlook possono essere revocate — genera una nuova se necessario.
Note sulla sicurezza e la privacy
- Il payload del Magic Link è codificato ma non crittografato. Chiunque lo intercetti può leggere la configurazione, comprese le credenziali Twilio. Condividilo solo direttamente con l'anziano.
- TapAlert non ha server — il Magic Link viene elaborato interamente sul dispositivo dell'anziano. Nessun dato viene inviato al servizio TapAlert.
- Le credenziali Twilio nel link vengono memorizzate localmente sul dispositivo dell'anziano in uno storage sicuro (crittografato) una volta applicato.
- Se ritieni che un Magic Link sia stato intercettato, ruota il tuo Auth Token Twilio nella Console Twilio immediatamente e genera un nuovo Magic Link.
Scheda di riferimento rapido (da stampare per l'anziano)
┌─────────────────────────────────────────────┐ │ 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. │ └─────────────────────────────────────────────┘
Inserisci il tempo del conto alla rovescia che hai configurato (es. "10 secondi").