👨‍👩‍👧 Leitfaden zur familiengestützten Einrichtung

Übersicht: So funktioniert Magic Link

Die Magic-Link-Funktion ermöglicht es einer technikaffinen Person ("dem Admin"), die gesamte Konfigurationsarbeit zu erledigen und sie dann als speziellen Link zu teilen. Wenn der Senior diesen Link auf seinem Telefon antippt, wendet TapAlert automatisch die vollständige Konfiguration an — Kontakte, Nachrichten, Einstellungen und alles — in einem einzigen Schritt.

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!

Der Senior muss nie etwas eintippen oder durch Einstellungen navigieren.

Bevor Sie beginnen: Was Sie benötigen

Je nachdem, wie Sie die Alarmazustellung einrichten möchten, bereiten Sie folgendes vor:

Immer erforderlich

• Der Vorname des Seniors (zur Personalisierung der Alarmnachrichten)
• Telefonnummern der Personen, die Alarme erhalten sollen (Familie, Nachbarn usw.)

Optional: Für automatische SMS über Twilio

Wenn Alarme automatisch gesendet werden sollen, ohne dass eine App auf dem Telefon des Seniors geöffnet sein muss:

• Ein Twilio-Konto (kostenlose Testversion auf twilio.com verfügbar)
• Twilio Account SID (aus dem Twilio-Konsolen-Dashboard)
• Twilio Auth Token (aus dem Twilio-Konsolen-Dashboard)
• Eine Twilio-Telefonnummer ODER ein alphanumerischer Absendername (z. B. "TapAlert"), wenn Ihr Land dies unterstützt
• Ihre eigene Telefonnummer — die App sendet eine Test-SMS, um zu überprüfen, ob Twilio funktioniert

Optional: Für E-Mail-Redundanz

Wenn Alarme zusätzlich zu SMS auch per E-Mail gesendet werden sollen:

• Eine dedizierte E-Mail-Adresse zum Senden (Gmail, Outlook, iCloud, Yahoo oder benutzerdefiniert)
• Ein App-Passwort für dieses Konto (siehe Schritt 4 unten)

Schritt 1: Admin-Einrichtung auf Ihrem Telefon öffnen

1. Installieren Sie TapAlert auf Ihrem eigenen Telefon (Sie benötigen die App, um den Magic Link zu generieren).
2. Öffnen Sie TapAlert.
3. Falls Sie das Onboarding noch nicht abgeschlossen haben, gehen Sie die Berechtigungsbildschirme durch. Tippen Sie auf dem letzten Bildschirm auf "Für jemand anderen einrichten".
4. Falls TapAlert bereits installiert ist, gehen Sie zu Einstellungen → scrollen Sie ganz nach unten → tippen Sie auf "Admin-Einrichtung / Magic Link".

Der Admin-Einrichtungsbildschirm öffnet sich. Scrollen Sie durch die Abschnitte — Sie füllen jeden in den folgenden Schritten aus.

Schritt 2: Den Namen des Seniors eingeben

Im Abschnitt "Benutzerinformationen" oben auf dem Bildschirm:

• Name des Seniors — Geben Sie seinen Vornamen ein (z. B. "Maria"). Dieser Name erscheint in Alarmnachrichten, damit die Empfänger wissen, wer den Alarm gesendet hat.

Schritt 3: SMS-Versand konfigurieren (Twilio)

Option A: Ohne Twilio (am einfachsten)

Lassen Sie den Schalter "Twilio SMS aktivieren" ausgeschaltet.

• Auf Android sendet die App SMS direkt über die SIM-Karte — kein Twilio erforderlich.
• Auf iPhone öffnet die App die Nachrichten-App bereits ausgefüllt, und der Senior tippt einmal auf Senden. Einfach, aber ein zusätzlicher Schritt.

Option B: Mit Twilio (empfohlen für vollständige Automatisierung)

1. Schalten Sie "Twilio SMS aktivieren" ein.
2. Geben Sie die Account SID aus Ihrer Twilio-Konsole ein (beginnt mit "AC…").
3. Geben Sie das Auth Token aus Ihrer Twilio-Konsole ein (Auge-Symbol zum Ein-/Ausblenden).
4. Wählen Sie, wie der Absender identifiziert werden soll:
   • Twilio-Nummer — Geben Sie die Twilio-Nummer ein (z. B. +12015551234). Wählen Sie zuerst die Landesflagge.
   • Absendername — Aktivieren Sie "Alphanumerischen Absendernamen verwenden" und geben Sie einen kurzen Namen ein (z. B. "TapAlert"). Hinweis: Nicht in allen Ländern unterstützt (z. B. nicht in den USA).
