👨‍👩‍👧 Guia de configuració assistida per la família

Descripció general: Com funciona Magic Link

La funció Magic Link permet que una persona amb coneixements tècnics ("l'administrador") faci tota la feina de configuració i la comparteixi com un enllaç especial. Quan la persona gran toca aquest enllaç al seu telèfon, TapAlert aplica automàticament la configuració completa — contactes, missatges, ajustos i tot — en un sol pas.

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!

La persona gran mai ha d'escriure res ni navegar per cap ajust.

Abans de començar: El que necessitareu

Segons com vulgueu configurar l'entrega d'alertes, teniu a mà el següent abans de començar:

Sempre necessari

• El nom de la persona gran (per personalitzar els missatges d'alerta)
• Números de telèfon de les persones que han de rebre les alertes (família, veïns, etc.)

Opcional: Per a SMS automatitzats mitjançant Twilio

Si voleu que les alertes s'enviïn automàticament sense necessitat de tenir cap aplicació oberta al telèfon de la persona gran:

• Un compte de Twilio (prova gratuïta disponible a twilio.com)
• SID del compte de Twilio (del tauler de la consola de Twilio)
• Token d'autenticació de Twilio (del tauler de la consola de Twilio)
• Un número de telèfon de Twilio, O un nom de remitent alfanumèric (p. ex., "TapAlert") si el vostre país ho admet
• El vostre propi número de telèfon — l'aplicació enviarà un SMS de prova per verificar que Twilio funciona

Opcional: Per a redundància de correu electrònic

Si voleu que les alertes també s'enviïn per correu electrònic a més dels SMS:

• Una adreça de correu electrònic dedicada per a l'enviament (Gmail, Outlook, iCloud, Yahoo o personalitzada)
• Una contrasenya d'aplicació per a aquell compte (vegeu el Pas 4 més avall)

Pas 1: Obrir la configuració d'administrador al vostre telèfon

1. Instal·leu TapAlert al vostre propi telèfon (necessiteu l'aplicació per generar el Magic Link).
2. Obriu TapAlert.
3. Si encara no heu completat la configuració inicial, passeu per les pantalles de permisos. A l'última pantalla, toqueu «Configurar per a una altra persona».
4. Si TapAlert ja està instal·lat i configurat, aneu a Configuració → desplaceu-vos fins al final → toqueu «Configuració d'administrador / Magic Link».

S'obrirà la pantalla de configuració d'administrador. Desplaceu-vos per les seccions: les anireu completant als passos següents.

Pas 2: Introduir el nom de la persona gran

A la secció «Informació de l'usuari» a la part superior de la pantalla:

• Nom de la persona gran — Escriviu el seu nom (p. ex., «Maria»). Aquest nom apareix als missatges d'alerta perquè els destinataris sàpiguen qui l'ha enviada.

Pas 3: Configurar l'enviament de SMS (Twilio)

Opció A: Sense Twilio (la més senzilla)

Deixeu el commutador «Activa SMS de Twilio» desactivat.

• A Android, l'aplicació envia SMS directament amb la SIM del telèfon, sense necessitat de Twilio.
• A l'iPhone, l'aplicació obre l'app Missatges amb el text ja escrit i la persona gran toca Enviar una vegada. Senzill però requereix un pas addicional.

Opció B: Amb Twilio (recomanat per a l'automatització completa)

1. Activeu el commutador «Activa SMS de Twilio».
2. Introduïu el SID del compte de la consola de Twilio (comença per «AC…»).
3. Introduïu l'Auth Token de la consola de Twilio (toqueu la icona de l'ull per mostrar/ocultar).
4. Trieu com identificar el remitent:
   • Número de Twilio — Introduïu el número de Twilio (p. ex., +12015551234). Seleccioneu primer la bandera del país.
   • Nom del remitent — Activeu «Usa nom alfanumèric» i escriviu un nom curt (p. ex., «TapAlert»). Nota: no disponible a tots els països (p. ex., EUA).
5. El vostre número — Introduïu el vostre propi número. L'aplicació envia un SMS de prova per confirmar que Twilio funciona abans de generar l'enllaç.

Pas 4: Configurar alertes per correu electrònic (opcional)

Les alertes per correu envien una còpia de cada alerta als destinataris que tenen adreça de correu. És una còpia de seguretat útil si el SMS falla.

1. Activeu el commutador «Activa redundància de correu».
2. Seleccioneu el vostre proveïdor de correu: Gmail, Outlook, Hotmail, Yahoo Mail, iCloud Mail (configuració automàtica) o SMTP personalitzat.
3. Introduïu l'adreça de correu des de la qual s'enviarà, idealment una adreça dedicada i no el bústia personal de la persona gran.
4. Introduïu la contrasenya d'aplicació per a aquell compte.

Com obtenir una contrasenya d'aplicació

Les contrasenyes de correu habituals no funcionen. Els proveïdors de correu requereixen contrasenyes d'aplicació per a apps que es connecten per SMTP.

Gmail

1. Aneu a myaccount.google.com → Seguretat
2. Activeu la verificació en 2 passos si encara no està activada
3. Torneu a Seguretat → «Contrasenyes d'aplicació»
4. Creeu una nova contrasenya d'aplicació, anomeneu-la «TapAlert» i copieu el codi de 16 caràcters

Outlook / Hotmail

1. Aneu a account.live.com/proofs/manage
2. A «Contrasenyes d'aplicació», creeu-ne una de nova anomenada «TapAlert»

Yahoo Mail

1. Aneu a account.yahoo.com/security
2. A «Contrasenyes d'aplicació», genereu-ne una anomenada «TapAlert»

iCloud Mail

1. Aneu a appleid.apple.com → Inici de sessió i seguretat → Contrasenyes específiques d'apps
2. Feu clic al botó +, anomeneu-lo «TapAlert» i copieu la contrasenya

Pas 5: Afegir contactes d'emergència

A la secció «Contactes d'emergència», per a cada persona que ha de rebre les alertes de la persona gran:

1. Introduïu el seu nom al camp Nom (p. ex., «Carlos» o «Dr. García»).
2. Introduïu el seu número de telèfon: seleccioneu primer la bandera del país correcte i després escriviu el número.
3. Toqueu el botó + blau per afegir-los a la llista.
4. Repetiu per a cada contacte. Podeu afegir-ne tants com calgui (fins a 50 amb premium; la versió gratuïta n'admet 1).

Per eliminar un contacte, toqueu la icona de paperera vermella al costat del seu nom.

Pas 6: Escriure missatges d'alerta preconfigurats

A la secció «Missatges d'alerta», podeu escriure fins a 3 missatges llests per usar:

• Missatge 1 — El missatge principal d'emergència (p. ex., «Necessito ajuda, truqueu-me»)
• Missatge 2 — Un missatge «estic bé» o de comprovació (p. ex., «Estic bé, no us preocupeu»)
• Missatge 3 — Un altre missatge personalitzat (p. ex., «M'he caigut, veniu si us plau»)

Apareixeràn com a botons grans a la pantalla principal de la persona gran perquè pugui enviar una alerta amb un sol toc, sense escriure res.

Pas 7: Triar la configuració de l'app

A la secció «Configuració de l'app», configureu com es comporta l'app per a la persona gran:

Compte enrere de l'alerta

Quants segons esperar després que la persona gran toqui el botó d'alerta abans que s'enviï realment.

• 0 segons — s'envia immediatament, sense possibilitat de cancel·lar
• 3–10 segons — recomanat per a la majoria de persones grans; dóna temps per cancel·lar si es prem per error
• 15–30 segons — si la persona gran tendeix a tocar accidentalment

Mode d'activació

• Toc únic — toqueu una vegada per iniciar el compte enrere (més fàcil per a persones grans amb mobilitat limitada)
• Mantenir premut — manteniu el botó premut per confirmar (evita enviaments accidentals)

Aparença

• Predeterminat del sistema — segueix la configuració de mode clar/fosc del telèfon
• Mode clar — fons sempre clar
• Mode fosc — fons sempre fosc (més còmode per als ulls amb poca llum)

Idioma

Seleccioneu l'idioma per a la interfície de l'app. Disponible: English, Español, Català, Français, Deutsch, Italiano, Nederlands, Português, Euskara, Galego.

Pas 8: Generar i compartir el Magic Link

Un cop totes les seccions estiguin emplenades:

1. Desplaceu-vos fins a la part inferior de la pantalla.
2. Toqueu el botó "Genera i comparteix el Magic Link" (botó blau gran).

Què passa a continuació:

Fase de prova (triga uns segons):

• Si Twilio està activat: l'app envia un SMS de prova real al vostre número de telèfon per verificar que funciona. Haureu de rebre'l en qestió de segons.
• Si el correu electrònic està activat: l'app envia un correu de prova a l'adreça de correu que heu introduit. Comproveu la vostra bústia d'entrada.
• Si les proves fallen, apareix un missatge d'error. Comproveu les vostres credencials i torneu-ho a intentar.

Fase de compartir:

• El full de compartir del sistema s'obre automàticament.
• Envieu el Magic Link a la persona gran per WhatsApp, iMessage, correu electrònic, SMS o qualsevol app de missatgeria que feu servir.

Pas 9: La persona gran obre el Magic Link

Al telèfon de la persona gran (amb TapAlert instal·lat):

1. La persona gran rep el missatge que heu enviat.
2. Toca l'enllaç.
3. TapAlert s'obre automàticament i mostra una pantalla de confirmació: «Preparats per configurar TapAlert per a [Nom]?» amb un resum del que es configurarà.
4. La persona gran toca "Sí, configura-ho" (o el botó equivalent).
5. L'app aplica tota la configuració al moment.
6. Apareix un missatge d'èxit i l'app s'obre a la pantalla principal — a punt per usar.

Això és tot. La persona gran no necessita introduir cap configuració, escriure cap credencial ni prendre cap decisió.

Si TapAlert no està instal·lat encara al telèfon de la persona gran

1. Primer instal·leu TapAlert des de l'App Store (iOS) o Google Play (Android).
2. Passeu per la pantalla de permisos (ubicació, micròfon, contactes, notificacions).
3. Després toqueu el Magic Link — s'aplicarà durant el procés d'incorporació.

Pas 10: Verificar que tot funciona

Després d'aplicar el Magic Link, feu una prova ràpida:

1. Obriu TapAlert al telèfon de la persona gran.
2. Haureu de veure el nom de la persona gran a la pantalla d'inici.
3. Toqueu un dels botons d'alerta.
4. Espereu el compte enrere (o envieu immediatament si el compte enrere és 0).
5. Confirmeu que tots els contactes configurats reben el SMS (i el correu electrònic, si està configurat).
6. Comproveu que el text del missatge i l'enllaç d'ubicació són correctes.

Després de la configuració: El que veu la persona gran

L'app de la persona gran s'obre directament a la pantalla del Mode Pànic — un botó d'emergència simple a pantalla completa. La interfaz està dissenyada per usar-se sense llegir res:

• Botó vermell SOS gran al centre — toqueu per enviar una alerta d'emergència
• Botó verd OK gran a sota — toqueu per enviar un missatge «Estic bé»
• Llisca cap a l'esquerra per veure els botons de missatges preconfigurats (si es van configurar missatges)

La persona gran mai necessita entrar a Configuració ni entendre com funciona res.

Configurar diverses persones grans

Podeu configurar TapAlert per a diverses persones grans sense començar des de zero cada vegada:

1. Després de generar el primer Magic Link, toqueu "Configura una altra persona gran" al diàleg de finalització.
2. El formulari esborra el nom i els contactes de la persona gran, però conserva les vostres credencials de Twilio, la configuració de correu i les preferències de l'app.
3. Canvieu només el que sigui diferent (nom, contactes, missatges) per a la següent persona gran.
4. Genereu i compartiu un nou Magic Link.

Resolució de problemes

Error de «validació fallida» en generar l'enllaç

• Comproveu que tots els camps obligatoris estiguin completats (marcats amb un missatge d'error vermell).
• Si Twilio està activat, assegureu-vos que l'Account SID, el Auth Token i el número de telèfon són correctes.
• Si el correu electrònic està activat, verifiqueu la Contrasenya de l'App — les contrasenyes de compte normals no funcionaran.

La persona gran no va rebre el SMS de prova

• Verifiqueu que el número de telèfon de Twilio estigui actiu i no sigui un número de prova que enviï a números no verificats.
• A la prova gratuita de Twilio, només podeu enviar a números de telèfon que hagueu verificat a la Consola de Twilio. Afegiu els contactes de la persona gran com a números verificats, o actualitzeu a un compte de pagament.
• Comproveu que el format del número de telèfon és correcte (codi de país inclòs).

El Magic Link no obre TapAlert

• Assegureu-vos que TapAlert estigui instal·lat al telèfon de la persona gran.
• En alguns telèfons Android, manteniu premut l'enllaç i trieu "Obrir amb TapAlert" en lloc d'un navegador.
• Si en canvi s'obre un navegador, copieu la URL completa i enganxeu-la de nou al navegador — en el segon intent, el sistema normalment ofereix TapAlert com a opció.

La persona gran toca accidentalment el botó equivocat

• Augmenteu el Compte enrere de l'alerta a 10–15 segons — això dóna temps per cancel·lar abans d'enviar.
• O canvieu al Mode mantenir premut (mode d'activació = mantenir) perquè el botó requereixi una pulsació deliberada.
• Podeu actualitzar aquests ajustos generant un nou Magic Link amb els ajustos corregits i enviant-lo al telèfon de la persona gran.

El SMS de Twilio funciona però el correu electrònic no

• Causa més freqüent: els destinataris no tenen adreça de correu electrònic desada. Comproveu els destinataris a la pantalla de Destinataris de l'app.
• Assegureu-vos que la Contrasenya de l'App és correcta i no ha caducat. Les Contrasenyes d'App de Gmail i Outlook poden ser revocades — genereu-ne una de nova si cal.

Notes de seguretat i privadesa

• El contingut del Magic Link està codificat però no xifrat. Qualsevol que l'intercepti pot llegir la configuració, inclòs les credencials de Twilio. Compartiu-lo només directament amb la persona gran.
• TapAlert no té servidors — el Magic Link es processa íntegrament al dispositiu de la persona gran. No s'envien dades al servei TapAlert.
• Les credencials de Twilio a l'enllaç s'emmagatzemen localment al dispositiu de la persona gran en emmagatzematge segur (xifrat) un cop aplicades.
• Si creieu que un Magic Link ha estat interceptat, roteu el vostre Auth Token de Twilio a la Consola de Twilio immediatament i genereu un nou Magic Link.

Targeta de referència ràpida (per imprimir per a la persona gran)

┌─────────────────────────────────────────────┐
│            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.         │
└─────────────────────────────────────────────┘

Ompliu el temps de compte enrere que heu configurat (p. ex., «10 segons»).