👨‍👩‍👧 Guía de configuración asistida por familia

Descripción general: Cómo funciona Magic Link

La función Magic Link permite que una persona con conocimientos técnicos ("el administrador") haga todo el trabajo de configuración y luego lo comparta como un enlace especial. Cuando la persona mayor toca ese enlace en su teléfono, TapAlert aplica automáticamente la configuración completa — contactos, mensajes, ajustes y todo — en un solo paso.

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 mayor nunca necesita escribir nada ni navegar por ningún ajuste.

Antes de empezar: Lo que necesitarás

Según cómo quieras configurar la entrega de alertas, ten a mano lo siguiente antes de empezar:

Siempre necesario

• El nombre de pila de la persona mayor (para personalizar los mensajes de alerta)
• Números de teléfono de las personas que deben recibir las alertas (familia, vecinos, etc.)

Opcional: Para SMS automatizados mediante Twilio

Si quieres que las alertas se envíen automáticamente sin necesidad de tener ninguna aplicación abierta en el teléfono de la persona mayor:

• Una cuenta de Twilio (prueba gratuita disponible en twilio.com)
• SID de cuenta de Twilio (del panel de la consola de Twilio)
• Token de autenticación de Twilio (del panel de la consola de Twilio)
• Un número de teléfono de Twilio, O un nombre de remitente alfanumérico (p. ej., "TapAlert") si tu país lo admite
• Tu propio número de teléfono — la aplicación enviará un SMS de prueba para verificar que Twilio funciona

Opcional: Para redundancia de correo electrónico

Si quieres que las alertas también se envíen por correo electrónico además de por SMS:

• Una dirección de correo electrónico dedicada para el envío (Gmail, Outlook, iCloud, Yahoo o personalizada)
• Una contraseña de aplicación para esa cuenta (ver el Paso 4 más abajo)

Paso 1: Abrir la configuración de administrador en tu teléfono

1. Instala TapAlert en tu propio teléfono (necesitas la aplicación para generar el Magic Link).
2. Abre TapAlert.
3. Si aún no has completado la configuración inicial, pasa por las pantallas de permisos. En la última pantalla, toca «Configurar para otra persona».
4. Si TapAlert ya está instalado y configurado, ve a Ajustes → desplázate hasta el final → toca «Configuración de administrador / Magic Link».

Se abrirá la pantalla de configuración de administrador. Desplázate por las secciones: las irás completando en los pasos siguientes.

Paso 2: Introducir el nombre de la persona mayor

En la sección «Información del usuario» en la parte superior de la pantalla:

• Nombre de la persona mayor — Escribe su nombre de pila (p. ej., «María»). Este nombre aparece en los mensajes de alerta para que los destinatarios sepan quién la envió.

Paso 3: Configurar el envío de SMS (Twilio)

Opción A: Sin Twilio (la más sencilla)

Deja el interruptor «Activar SMS de Twilio» desactivado.

• En Android, la aplicación envía SMS directamente usando la SIM del teléfono, sin necesidad de Twilio.
• En iPhone, la aplicación abre la app Mensajes con el texto ya escrito y la persona mayor toca Enviar una vez. Sencillo pero requiere un paso adicional.

Opción B: Con Twilio (recomendado para automatización completa)

1. Activa el interruptor «Activar SMS de Twilio».
2. Introduce el SID de cuenta de tu consola de Twilio (empieza por «AC…»).
3. Introduce el Auth Token de tu consola de Twilio (toca el icono de ojo para mostrar/ocultar).
4. Elige cómo identificar al remitente:
   • Número de Twilio — Introduce el número de Twilio (p. ej., +12015551234). Selecciona primero la bandera del país.
   • Nombre del remitente — Activa «Usar nombre alfanumérico» y escribe un nombre corto (p. ej., «TapAlert»). Nota: no disponible en todos los países (p. ej., EE. UU.).
5. Tu número — Introduce tu propio número. La aplicación envía un SMS de prueba para confirmar que Twilio funciona antes de generar el enlace.

Paso 4: Configurar alertas por correo electrónico (opcional)

Las alertas por correo envían una copia de cada alerta a los destinatarios que tienen dirección de correo. Es una copia de seguridad útil si el SMS falla.

1. Activa el interruptor «Activar redundancia de correo».
2. Selecciona tu proveedor de correo: Gmail, Outlook, Hotmail, Yahoo Mail, iCloud Mail (configuración automática) o SMTP personalizado.
3. Introduce la dirección de correo desde la que se enviará, idealmente una dirección dedicada y no el buzón personal de la persona mayor.
4. Introduce la contraseña de aplicación para esa cuenta.

Cómo obtener una contraseña de aplicación

Las contraseñas habituales de correo no funcionan. Los proveedores de correo requieren contraseñas de aplicación para apps que se conectan por SMTP.

Gmail

