E-Mail Benachrichtigungen

Im vierten Schritt des Rooms-Setups werden die E-Mail-Benachrichtigungen konfiguriert. Dieser Schritt ist optional, verbessert aber die Gästeerfahrung erheblich.

Übersicht

Die E-Mail-Funktionen umfassen:

Buchungsbestätigung

Automatische Bestätigung nach jeder Buchung.

Check-in Erinnerung

Erinnerung vor dem Aufenthalt.

Check-out Erinnerung

Erinnerung zum Auszug.

Bewertungsanfrage

Einladung zur Bewertung nach dem Aufenthalt.

---

Was du im Setup siehst

Der E-Mail-Schritt zeigt dir:

1. Titel: „E-Mail-Funktionen”

2. Eine Übersicht der enthaltenen Features:

   • Automatische Buchungsbestätigungen
   • Check-in & Check-out Erinnerungen
   • Bewertungsanfragen nach dem Aufenthalt
   • Anpassbare E-Mail-Vorlagen

3. Zwei Optionen:

   • „E-Mail einrichten” - SendGrid-Konfiguration starten
   • „Später einrichten” - Schritt überspringen

---

Optionen

Du hast zwei Möglichkeiten:

E-Mail einrichten

Empfohlen

E-Mail jetzt konfigurieren

Eigenschaft	Wert
Dauer	ca. 5-10 Minuten
Voraussetzung	SendGrid-Konto + Service Account
Schritte	4 Schritte

Vorteile:

• ✅ Gäste erhalten sofort Buchungsbestätigungen
• ✅ Automatische Erinnerungen aktiv
• ✅ Professioneller Eindruck

Empfehlung

Richte E-Mail-Benachrichtigungen ein. Gäste erwarten eine Bestätigung nach der Buchung.

Später einrichten

E-Mail überspringen

Eigenschaft	Wert
Dauer	Sofort
Voraussetzung	Keine
Schritte	Keine

Hinweis: „Du kannst E-Mail-Benachrichtigungen später im Admin-Bereich einrichten.”

Ohne E-Mail

Ohne E-Mail-Konfiguration werden keine automatischen Benachrichtigungen an Gäste gesendet.

---

Der E-Mail Setup Wizard

Wenn du „E-Mail einrichten” wählst, öffnet sich der E-Mail Setup Wizard.

Wizard-Flow

Der Wizard durchläuft folgende Phasen:

Intro → Deployment → API-Konfiguration → Test → Fertig

Phase	Beschreibung
Intro	Übersicht und Anleitung
Deployment	Cloud Functions bereitstellen
API-Konfiguration	SendGrid-Zugangsdaten eingeben
Test	Test-E-Mail senden

---

Phase 1: Automatisches Deployment

1. Wizard starten

   Tippe auf „E-Mail einrichten”. Der Wizard öffnet sich mit dem Titel „E-Mail Setup”.

2. Service Account prüfen

   Der Wizard prüft, ob ein Service Account konfiguriert ist.

   Status	Anzeige
   ✅ Konfiguriert	Deployment kann starten
   ❌ Nicht konfiguriert	Fehlermeldung mit Hinweis

3. Deployment starten

   Die E-Mail-Funktionen werden automatisch bereitgestellt:

   • „E-Mail-Funktionen werden bereitgestellt…”

4. Status anzeigen

   Ergebnis	Meldung
   ✅ Erfolgreich	„E-Mail-Funktionen erfolgreich bereitgestellt!”
   ✅ Demo-Modus	„Demo-Modus: E-Mail-Funktionen simuliert.”
   ❌ Fehler	Fehlermeldung mit Details

5. Weiter zur Konfiguration

   Bei Erfolg erscheint: „Konfigurieren Sie jetzt Ihren SendGrid API-Key.”

Demo-Modus

Im AppBuilder-Modus wird das Deployment simuliert. Die eigentlichen Cloud Functions werden beim Kunden-App-Export deployed.

---

Phase 2: SendGrid konfigurieren

Nach erfolgreichem Deployment erscheint die API-Konfiguration mit einer detaillierten Anleitung:

Schritt 1: SendGrid-Konto erstellen

Anleitung:

1. Besuche sendgrid.com und erstelle ein kostenloses Konto
2. Verifiziere deine E-Mail-Adresse
3. Verifiziere eine Absender-Domain oder -Adresse

Kostenloses Konto

SendGrid bietet ein kostenloses Kontingent von 100 E-Mails pro Tag. Für die meisten kleinen Unterkünfte reicht das aus.

Schritt 2: API-Key erstellen

Anleitung:

1. Gehe zu Settings > API Keys in der SendGrid Console
2. Klicke auf „Create API Key”
3. Wähle „Full Access” oder mindestens „Mail Send”
4. Kopiere den generierten API-Key

API-Key sicher aufbewahren

Der API-Key wird nur einmal angezeigt. Kopiere ihn sofort und bewahre ihn sicher auf.

Schritt 3: Konfiguration eingeben

Der Wizard zeigt folgende Eingabefelder:

Feld	Pflicht	Beschreibung
SendGrid API-Key	Ja	Der kopierte API-Key
Absender-E-Mail	Ja	E-Mail-Adresse für den Versand
Absender-Name	Nein	z.B. dein Firmenname
Antwort-Adresse	Nein	Falls Antworten an andere Adresse

Eingabefelder im Detail:

API-Key

SendGrid API-Key

Eigenschaft	Wert
Format	Langer String (beginnt oft mit SG.)
Pflicht	Ja
Beispiel	SG.xxxxxxxxxxxxxxxxxx...

Der API-Key ist dein Zugangsschlüssel zu SendGrid.

Absender-E-Mail

Absender-E-Mail

Eigenschaft	Wert
Format	Gültige E-Mail-Adresse
Pflicht	Ja
Beispiel	buchungen@meine-unterkunft.de

Diese Adresse erscheint als Absender bei allen E-Mails.

Verifizierung erforderlich

Die Absender-E-Mail muss in SendGrid verifiziert sein, sonst werden E-Mails nicht zugestellt.

Absender-Name

Absender-Name (optional)

Eigenschaft	Wert
Format	Text
Pflicht	Nein
Beispiel	„Hotel Sonnenschein”

Wird zusammen mit der E-Mail-Adresse angezeigt:

Von: Hotel Sonnenschein <buchungen@meine-unterkunft.de>

Wenn leer, wird nur die E-Mail-Adresse verwendet.

Antwort-Adresse

Antwort-Adresse (optional)

Eigenschaft	Wert
Format	Gültige E-Mail-Adresse
Pflicht	Nein
Beispiel	kontakt@meine-unterkunft.de

Wenn Gäste auf eine E-Mail antworten, geht die Antwort an diese Adresse.

Wenn leer, gehen Antworten an die Absender-E-Mail.

Schritt 4: Konfiguration speichern

Tippe auf „Speichern”, um die Konfiguration zu sichern.

Ergebnis	Meldung
✅ Erfolgreich	„E-Mail-Konfiguration gespeichert.”
❌ Fehlend	„API-Key und Absender-E-Mail sind erforderlich.”
❌ Fehler	Fehlermeldung mit Details

---

Phase 3: Test-E-Mail senden

Nach dem Speichern kannst du eine Test-E-Mail senden:

1. Test-Seite öffnen

   Der Wizard wechselt automatisch zur Test-Seite:

   • Titel: „Test-E-Mail”
   • Beschreibung: „Senden Sie eine Test-E-Mail an sich selbst, um die Konfiguration zu überprüfen.”

2. Test-E-Mail senden

   Tippe auf „Test-E-Mail senden”.

   Die E-Mail wird an die konfigurierte Absender-E-Mail gesendet.

3. Status prüfen

   Ergebnis	Meldung
   ✅ Erfolgreich	„Test-E-Mail gesendet!”
   ❌ Keine E-Mail	„Bitte geben Sie zuerst eine Absender-E-Mail ein.”
   ❌ Fehler	Fehlermeldung mit Details

4. E-Mail prüfen

   Prüfe deinen Posteingang. Du solltest eine Test-E-Mail im Stil einer Buchungsbestätigung erhalten.

Spam-Ordner prüfen

Falls die E-Mail nicht ankommt, prüfe auch den Spam-Ordner. Bei neuen SendGrid-Konten kann es vorkommen, dass E-Mails zunächst als Spam markiert werden.

