Kundenbenachrichtigungen

Levy Fleets verwendet Push-Benachrichtigungen, um Kunden ueber ihre Fahrten, Kontostatus, Aktionen und wichtige Updates zu informieren. Dieser Leitfaden behandelt Benachrichtigungstypen, das Senden manueller Benachrichtigungen, automatische Systembenachrichtigungen und die Fehlerbehebung bei Zustellungsproblemen.

Ueberblick

Das Benachrichtigungssystem verwendet Expo Push Notifications, um Nachrichten an mobile Kundengeraete zu senden. Benachrichtigungen werden gesendet fuer:

• Fahrtbezogene Ereignisse (Start, Ende, Probleme)
• Zonenwarnungen (Betreten/Verlassen von Zonen)
• Zahlungsbenachrichtigungen (erfolgreiche Belastungen, fehlgeschlagene Zahlungen)
• Wallet-Updates (Guthaben hinzugefuegt)
• Werbebotschaften (Aktionen, Ankuendigungen)
• Systemwarnungen (Wartung, Updates)
• Identitaetspruefung (erforderlich, aufgehoben)

Benachrichtigungstypen

Systemgenerierte Benachrichtigungen

Diese werden automatisch durch Ereignisse im System ausgeloest:

Manuelle Benachrichtigungen

Betreiber koennen benutzerdefinierte Benachrichtigungen an einzelne Kunden oder Gruppen senden:

Manuelle Benachrichtigungen senden

An einzelnen Kunden

1. Navigieren Sie zu Dashboard > Kunden
2. Klicken Sie auf den Kunden, um seine Detailseite zu oeffnen
3. Klicken Sie auf Aktionen (Drei-Punkte-Menue)
4. Waehlen Sie Benachrichtigung senden
5. Fuellen Sie das Benachrichtigungsformular aus:
   • Titel: Benachrichtigungsueberschrift (fett angezeigt)
   • Text: Hauptnachrichtentext
   • Typ: Kategorie fuer die Benachrichtigung
6. Klicken Sie auf Senden

Benachrichtigungsformular-Felder

Typoptionen

API-Referenz

Benachrichtigung senden - Endpunkt

Endpunkt: POST /api/customers/notify

Anfragekoerper:

{
  "customerId": "customer-uuid-here",
  "title": "Special Offer!",
  "body": "Get 20% off your next ride with code SAVE20",
  "type": "promo"
}

Antwort (Erfolg):

{
  "success": true,
  "ticketId": "XXXX-XXXX-XXXX-XXXX"
}

Antwort (Fehler):

{
  "success": false,
  "error": "Customer has no push token"
}

Erforderliche Parameter

Optionale Parameter

Deep-Linking

Benachrichtigungen koennen Daten enthalten, die bestimmte Bildschirme in der App oeffnen:

Fahrtdetails

{
  "customerId": "xxx",
  "title": "Ride Complete",
  "body": "View your ride summary",
  "data": {
    "screen": "ride",
    "rideId": "ride-uuid"
  }
}

Wallet

{
  "customerId": "xxx",
  "title": "Credit Added",
  "body": "Check your new balance",
  "data": {
    "screen": "wallet"
  }
}

Identitaetspruefung

{
  "customerId": "xxx",
  "title": "Verify Your Identity",
  "body": "Complete verification to continue riding",
  "data": {
    "screen": "identity_verification"
  }
}

Automatische Benachrichtigungen

Fahrtbenachrichtigungen

Zahlungsbenachrichtigungen

Wallet-Benachrichtigungen

Benachrichtigung bei negativem Guthaben

Ausloesebedingungen:

• Wallet-Guthaben war 0 $ oder positiv vor der Belastung
• Guthaben wird nach der Belastung negativ
• Wird nur durch "Gebuehr erheben"-Aktion ausgeloest, nicht durch "Guthaben reduzieren"

Benachrichtigungsinhalt:

• Titel: "Wallet-Guthaben negativ"
• Text: "Eine Gebuehr von X,XX $ wurde auf Ihr Konto angewendet. Ihr Wallet-Guthaben betraegt jetzt -Y,YY $."
• Typ: wallet

Identitaetsbenachrichtigungen

Benachrichtigungseinstellungen

Kundenpraeferenzen

Kunden koennen Benachrichtigungen in der mobilen App steuern:

• Alle Benachrichtigungen: Hauptschalter
• Fahrt-Updates: Start, Ende, Warnungen
• Aktionen: Marketingnachrichten
• Zahlungswarnungen: Transaktionsbestaetigungen

Subaccount-Konfiguration

Betreiber koennen das Benachrichtigungsverhalten konfigurieren:

Push-Token-Verwaltung

Wie Tokens funktionieren

1. Kunde installiert App und erteilt Benachrichtigungsberechtigung
2. App erhaelt Push-Token von Expo/APNs/FCM
3. Token wird im Kundendatensatz gespeichert (expo_push_token)
4. Benachrichtigungen werden an dieses Token gesendet
5. Token kann sich aendern (Neuinstallation, Geraetewechsel)

Token-Status

Wann Tokens ungueltig werden

• Kunde deinstalliert die App
• Kunde widerruft Benachrichtigungsberechtigung
• Geraet wird zurueckgesetzt oder ersetzt
• Token laeuft ab (selten)

Zustellungsstatus

Expo Push-Belege

Wenn eine Benachrichtigung gesendet wird, liefert Expo:

1. Ticket-ID: Sofortige Bestaetigung der Uebermittlung
2. Beleg: Eventueller Zustellungsstatus

Beleg-Statuswerte

Fehlerbehandlung