5. Ihre Nummer — Geben Sie Ihre eigene Nummer ein. Die App sendet eine Test-SMS, um zu bestätigen, dass Twilio funktioniert.

Schritt 4: E-Mail-Alarme konfigurieren (optional)

E-Mail-Alarme senden eine Kopie jedes Alarms an Empfänger mit E-Mail-Adresse. Das ist ein nützliches Backup, falls SMS fehlschlägt.

1. Schalten Sie "E-Mail-Redundanz aktivieren" ein.
2. Wählen Sie Ihren E-Mail-Anbieter: Gmail, Outlook, Hotmail, Yahoo Mail, iCloud Mail (Einstellungen automatisch ausgefüllt) oder benutzerdefiniertes SMTP.
3. Geben Sie die Absender-E-Mail-Adresse ein — idealerweise eine dedizierte Adresse, nicht das persönliche Postfach des Seniors.
4. Geben Sie das App-Passwort für dieses Konto ein.

So erhalten Sie ein App-Passwort

Normale E-Mail-Passwörter funktionieren nicht. E-Mail-Anbieter erfordern App-Passwörter für Apps, die sich über SMTP verbinden.

Gmail

1. Gehen Sie zu myaccount.google.com → Sicherheit
2. Aktivieren Sie die 2-Schritt-Verifizierung, falls noch nicht aktiv
3. Zurück zu Sicherheit → "App-Passwörter"
4. Erstellen Sie ein neues App-Passwort, nennen Sie es "TapAlert", kopieren Sie den 16-stelligen Code

Outlook / Hotmail

1. Gehen Sie zu account.live.com/proofs/manage
2. Unter "App-Passwörter" ein neues mit dem Namen "TapAlert" erstellen

Yahoo Mail

1. Gehen Sie zu account.yahoo.com/security
2. Unter "App-Passwörter" eines mit dem Namen "TapAlert" generieren

iCloud Mail

1. Gehen Sie zu appleid.apple.com → Anmelden und Sicherheit → App-spezifische Passwörter
2. Klicken Sie auf +, nennen Sie es "TapAlert" und kopieren Sie das Passwort

Schritt 5: Notfallkontakte hinzufügen

Im Abschnitt "Notfallkontakte" für jede Person, die Alarme des Seniors erhalten soll:

1. Geben Sie den Namen im Namensfeld ein (z. B. "Carlos" oder "Dr. García").
2. Geben Sie die Telefonnummer ein — wählen Sie zuerst die richtige Landesflagge, dann tippen Sie die Nummer.
3. Tippen Sie auf den blauen + Knopf, um sie zur Liste hinzuzufügen.
4. Wiederholen für jeden Kontakt. Sie können so viele hinzufügen, wie benötigt (bis zu 50 mit Premium; Free-Tier unterstützt 1).

Um einen Kontakt zu entfernen, tippen Sie auf das rote Papierkorb-Symbol neben seinem Namen.

Schritt 6: Vorkonfigurierte Alarmmeldungen verfassen

Im Abschnitt „Alarmmeldungen“ können Sie bis zu 3 gebrauchsfertige Nachrichten eingeben:

• Nachricht 1 — Die wichtigste Notfallnachricht (z. B. „Ich brauche Hilfe, ruf mich an“)
• Nachricht 2 — Eine „Es geht mir gut“-Nachricht (z. B. „Ich bin okay, keine Sorge“)
• Nachricht 3 — Eine weitere individuelle Nachricht (z. B. „Ich bin gestürzt, bitte komm“)

Sie erscheinen als große Schaltflächen auf dem Hauptbildschirm des Seniors, damit er mit einem einzigen Tippen eine Meldung senden kann, ohne etwas eintippen zu müssen.

Schritt 7: App-Einstellungen wählen

Konfigurieren Sie im Abschnitt „App-Einstellungen“, wie sich die App für den Senior verhält:

Alarm-Countdown

Wie viele Sekunden nach dem Antippen des Alarmknopfs gewartet wird, bevor die Meldung tatsächlich gesendet wird.

• 0 Sekunden — sendet sofort, keine Stornierung möglich
• 3–10 Sekunden — für die meisten Senioren empfohlen; gibt Zeit zum Abbrechen, falls versehentlich gedrückt
• 15–30 Sekunden — wenn der Senior dazu neigt, versehentlich zu tippen