1. Ve a myaccount.google.com → Seguridad
2. Activa la verificación en 2 pasos si aún no está activada
3. Vuelve a Seguridad → «Contraseñas de aplicaciones»
4. Crea una nueva contraseña de aplicación, nómbrala «TapAlert» y copia el código de 16 caracteres

Outlook / Hotmail

1. Ve a account.live.com/proofs/manage
2. En «Contraseñas de aplicaciones», crea una nueva llamada «TapAlert»

Yahoo Mail

1. Ve a account.yahoo.com/security
2. En «Contraseñas de aplicaciones», genera una llamada «TapAlert»

iCloud Mail

1. Ve a appleid.apple.com → Inicio de sesión y seguridad → Contraseñas específicas de apps
2. Haz clic en el botón +, nómbralo «TapAlert» y copia la contraseña

Paso 5: Añadir contactos de emergencia

En la sección «Contactos de emergencia», por cada persona que debe recibir las alertas de la persona mayor:

1. Introduce su nombre en el campo Nombre (p. ej., «Carlos» o «Dr. García»).
2. Introduce su número de teléfono: selecciona primero la bandera del país correcto y luego escribe el número.
3. Toca el botón + azul para añadirlos a la lista.
4. Repite para cada contacto. Puedes añadir todos los que necesites (hasta 50 con premium; la versión gratuita admite 1).

Para eliminar un contacto, toca el icono de papelera roja junto a su nombre.

Paso 6: Escribir mensajes de alerta preconfigurados

En la sección «Mensajes de alerta», puedes escribir hasta 3 mensajes listos para usar:

• Mensaje 1 — El mensaje principal de emergencia (p. ej., «Necesito ayuda, llámame»)
• Mensaje 2 — Un mensaje de «estoy bien» o de registro (p. ej., «Estoy bien, no os preocupéis»)
• Mensaje 3 — Otro mensaje personalizado (p. ej., «Me he caído, ven por favor»)

Estos aparecerán como botones grandes en la pantalla principal del mayor para que pueda enviar una alerta con un solo toque, sin escribir nada.

Paso 7: Elegir la configuración de la app

En la sección «Configuración de la app», configura cómo se comporta la app para el mayor:

Cuenta atrás de la alerta

Cuántos segundos esperar después de que el mayor toque el botón de alerta antes de que se envíe realmente.

• 0 segundos — envía inmediatamente, sin posibilidad de cancelar
• 3–10 segundos — recomendado para la mayoría de los mayores; da tiempo para cancelar si se pulsa por error
• 15–30 segundos — si el mayor tiende a tocar accidentalmente

Modo de activación

• Toque único — toca una vez para iniciar la cuenta atrás (más fácil para mayores con movilidad limitada)
• Mantener pulsado — mantén el botón pulsado para confirmar (evita envíos accidentales)

Apariencia

• Predeterminado del sistema — sigue la configuración de modo claro/oscuro del teléfono
• Modo claro — fondo siempre claro
• Modo oscuro — fondo siempre oscuro (más cómodo para los ojos con poca luz)

Idioma

Selecciona el idioma para la interfaz de la app. Disponible: English, Español, Català, Français, Deutsch, Italiano, Nederlands, Português, Euskara, Galego.

Paso 8: Generar y compartir el Magic Link

Una vez que todas las secciones estén completadas:

1. Desplázate hasta la parte inferior de la pantalla.
2. Toca el botón "Generar y compartir Magic Link" (botón azul grande).

Qué ocurre a continuación:

Fase de prueba (tarda unos segundos):

• Si Twilio está activado: la app envía un SMS de prueba real a tu número de teléfono para verificar que funciona. Deberías recibirlo en segundos.
• Si el correo electrónico está activado: la app envía un correo de prueba a la dirección de correo que introdujiste. Comprueba tu bandeja de entrada.
• Si las pruebas fallan, aparece un mensaje de error. Comprueba tus credenciales e inténtalo de nuevo.

Fase de compartir:

• La hoja de compartir del sistema se abre automáticamente.
• Envía el Magic Link al mayor por WhatsApp, iMessage, correo electrónico, SMS o cualquier app de mensajería que uses.

Paso 9: El mayor abre el Magic Link

En el teléfono del mayor (con TapAlert instalado):

1. El mayor recibe el mensaje que enviaste.
2. Toca el enlace.
3. TapAlert se abre automáticamente y muestra una pantalla de confirmación: "¿Listo para configurar TapAlert para [Nombre]?" con un resumen de lo que se configurará.
4. El mayor toca "Sí, configurarlo" (o el botón equivalente).
5. La app aplica toda la configuración al instante.
6. Aparece un mensaje de éxito y la app se abre en la pantalla principal — lista para usar.

Eso es todo. El mayor no necesita introducir ninguna configuración, escribir ninguna credencial ni tomar ninguna decisión.

