E-Mail-Verwaltung

Die E-Mail-Verwaltung ermöglicht es dir, automatisierte E-Mails aus deiner App zu versenden. Du kannst verschiedene E-Mail-Provider anbinden, Vorlagen für verschiedene Anlässe erstellen und die Konfiguration mit Test-E-Mails überprüfen.

Übersicht

Über E-Mail (E-Mail-Icon im Dashboard) erreichst du die E-Mail-Konfiguration. Die Verwaltung ist in vier Tabs unterteilt:

Tab	Beschreibung
Provider	E-Mail-Dienst auswählen und konfigurieren
Absender	Absender-Name, E-Mail-Adresse und Mail-Logo festlegen
Test	Konfiguration mit Test-E-Mail überprüfen
Log	Versand-Statistik und E-Mail-Warteschlange einsehen

Wer kann E-Mails konfigurieren?

Rolle	Zugriff
Eigentümer	Ja
Administrator	Ja
Moderator	Nein
Redakteur	Nein

---

Provider einrichten

Der E-Mail-Provider ist der Dienst, der deine E-Mails tatsächlich versendet. BLOCQ unterstützt verschiedene Anbieter mit unterschiedlichen Kontingenten.

Verfügbare Provider

Provider	Kostenloses Kontingent	Besonderheiten
SMTP	Unbegrenzt	Eigener Server (z.B. Mailcow, Postfix)
Gmail	500/Tag	Erfordert App-Passwort
SendGrid	100/Tag	Beliebter Cloud-Dienst
Mailgun	100/Tag (3 Monate)	EU-Datacenter verfügbar
Resend	100/Tag	Moderner, entwicklerfreundlich
Postmark	100/Monat	Hohe Zustellrate
Amazon SES	62.000/Monat	Von EC2-Instanzen

Provider konfigurieren

1. Öffne E-Mail im Admin-Dashboard
2. Wechsle zum Tab Provider
3. Klappe den Bereich Provider wechseln auf
4. Wähle deinen gewünschten Provider aus
5. Gib die erforderlichen Zugangsdaten ein
6. Tippe auf Speichern in der AppBar

Wichtig

Beim Wechsel des Providers werden alle bisherigen Zugangsdaten überschrieben. Stelle sicher, dass du die neuen Zugangsdaten korrekt eingibst.

---

Provider-Einstellungen

Je nach gewähltem Provider werden unterschiedliche Einstellungen benötigt:

SMTP

Für eigene SMTP-Server:

Einstellung	Beschreibung	Beispiel
SMTP Host	Adresse des Servers	smtp.example.com
SMTP Port	Port des Servers	587 (Standard für TLS)
Verschlüsselung	Sicherheitsprotokoll	TLS (empfohlen), SSL, oder Keine
Benutzername	Login für den Server	noreply@example.com
Passwort	Passwort für den Server	********

Port-Empfehlung

• Port 587 für TLS (empfohlen)
• Port 465 für SSL
• Port 25 ohne Verschlüsselung (nicht empfohlen)

Gmail

Für Gmail-Konten:

Einstellung	Beschreibung
App-Passwort	Spezielles Passwort für Apps

App-Passwort erforderlich

Verwende nicht dein normales Gmail-Passwort! Erstelle ein App-Passwort:

1. Öffne dein Google-Konto
2. Gehe zu Sicherheit > App-Passwörter
3. Erstelle ein neues Passwort für “Mail”
4. Kopiere das 16-stellige Passwort

SendGrid

Für SendGrid:

Einstellung	Beschreibung	Beispiel
API Key	SendGrid API-Schlüssel	SG.xxxxxxxxxxxx
Domain	Verifizierte Domain (optional)	example.com

Den API Key findest du in deinem SendGrid-Dashboard unter Settings > API Keys.

Mailgun

Für Mailgun:

Einstellung	Beschreibung	Beispiel
API Key	Mailgun API-Schlüssel	key-xxxxxxxxxxxx
Domain	Deine Mailgun-Domain	mg.example.com
EU Datacenter	EU-Server verwenden	Ein/Aus