Aktivierungsmodus

• Einmaliges Tippen — einmal tippen, um den Countdown zu starten (einfacher für Senioren mit eingeschränkter Mobilität)
• Gedrückt halten — Knopf gedrückt halten, um zu bestätigen (verhindert versehentliches Senden)

Erscheinungsbild

• Systemstandard — folgt der Hell-/Dunkel-Modus-Einstellung des Telefons
• Hell-Modus — immer heller Hintergrund
• Dunkel-Modus — immer dunkler Hintergrund (angenehmer für die Augen bei wenig Licht)

Sprache

Wählen Sie die Sprache der App-Oberfläche. Verfügbar: English, Español, Català, Français, Deutsch, Italiano, Nederlands, Português, Euskara, Galego.

Schritt 8: Den Magic Link erstellen und teilen

Sobald alle Abschnitte ausgefüllt sind:

1. Scrollen Sie zum unteren Rand des Bildschirms.
2. Tippen Sie auf die Schaltfläche „Magic Link erstellen und teilen“ (großer blauer Knopf).

Was als Nächstes passiert:

Testphase (dauert einige Sekunden):

• Wenn Twilio aktiviert ist: Die App sendet eine echte Test-SMS an Ihre Telefonnummer, um zu prüfen, ob es funktioniert. Sie sollten diese SMS innerhalb von Sekunden erhalten.
• Wenn E-Mail aktiviert ist: Die App sendet eine Test-E-Mail an die eingegebene E-Mail-Adresse. Überprüfen Sie Ihren Posteingang.
• Wenn Tests fehlschlagen, wird eine Fehlermeldung angezeigt. Überprüfen Sie Ihre Anmeldedaten und versuchen Sie es erneut.

Teilungsphase:

• Das System-Freigabefenster öffnet sich automatisch.
• Senden Sie den Magic Link an den Senior per WhatsApp, iMessage, E-Mail, SMS oder einer anderen Messaging-App.

Schritt 9: Der Senior öffnet den Magic Link

Auf dem Telefon des Seniors (mit installiertem TapAlert):

1. Der Senior erhält die Nachricht, die Sie gesendet haben.
2. Er tippt auf den Link.
3. TapAlert öffnet sich automatisch und zeigt einen Bestätigungsbildschirm: „TapAlert für [Name] konfigurieren?“ mit einer Übersicht, was eingerichtet wird.
4. Der Senior tippt auf „Ja, einrichten“ (oder die entsprechende Schaltfläche).
5. Die App übernimmt sofort die gesamte Konfiguration.
6. Eine Erfolgsmeldung erscheint und die App öffnet den Hauptbildschirm — einsatzbereit.

Das ist alles. Der Senior muss keine Einstellungen eingeben, keine Zugangsdaten eintippen oder Entscheidungen treffen.

Wenn TapAlert noch nicht auf dem Telefon des Seniors installiert ist

1. Installieren Sie zuerst TapAlert aus dem App Store (iOS) oder Google Play (Android).
2. Gehen Sie den Berechtigungsbildschirm durch (Standort, Mikrofon, Kontakte, Benachrichtigungen).
3. Tippen Sie dann auf den Magic Link — er wird während des Einrichtungsprozesses angewendet.

Schritt 10: Alles überprüfen

Nachdem der Magic Link angewendet wurde, führen Sie einen schnellen Test durch:

1. Öffnen Sie TapAlert auf dem Telefon des Seniors.
2. Sie sollten den Namen des Seniors auf dem Startbildschirm sehen.
3. Tippen Sie auf eine der Alarmschaltflächen.
4. Warten Sie den Countdown ab (oder senden Sie sofort, wenn der Countdown 0 ist).
5. Bestätigen Sie, dass alle konfigurierten Kontakte die SMS erhalten (und E-Mail, falls konfiguriert).
6. Überprüfen Sie, ob der Nachrichtentext und der Standortlink korrekt sind.

Nach der Einrichtung: Was der Senior sieht

Die App des Seniors öffnet sich direkt zum Panik-Modus-Bildschirm — ein einfacher Vollbild-Notfallknopf. Die Oberfläche ist so gestaltet, dass sie ohne Lesen bedient werden kann:

• Großer roter SOS-Knopf in der Mitte — tippen, um einen Notfallalarm zu senden
• Großer grüner OK-Knopf unten — tippen, um eine „Alles okay“-Nachricht zu senden
• Nach links wischen, um vorkonfigurierte Nachrichtenschaltflächen zu sehen (wenn Nachrichten eingerichtet wurden)