Si TapAlert no está instalado aún en el teléfono del mayor

1. Primero instala TapAlert desde la App Store (iOS) o Google Play (Android).
2. Pasa por la pantalla de permisos (ubicación, micrófono, contactos, notificaciones).
3. Luego toca el Magic Link — se aplicará durante el proceso de incorporación.

Paso 10: Verificar que todo funciona

Después de aplicar el Magic Link, haz una prueba rápida:

1. Abre TapAlert en el teléfono del mayor.
2. Deberías ver el nombre del mayor en la pantalla principal.
3. Toca uno de los botones de alerta.
4. Espera la cuenta atrás (o envía inmediatamente si la cuenta atrás es 0).
5. Confirma que todos los contactos configurados reciben el SMS (y el correo electrónico, si está configurado).
6. Comprueba que el texto del mensaje y el enlace de ubicación son correctos.

Después de la configuración: Lo que ve el mayor

La app del mayor se abre directamente en la pantalla del Modo Pánico — un botón de emergencia simple a pantalla completa. La interfaz está diseñada para usarse sin leer nada:

• Botón rojo SOS grande en el centro — toca para enviar una alerta de emergencia
• Botón verde OK grande abajo — toca para enviar un mensaje de «Estoy bien»
• Desliza a la izquierda para ver los botones de mensajes preconfigurados (si se configuraron mensajes)

El mayor nunca necesita entrar en Configuración ni entender cómo funciona nada.

Configurar varios mayores

Puedes configurar TapAlert para varios mayores sin empezar desde cero cada vez:

1. Después de generar el primer Magic Link, toca "Configurar otro mayor" en el diálogo de finalización.
2. El formulario borra el nombre y los contactos del mayor, pero conserva tus credenciales de Twilio, la configuración de correo y las preferencias de la app.
3. Cambia solo lo que es diferente (nombre, contactos, mensajes) para el próximo mayor.
4. Genera y comparte un nuevo Magic Link.

Solución de problemas

Error de «validación fallida» al generar el enlace

• Comprueba que todos los campos obligatorios estén completados (marcados con un mensaje de error rojo).
• Si Twilio está activado, asegúrate de que el Account SID, el Auth Token y el número de teléfono son correctos.
• Si el correo electrónico está activado, verifica la Contraseña de la App — las contraseñas de cuenta normales no funcionarán.

El mayor no recibió el SMS de prueba

• Verifica que el número de teléfono de Twilio esté activo y no sea un número de prueba enviando a números no verificados.
• En la prueba gratuita de Twilio, solo puedes enviar a números de teléfono que hayas verificado en la Consola de Twilio. Añade los contactos del mayor como números verificados, o actualiza a una cuenta de pago.
• Comprueba que el formato del número de teléfono es correcto (código de país incluido).

El Magic Link no abre TapAlert

• Asegúrate de que TapAlert esté instalado en el teléfono del mayor.
• En algunos teléfonos Android, mantén pulsado el enlace y elige "Abrir con TapAlert" en lugar de un navegador.
• Si en su lugar se abre un navegador, copia la URL completa y pégala de nuevo en el navegador — en el segundo intento, el sistema suele ofrecer TapAlert como opción.

El mayor toca accidentalmente el botón equivocado

• Aumenta la Cuenta atrás de la alerta a 10–15 segundos — esto da tiempo para cancelar antes de enviar.
• O cambia al Modo mantener pulsado (modo de activación = mantener) para que el botón requiera una pulsación deliberada.
• Puedes actualizar estos ajustes generando un nuevo Magic Link con los ajustes corregidos y enviándolo al teléfono del mayor.

El SMS de Twilio funciona pero el correo electrónico no

• Causa más común: los destinatarios no tienen dirección de correo electrónico guardada. Comprueba los destinatarios en la pantalla de Destinatarios de la app.
• Asegúrate de que la Contraseña de la App es correcta y no ha caducado. Las Contraseñas de App de Gmail y Outlook pueden ser revocadas — genera una nueva si es necesario.

Notas de seguridad y privacidad

• El contenido del Magic Link está codificado pero no cifrado. Cualquiera que lo intercepte puede leer la configuración, incluidas las credenciales de Twilio. Compártelo solo directamente con el mayor.
• TapAlert no tiene servidores — el Magic Link se procesa íntegramente en el dispositivo del mayor. No se envían datos al servicio TapAlert.
• Las credenciales de Twilio en el enlace se almacenan localmente en el dispositivo del mayor en almacenamiento seguro (cifrado) una vez aplicadas.
• Si crees que un Magic Link ha sido interceptado, rota tu Auth Token de Twilio en la Consola de Twilio inmediatamente y genera un nuevo Magic Link.

Tarjeta de referencia rápida (para imprimir para el mayor)

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

Rellena el tiempo de cuenta atrás que configuraste (p. ej., «10 segundos»).