Erste Schritte mit Mailoo
Diese Anleitung beschreibt, was Mailoo heute wirklich liefert: Projekte, FORM- / CONTACT_FORM- / JSBOX- / BLOG-Integrationen, Zugriff über Webhooks und API-Schlüssel sowie Dashboard-Ansichten für Nachrichten und Abonnenten.
Voraussetzungen
Bevor Sie starten, sollten Sie haben:
- Ein Mailoo-Konto (über Ihren Identity Provider)
- Ein Projekt im Dashboard für Integrationen und API-Schlüssel
- Einen sicheren Ort für API-Schlüssel (Server, BFF oder Automation—nicht im Browser-Bundle)
Tipp
Verwenden Sie getrennte Schlüssel für Staging und Produktion und RESTRICTED-Scopes, bis klar ist, welcher Webhook welche Integration braucht.
Konto erstellen
Starten Sie auf der Anmeldeseite und folgen Sie diesen Schritten:
- Öffnen Sie die Mailoo-Website und wählen Sie Kostenlos starten oder Anmelden.
- Authentifizieren Sie sich beim IdP (z. B. Keycloak).
- Legen Sie im Dashboard ein Projekt an oder wählen Sie eines.
- Notieren Sie die Projekt-UID—Sie brauchen sie für Webhooks und öffentliche Blog-URLs.
Das Dashboard steht jederzeit bereit; Sitzungen folgen Ihrer Auth.js- und IdP-Konfiguration.
Erste Integration einrichten
Mailoo verbindet keine Fremd-Postfächer. Sie legen eine Integration passend zur Besuchererfahrung an:
Schritt 1: Integrationsbereich öffnen
- Öffnen Sie im Projekt „Integrationen“ oder „Integration hinzufügen“.
- Prüfen Sie die für Ihren Plan verfügbaren Typen.
- Wählen Sie FORM, CONTACT_FORM, JSBOX oder BLOG.
Schritt 2: Typspezifische Einstellungen
- Geben Sie einen klaren Namen für Website oder Formular an.
- Setzen Sie erlaubte Origins, Webhook-URLs oder Widget-Optionen.
- Erzeugen Sie einen API-Schlüssel mit passenden Scopes.
- Speichern Sie den Schlüssel serverseitig—keine FULL-Keys im Client.
- Speichern Sie die Integration und prüfen Sie den Status Aktiv.
Schritt 3: Anwendung anbinden
- Zeigen Sie Backend oder BFF auf den dokumentierten Webhook (HTTPS).
- Senden Sie Payloads im Format der Integrationsanleitung.
- Für JSBOX binden Sie den Loader und die Mailoo-IDs ein.
- Optional: Outbound-SMTP auf der Integration vor Abonnenten-Mail konfigurieren.
Integration testen
Validieren Sie den Pfad vor dem Go-live:
- Lösen Sie einen Test aus Staging aus (Formular, Chat oder Blog-Post).
- Warten Sie auf Webhook-Antwort oder Dashboard-Update.
- Öffnen Sie Nachrichten und prüfen Sie Metadaten, Status und Zuordnung.
- Bei FORM prüfen Sie Abonnenten mit der Test-Adresse.
Fehlerbehebung
Wenn nach einigen Minuten nichts erscheint:
- • Stellen Sie sicher, dass der Key-Scope zum aufgerufenen Webhook passt.
- • Prüfen Sie Projekt-UID und Integrations-ID in URL oder Body.
- • Suchen Sie 4xx-Antworten in Server-Logs (CORS, Signatur, Validierung).
- • Kontaktieren Sie den Support mit Integrations-ID und ungefährem Zeitpunkt.
Nächste Schritte
Wenn die erste Integration steht:
- Fügen Sie einen weiteren Typ hinzu (z. B. JSBOX neben FORM).
- Richten Sie Vorlagen und Kampagnen für Abonnenten ein.
- Lesen Sie den Website-Forms-Leitfaden für Next.js-BFFs.
- Öffnen Sie die gehostete OpenAPI unter /docs/v1 Ihres API-Deployments.