Der Senior muss nie in die Einstellungen gehen oder verstehen, wie irgendetwas funktioniert.

Mehrere Senioren einrichten

Sie können TapAlert für mehrere Senioren einrichten, ohne jedes Mal von vorne anzufangen:

1. Nachdem Sie den ersten Magic Link erstellt haben, tippen Sie auf „Weiteren Senior einrichten“ im Abschlussdialog.
2. Das Formular löscht den Namen und die Kontakte des Seniors, behält aber Ihre Twilio-Zugangsdaten, E-Mail-Einstellungen und App-Einstellungen.
3. Ändern Sie nur, was sich unterscheidet (Name, Kontakte, Nachrichten) für den nächsten Senior.
4. Erstellen und teilen Sie einen neuen Magic Link.

Fehlerbehebung

Fehler „Validierung fehlgeschlagen“ beim Erstellen des Links

• Überprüfen Sie, ob alle Pflichtfelder ausgefüllt sind (mit einer roten Fehlermeldung markiert).
• Wenn Twilio aktiviert ist, stellen Sie sicher, dass Account SID, Auth Token und Telefonnummer korrekt sind.
• Wenn E-Mail aktiviert ist, überprüfen Sie das App-Passwort — normale Kontokennwörter funktionieren nicht.

Der Senior hat die Test-SMS nicht erhalten

• Überprüfen Sie, ob die Twilio-Telefonnummer aktiv ist und kein Testnummer ist, die an nicht verifizierte Nummern sendet.
• Im kostenlosen Test von Twilio können Sie nur an Telefonnummern senden, die Sie in der Twilio-Konsole verifiziert haben. Fügen Sie die Kontakte des Seniors als verifizierte Nummern hinzu oder aktualisieren Sie auf ein kostenpflichtiges Konto.
• Überprüfen Sie, ob das Telefonnummernformat korrekt ist (Ländervorwahl enthalten).

Der Magic Link öffnet TapAlert nicht

• Stellen Sie sicher, dass TapAlert auf dem Telefon des Seniors installiert ist.
• Bei einigen Android-Telefonen halten Sie den Link gedrückt und wählen „Mit TapAlert öffnen“ statt eines Browsers.
• Wenn stattdessen ein Browser öffnet, kopieren Sie die vollständige URL und fügen Sie sie erneut in den Browser ein — beim zweiten Versuch bietet das System normalerweise TapAlert als Option an.

Der Senior tippt versehentlich auf den falschen Knopf

• Erhöhen Sie den Alarm-Countdown auf 10–15 Sekunden — das gibt Zeit zum Abbrechen vor dem Senden.
• Oder wechseln Sie zum Haltemodus (Aktivierungsmodus = Halten), damit der Knopf ein bewusstes Gedrükthalten erfordert.
• Sie können diese Einstellungen aktualisieren, indem Sie einen neuen Magic Link mit korrigierten Einstellungen erstellen und ihn an das Telefon des Seniors senden.

Twilio-SMS funktioniert, aber E-Mail nicht

• Häufigste Ursache: Empfänger haben keine E-Mail-Adressen gespeichert. Überprüfen Sie die Empfänger im Empfänger-Bildschirm der App.
• Stellen Sie sicher, dass das App-Passwort korrekt ist und nicht abgelaufen ist. App-Passwort von Gmail und Outlook können widerrufen werden — generieren Sie bei Bedarf ein neues.

Sicherheits- und Datenschutzhinweise

• Die Magic-Link-Nutzlast ist kodiert, aber nicht verschlüsselt. Jeder, der sie abfängt, kann die Konfiguration lesen, einschließlich Twilio-Zugangsdaten. Teilen Sie ihn nur direkt mit dem Senior.
• TapAlert hat keine Server — der Magic Link wird vollständig auf dem Gerät des Seniors verarbeitet. Es werden keine Daten an den TapAlert-Dienst gesendet.
• Twilio-Zugangsdaten im Link werden nach der Anwendung lokal auf dem Gerät des Seniors in sicherem (verschlüsseltem) Speicher gespeichert.
• Wenn Sie glauben, dass ein Magic Link abgefangen wurde, rotieren Sie Ihr Twilio Auth Token in der Twilio-Konsole sofort und erstellen Sie einen neuen Magic Link.

Schnellreferenzkarte (Zum Ausdrucken für den Senior)

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

Tragen Sie die von Ihnen konfigurierte Countdown-Zeit ein (z. B. „10 Sekunden“).