Verwenden Sie eine Kontakt-/Feedbackformular-Integration, um Nachrichten von Ihrer Website zu sammeln (Kontakt, Support, Feedback). Jede Übermittlung erstellt eine Nachricht in Mailoo und einen verknüpften Feedback-Datensatz mit strukturierten Feldern.
:::: important ::: title Important :::
Nur serverseitig: Senden Sie von Ihrem Backend oder BFF; rufen Sie Mailoo mit X-API-Key aus Umgebungsvariablen auf. Legen Sie den Schlüssel nicht in Browser-JavaScript oder öffentlichen Bundles offen.
::::
:::: note ::: title Note :::
Legacy: Der direkte Aufruf des Feedback-Webhooks aus dem Browser kann funktionieren, wenn CORS und erlaubte Origins übereinstimmen, legt aber den API-Schlüssel offen. Verwenden Sie für neue Integrationen ein Backend oder BFF. ::::
Schnellstart
- Öffnen Sie im Dashboard Ihr Projekt → Create New Integration → Contact / feedback form.
- Setzen Sie optional allowed origins (Origin-Allowlist). Leer lassen überspringt die Origin-Prüfung; der API-Schlüssel bleibt erforderlich. Ein BFF kann den Browser-
Originweiterleiten, sodass eine gefüllte Liste weiterhin gilt. - Erstellen Sie einen API-Schlüssel mit der Berechtigung Feedback form submissions (
webhook.feedback-submission) bei RESTRICTED-Schlüsseln oder verwenden Sie Full Access. Speichern Sie den Schlüssel nur auf dem Server. - Senden Sie von Ihrem Server per
POSTan den Feedback-Webhook (siehe API-Referenz unten). - Sehen Sie Übermittlungen unter Messages für diese Integration ein.
Ausgehendes SMTP (Dashboard)
Auf dem Reiter Connection & settings der Integration können Sie unter Outbound email (SMTP) E-Mail für Abonnenten-Abläufe und Operatorantworten konfigurieren, die integrationseigenes SMTP verwenden (siehe outbound-smtp{.interpreted-text role="doc"}). Verwenden Sie Send test email, um die aktuellen SMTP-Felder zu prüfen; der Test wird an Ihre Mailoo-Konto-E-Mail gesendet und speichert das Formular nicht automatisch.
API-Referenz
Endpunkt
POST /api/v1/webhooks/feedback/{projectUid}/{integrationId}
Header
Header Pflicht Beschreibung
Content-Type Ja application/json
X-API-Key Ja Projekt-API-Schlüssel mit webhook.feedback-submission (oder FULL)
Origin Nein Wenn allowedOrigins nicht leer ist, muss ein Eintrag übereinstimmen. Weglassen oder die Allowlist leer lassen überspringt die Origin-Prüfung (API-Schlüssel bleibt erforderlich).
JSON-Body
Feld Pflicht Beschreibung
email Ja Absender-E-Mail
message Ja Nachrichtentext (Klartext)
name Nein Absendername
subject Nein Betreffzeile (Standardwert bei Auslassung)
metadata Nein Objekt mit zusätzlichen Schlüssel/Wert-Daten (wird mit der Übermittlung gespeichert)
Erfolgsantwort (200)
{
"success": true,
"messageId": "...",
"feedbackId": "...",
"message": "Feedback submission processed successfully"
}
Dashboard
Öffnen Sie Project → Integration → View Messages, um einzelne Nachrichten aufzulisten und zu öffnen. Feedback-Integrationen verwenden nicht die Newsletter-Abonnenten-/Kampagnen-Reiter.
Integration in Ihre Next.js-App
Verbinden Sie eine BFF-Route mit @mailoo/forms, damit der Browser niemals den API-Schlüssel sieht. Vollständige Anleitung, Umgebungsoptionen und Client-Muster: feedback-form-nextjs-example{.interpreted-text role="doc"}.
Siehe auch
feedback-form-nextjs-example{.interpreted-text role="doc"} --- Next.js-BFF, optionale Allowlist, Client-Submitoutbound-smtp{.interpreted-text role="doc"} --- Integrations-SMTP, Dashboard-Test-E-Mail,MAIL_SMTP_ENCRYPTION_KEY../index{.interpreted-text role="doc"} --- andere Integrationstypen- OpenAPI:
https://api.mailoo.app/docs/v1--- API-Schlüssel undallowedOperations