Haeufige Fehler und Loesungen:

Best Practices

Nachrichteninhalt

1. Titel kurz halten: Maximal 30-50 Zeichen
2. Spezifisch sein: Dem Kunden mitteilen, was passiert ist oder was zu tun ist
3. Wert einbeziehen: Warum sollte es ihn interessieren?
4. Personalisierung verwenden: Name oder relevante Details einbeziehen
5. Handlungsaufforderung: Was soll er als naechstes tun?

Haeufigkeit

1. Nicht zu oft benachrichtigen: Werbebotschaften begrenzen
2. Wenn moeglich buendeln: Zusammengehoerige Updates kombinieren
3. Zeitzonen respektieren: Waehrend der Wachzeiten senden
4. Nur fuer Notfaelle: Fuer wirklich wichtige Warnungen reservieren

Timing

Tonfall

• Freundlich: "Ihre Fahrt ist abgeschlossen!"
• Klar: "Zahlung von 5,00 $ verarbeitet"
• Handlungsorientiert: "Verifizieren Sie Ihre Identitaet, um weiter zu fahren"
• Vermeiden: GROSSBUCHSTABEN, uebermäßige Satzzeichen, Emoji-Ueberflutung

Massenbenachrichtigungen

Aktuelle Einschraenkungen

Das Dashboard unterstuetzt derzeit nur Einzelbenachrichtigungen. Fuer Massenbenachrichtigungen:

1. Verwenden Sie die API mit einer Schleife
2. Implementieren Sie Ratenbegrenzung (max. 400/Minute an Expo)
3. Erwaegen Sie ein separates Benachrichtigungskampagnen-Tool

API-Massenmuster

// Example: Send to multiple customers
const customerIds = ['cust1', 'cust2', 'cust3'];
const message = {
  title: 'Special Offer',
  body: 'Get 20% off this weekend!'
};

for (const customerId of customerIds) {
  await fetch('/api/customers/notify', {
    method: 'POST',
    body: JSON.stringify({ customerId, ...message })
  });
  // Rate limit: wait 150ms between sends
  await new Promise(r => setTimeout(r, 150));
}

Fehlerbehebung

Benachrichtigung nicht empfangen

Pruefen Sie diese in dieser Reihenfolge:

1. Hat der Kunde ein Push-Token?

   • Kunden-Detailseite anzeigen
   • Feld expo_push_token pruefen
   • Wenn leer, hat der Kunde keine Berechtigung erteilt

2. Berechtigung aktiviert?

   • Kunde muss Benachrichtigungsberechtigung in iOS/Android-Einstellungen erteilen
   • Er kann sie nach der ersten Erteilung deaktiviert haben

3. App installiert?

   • Token wird ungueltig, wenn die App deinstalliert wird
   • Kunde muss neu installieren und Berechtigung erneut erteilen

4. Richtiger Kunde?

   • Ueberpruefen Sie, ob die customerId mit dem beabsichtigten Empfaenger uebereinstimmt
   • Auf doppelte Konten pruefen

5. Nachricht zugestellt?

   • Expo Push-Belegstatus pruefen
   • In Logs nach Zustellungsfehlern suchen

6. Geraeteprobleme?

   • Bitte-nicht-stoeren-Modus auf dem Geraet
   • Fokusmodus blockiert Benachrichtigungen
   • Energiesparmodus begrenzt Hintergrundaktivitaet

Kunde sagt, er bekommt "zu viele" Benachrichtigungen

• Automatische Benachrichtigungsausloeser ueberpruefen
• In Logs auf doppelte Sendungen pruefen
• Ueberpruefen, ob Benachrichtigungspraeferenzen respektiert werden
• Drosselungskonfiguration in Betracht ziehen

Benachrichtigung zeigt falschen Inhalt

• Auf Kodierungsprobleme in Titel/Text pruefen
• Ueberpruefen, ob Daten nicht abgeschnitten sind
• Nach maskierten Sonderzeichen suchen
• Mit einfachem ASCII-Text testen

Benachrichtigungen verzoegert

• Expo verwendet Batchverarbeitung, kann bis zu einige Sekunden verzoegern
• APNs/FCM koennen je nach Geraet/Netzwerk verzoegern
• Pruefen, ob das Geraet im Energiesparmodus ist
• Netzwerkverbindung auf dem Geraet ueberpruefen

"DeviceNotRegistered"-Fehler

Dies ist normal, wenn:

• Kunde die App deinstalliert hat
• Kunde ein neues Geraet bekommen hat
• Token abgelaufen ist (selten)

Loesung: Ungueltiges Token aus dem Kundendatensatz entfernen. Token wird aktualisiert, wenn der Kunde die App wieder oeffnet.

Integration mit anderen Systemen

Fahrtsystem

Die Fahrt-Engine sendet Benachrichtigungen fuer:

• Fahrtstart-Bestaetigung
• Pause-/Fortsetzungsereignisse
• Akku-/Zonenwarnungen
• Fahrtabschluss mit Zusammenfassung
• Benachrichtigungen bei automatischem Ende

Zahlungssystem

Zahlungsverarbeitung loest aus:

• Bestaetigung erfolgreicher Belastung
• Warnungen bei fehlgeschlagener Zahlung
• Rueckerstattungsbenachrichtigungen
• Warnungen bei Kartenablauf

Identitaetssystem

Identitaetspruefung loest aus:

• Aufforderung zur Verifizierung
• Bestaetigung bei erfolgreicher Verifizierung
• Benachrichtigung bei aufgehobener Anforderung
• Benachrichtigung bei fehlgeschlagenem Versuch