---

Phase 4: Setup abschließen

Nach erfolgreichem Test:

1. Tippe auf „Fertig”
2. Der Wizard schließt sich
3. Der E-Mail-Schritt im Setup wird als abgeschlossen markiert

---

E-Mail-Vorlagen

Das Rooms-Modul verwendet automatische E-Mail-Vorlagen für verschiedene Anlässe:

Verfügbare Vorlagen

Vorlage	Auslöser	Inhalt
Buchungsbestätigung	Nach Buchung	Buchungsdetails, Check-in Informationen
Check-in Erinnerung	Vor dem Aufenthalt	Erinnerung, Anfahrt, Kontaktdaten
Check-out Erinnerung	Am Abreisetag	Erinnerung, Checkout-Zeit
Bewertungsanfrage	Nach dem Aufenthalt	Einladung zur Bewertung

Vorlagen anpassen

Die E-Mail-Vorlagen können nach dem Setup im Admin-Bereich angepasst werden:

1. Gehe zu Admin > Unterkünfte > E-Mail Konfiguration
2. Wähle „E-Mail-Vorlagen verwalten”
3. Passe Texte und Layout an

---

Fehlerbehandlung

Service Account nicht konfiguriert

Status	Anzeige
Meldung	„Service Account erforderlich”
Aktion	Richte den Service Account ein

Lösung:

1. Gehe zu Module & Features > Firebase
2. Richte den Service Account ein
3. Starte das Rooms-Setup erneut

👉 Service Account einrichten

Deployment fehlgeschlagen

Ursache	Lösung
Keine Berechtigung	Service Account Rechte prüfen
Netzwerkfehler	Internetverbindung prüfen
Firebase-Fehler	Firebase-Konfiguration prüfen

SendGrid-Fehler

Fehler	Lösung
Ungültiger API-Key	API-Key erneut aus SendGrid kopieren
E-Mail nicht verifiziert	Absender-E-Mail in SendGrid verifizieren
Kontingent erschöpft	SendGrid-Plan upgraden

Test-E-Mail kommt nicht an

Ursache	Lösung
Spam-Ordner	Spam-Ordner prüfen
Domain nicht verifiziert	Domain in SendGrid verifizieren
Falscher API-Key	API-Key prüfen

---

SendGrid einrichten

Eine kurze Anleitung zur SendGrid-Einrichtung:

1. Konto erstellen

   • Gehe zu sendgrid.com
   • Klicke auf „Start for Free”
   • Erstelle ein Konto mit deiner E-Mail-Adresse

2. E-Mail verifizieren

   • SendGrid sendet eine Verifizierungs-E-Mail
   • Klicke auf den Link in der E-Mail

3. Absender verifizieren

   • Gehe zu Settings > Sender Authentication
   • Wähle „Single Sender Verification” für schnellen Start
   • Oder „Domain Authentication” für professionellen Einsatz

4. API-Key erstellen

   • Gehe zu Settings > API Keys
   • Klicke auf „Create API Key”
   • Gib einen Namen ein (z.B. „BLOCQ App”)
   • Wähle „Full Access” oder „Restricted Access” mit „Mail Send”
   • Kopiere den Key sofort!

---

Tipps

E-Mail-Adresse professionell wählen

Verwende eine E-Mail-Adresse, die zu deiner Unterkunft passt, z.B. buchungen@hotel-xyz.de statt einer persönlichen Adresse.

Domain verifizieren

Für bessere Zustellbarkeit empfehlen wir die vollständige Domain-Verifizierung in SendGrid statt nur der Einzel-Absender-Verifizierung.

Test vor dem Go-Live

Teste das gesamte Buchungssystem einmal durch, um sicherzustellen, dass alle E-Mails korrekt ankommen.

E-Mail später einrichten

Falls du SendGrid noch nicht eingerichtet hast, kannst du diesen Schritt überspringen und E-Mail später im Admin-Bereich konfigurieren.

---

Nächste Schritte

Service Account einrichten Für automatisches Deployment

Räume-Editor Buchungseinstellungen konfigurieren

Kategorien erstellen Unterkunftskategorien anlegen

Zurück zur Übersicht Rooms-Setup Übersicht