DSGVO

Aktiviere EU Datacenter verwenden, wenn deine Nutzer hauptsächlich in Europa sind. Das hilft bei der DSGVO-Konformität.

Resend

Für Resend:

Einstellung	Beschreibung	Beispiel
API Key	Resend API-Schlüssel	re_xxxxxxxxxxxx
Domain	Verifizierte Domain (optional)	example.com

Postmark

Für Postmark:

Einstellung	Beschreibung	Beispiel
API Key	Postmark Server-Token	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Amazon SES

Für Amazon SES:

Einstellung	Beschreibung	Beispiel
AWS Region	SES-Region	eu-central-1
Access Key ID	AWS Zugriffsschlüssel	AKIAIOSFODNN7EXAMPLE
Secret Access Key	AWS Geheimschlüssel	********

Hinweis

Das kostenlose Kontingent von 62.000 E-Mails/Monat gilt nur, wenn du von einer EC2-Instanz aus sendest.

---

Absender-Einstellungen

Die Absender-Einstellungen bestimmen, wie deine E-Mails beim Empfänger erscheinen.

Einstellungen

Einstellung	Beschreibung	Beispiel
Absender-E-Mail	Die “Von”-Adresse (Pflichtfeld)	noreply@deine-app.de
Absender-Name	Der angezeigte Name (Pflichtfeld)	Meine App
Antwort-Adresse	Wohin Antworten gehen (optional)	support@deine-app.de
Mail-Logo	Logo im Kopfbereich aller E-Mails (optional)	Bild-Upload

Absender konfigurieren

1. Öffne E-Mail im Admin-Dashboard
2. Wechsle zum Tab Absender
3. Gib die Absender-E-Mail ein (Pflichtfeld)
4. Gib den Absender-Namen ein (Pflichtfeld)
5. Optional: Gib eine Antwort-Adresse ein
6. Optional: Lade ein Mail-Logo hoch
7. Tippe auf Speichern in der AppBar

Best Practice

Verwende eine E-Mail-Adresse von deiner eigenen Domain (z.B. noreply@deine-app.de) statt einer generischen Adresse. Das verbessert die Zustellbarkeit und wirkt professioneller.

Mail-Logo

Das Mail-Logo erscheint im Kopfbereich (Header) jeder versendeten E-Mail.

• Lädst du ein eigenes Mail-Logo hoch, wird dieses in allen E-Mails verwendet.
• Lässt du das Feld leer, verwendet BLOCQ automatisch dein App-Logo als Fallback.
• Ist auch kein App-Logo vorhanden, wird stattdessen der App-Name als Text-Header angezeigt.

Automatische Aktualisierung

Das Logo wird beim Speichern für den E-Mail-Versand vorbereitet. Wechselst du das Logo, wird es beim nächsten Versand automatisch neu übernommen.

---

Test-E-Mail senden

Bevor du E-Mails an echte Nutzer sendest, solltest du die Konfiguration testen.

1. Öffne E-Mail im Admin-Dashboard
2. Wechsle zum Tab Test
3. Gib deine eigene E-Mail-Adresse als Empfänger-E-Mail ein
4. Tippe auf Test-E-Mail senden
5. Prüfe deinen Posteingang (auch den Spam-Ordner!)

Test-Status

Nach dem Senden wird der Status angezeigt:

Status	Bedeutung
Erfolgreich am [Datum]	Test-E-Mail wurde erfolgreich versendet
Fehlgeschlagen am [Datum]	Versand ist fehlgeschlagen - prüfe die Konfiguration

Spam-Ordner

Wenn die Test-E-Mail im Spam landet, liegt das oft an fehlenden DNS-Einträgen (SPF, DKIM, DMARC) für deine Domain. Kontaktiere deinen Domain-Anbieter für Hilfe.

---

E-Mail-Log

Der Tab Log zeigt dir, welche E-Mails deine App versendet hat und in welchem Status sie sind.

Versand-Statistik

Oben siehst du eine Übersicht über alle E-Mails in der Warteschlange:

Kennzahl	Bedeutung
Gesamt	Alle erfassten E-Mails
Gesendet	Erfolgreich zugestellte E-Mails
Ausstehend	E-Mails, die noch verarbeitet werden
Fehler	E-Mails, deren Versand fehlgeschlagen ist

E-Mail-Warteschlange

Darunter findest du die letzten E-Mails mit:

• Betreff der E-Mail
• Empfänger (To)
• Status-Badge: Erfolgreich, Fehler, In Bearbeitung oder Ausstehend

Fehler analysieren

Wenn E-Mails den Status Fehler haben, prüfe deine Provider-Zugangsdaten und die Absender-Verifizierung. Häufige Ursache ist eine nicht verifizierte Absender-Adresse.

---

E-Mail-Vorlagen

E-Mail-Vorlagen definieren das Design und den Inhalt deiner automatisierten E-Mails. Über Alle Vorlagen verwalten erreichst du die Vorlagen-Verwaltung.

Vorlage erstellen

1. Öffne E-Mail > Alle Vorlagen verwalten
2. Falls keine Vorlagen existieren, tippe auf Standard-Vorlagen erstellen
3. Oder erstelle eine neue Vorlage manuell

Vorlagen-Typen

BLOCQ unterstützt viele verschiedene Vorlagen-Typen:

Buchungen

Typ	Verwendung
Buchungsbestätigung	Nach erfolgreicher Buchung
Stornierungsbestätigung	Nach Stornierung
Buchungserinnerung	Vor dem Termin
Check-in Erinnerung	Am Tag vor Check-in
Check-out Erinnerung	Am Tag vor Check-out
Bewertungsanfrage	Nach dem Aufenthalt
Zugangscode	Mit Türcode/PIN

Account

Typ	Verwendung
Willkommen	Nach Registrierung
Passwort zurücksetzen	Bei Passwort-Anfrage
E-Mail-Verifizierung	Zur Bestätigung der E-Mail
Sicherheitswarnung	Bei verdächtigen Aktivitäten
Login-Benachrichtigung	Bei neuer Anmeldung

Bestellungen

Typ	Verwendung
Bestellbestätigung	Nach Bestellung
Bestellung wird vorbereitet	Status-Update
Bestellung bereit	Zur Abholung
Bestellung versendet	Mit Tracking-Info
Bestellung geliefert	Nach Lieferung
Bestellung storniert	Bei Stornierung
Rechnung	Mit Rechnungsdetails

Mitgliedschaft

Typ	Verwendung
Mitgliedschaftsbestätigung	Nach Abschluss
Ablauf-Erinnerung	Vor dem Ablauf
Kündigungs-Bestätigung	Nach Kündigung
Verlängerungs-Bestätigung	Nach Verlängerung

---

Vorlage bearbeiten

Jede Vorlage kann individuell angepasst werden.

Allgemeine Einstellungen

Einstellung	Beschreibung
Name	Interner Name der Vorlage
Typ	Art der E-Mail (bestimmt wann sie gesendet wird)
Aktiv	Ob die Vorlage verwendet wird

Mehrsprachige Inhalte

Für jede Sprache (Deutsch und Englisch) kannst du festlegen:

Feld	Beschreibung
Betreff	Die Betreffzeile der E-Mail
HTML-Inhalt	Der formatierte E-Mail-Text
Klartext-Inhalt	Fallback ohne Formatierung (optional)

Variablen verwenden

In Vorlagen kannst du Platzhalter verwenden, die automatisch ersetzt werden:

Variable	Ersetzt durch	Beispiel
{{name}}	Name des Empfängers	Max Mustermann
{{email}}	E-Mail des Empfängers	max@beispiel.de
{{date}}	Datum	15.01.2025
{{time}}	Uhrzeit	14:00 Uhr
{{app_name}}	Name deiner App	Meine App
{{primary_color}}	Primärfarbe als Hex	#4CAF50

Buchungs-spezifische Variablen:

Variable	Ersetzt durch
{{guest_name}}	Name des Gastes
{{space_name}}	Name der Unterkunft/Raum
{{checkin_date}}	Check-in Datum
{{checkout_date}}	Check-out Datum
{{total_price}}	Gesamtpreis
{{access_code}}	Zugangscode

Vorschau

Im Tab Vorschau siehst du, wie deine E-Mail aussehen wird. Die Variablen werden durch Beispielwerte ersetzt, damit du das Ergebnis überprüfen kannst.

---

Modul-spezifische Vorlagen

Einige Module in BLOCQ haben eigene E-Mail-Vorlagen:

Mitgliedschaften

Wenn du das Mitgliedschafts-Modul nutzt, findest du unter Mitgliedschaften > E-Mail-Vorlagen einen direkten Zugang zu den relevanten Vorlagen:

• Mitgliedschaftsbestätigung
• Ablauf-Erinnerung
• Kündigungs-Bestätigung
• Verlängerungs-Bestätigung

Diese werden automatisch beim ersten Öffnen erstellt.

---

Konfiguration löschen

Wenn du die E-Mail-Konfiguration komplett entfernen möchtest:

1. Öffne E-Mail im Admin-Dashboard
2. Tippe auf das Drei-Punkte-Menü in der AppBar
3. Wähle Löschen
4. Bestätige die Warnung:

   “Möchten Sie die E-Mail-Konfiguration wirklich löschen? Sie können danach keine E-Mails mehr senden.”

5. Tippe auf Bestätigen

Wichtig

Nach dem Löschen werden keine automatischen E-Mails mehr versendet. Wichtige Benachrichtigungen wie Buchungsbestätigungen oder Passwort-Reset-E-Mails funktionieren dann nicht mehr.

---

Tipps

Provider-Wahl

Für kleine Apps mit wenig E-Mail-Volumen sind SendGrid oder Resend gute Optionen. Für größere Apps oder mehr Kontrolle ist Amazon SES kostengünstiger.

Zustellbarkeit verbessern

Richte SPF, DKIM und DMARC für deine Domain ein. Das verhindert, dass deine E-Mails als Spam markiert werden.

Vorlagen testen

Teste jede Vorlage vor dem Einsatz, indem du dir selbst eine Test-E-Mail sendest. Prüfe dabei sowohl Desktop- als auch Mobile-Ansicht.

Variablen prüfen

Stelle sicher, dass alle Variablen in deinen Vorlagen auch tatsächlich verfügbar sind. Nicht definierte Variablen werden als {{variable}} angezeigt.

---

Häufige Fragen

Warum kommt meine Test-E-Mail nicht an?

Mögliche Ursachen:

1. Spam-Ordner prüfen - Die E-Mail könnte als Spam markiert worden sein
2. Zugangsdaten prüfen - API-Keys oder Passwörter könnten falsch sein
3. Provider-Limits - Das kostenlose Kontingent könnte aufgebraucht sein
4. Domain nicht verifiziert - Einige Provider erfordern eine Domain-Verifizierung

Kann ich HTML in E-Mails verwenden?

Ja, im HTML-Inhalt Feld kannst du vollständiges HTML verwenden. Achte auf Inline-CSS, da viele E-Mail-Clients externe Stylesheets ignorieren.

Was ist der Unterschied zwischen HTML und Klartext?

• HTML ermöglicht formatierte E-Mails mit Farben, Bildern und Links
• Klartext ist die Fallback-Version für E-Mail-Clients, die kein HTML unterstützen

Es ist empfehlenswert, beide anzugeben.

Werden E-Mails im Demo-Modus versendet?

Nein, im Demo-Modus (App Builder) werden keine echten E-Mails versendet. Die Konfiguration wird simuliert, aber keine Verbindung zum Provider hergestellt.

Wie viele E-Mails kann ich pro Tag senden?

Das hängt vom gewählten Provider und deinem Tarif ab. Die kostenlosen Kontingente findest du in der Provider-Tabelle oben.

---

Weiterführende Themen

Mitgliedschaften Mitgliedschafts-E-Mails konfigurieren

Admin-Bereich Übersicht Zurück zur Hauptübersicht