Nutzen Sie diese Checkliste, wenn Sie in einer einzigen Sitzung einen funktionsfähigen Mailoo-Einstieg erreichen möchten.
Voraussetzungen
- Mailoo-Konto mit Dashboard-Zugang
- Ein Projekt, das für Ihren Arbeitsbereich erstellt wurde
- API-Schlüssel mit den Berechtigungen, die jeder Webhook erfordert
Fünf-Minuten-Ablauf
1. Projekt-Hygiene (1 Minute)
: Bestätigen Sie die Benennung, kopieren Sie die projectUid und legen Sie fest, wer Schlüssel rotiert.
2. Integration erstellen (2 Minuten)
: Fügen Sie FORM, CONTACT_FORM, JSBOX, BLOG, MARKET oder SOCIAL hinzu; setzen Sie optional erlaubte Origins; kopieren Sie die Projekt-UID, die Integrations-ID und eventuelle Einbettungshinweise aus Connection & settings.
3. Backend anbinden (2 Minuten)
: Speichern Sie X-API-Key in Umgebungsvariablen, leiten Sie Formulardaten über ein BFF weiter oder binden Sie den Chat-Loader auf Ihrer Marketingseite ein. Platzieren Sie API-Schlüssel niemals in clientseitigem JavaScript.
4. Testereignis senden
: Senden Sie einen synthetischen Formulareintrag oder öffnen Sie das Chat-Widget und prüfen Sie, ob das Dashboard eine neue Nachricht anzeigt.
Szenariohinweise
Marketing-Newsletter
: Verwenden Sie eine FORM-Integration und senden Sie von einer Serverroute. Konfigurieren Sie ausgehendes SMTP, wenn Sie Willkommens- oder Bestätigungsmails über Mailoo versenden.
Support-Kontakt
: Verwenden Sie CONTACT_FORM mit einem beschränkten Schlüssel und dem Next.js-Feedback-Weiterleitungsmuster (integrations/feedback-form-nextjs-example{.interpreted-text role="doc"}).
Redaktionelle Website
: Erstellen Sie eine BLOG-Integration, veröffentlichen Sie einen Artikel und rufen Sie ihn über die externe Blog-API ab (integrations/blog-headless-cms{.interpreted-text role="doc"}).
Echtzeit-Chat
: Konfigurieren Sie JSBOX (optional Origins auf Ihren HTTPS-Host beschränken) und leiten Sie Operatoren über die Dashboard-Chat-Erfahrung.
Storefront-Katalog
: Erstellen Sie eine MARKET-Integration, fügen Sie Produkte hinzu und rufen Sie die externe Katalog-API mit market.external-read auf (integrations/market-catalog-external-api{.interpreted-text role="doc"}).
Social Publishing
: Erstellen Sie eine SOCIAL-Integration, speichern Sie X- und/oder Facebook-Zugangsdaten und verfassen und veröffentlichen Sie einen Beitrag (integrations/social-networks{.interpreted-text role="doc"}).
Agent-Automatisierung
: Erstellen Sie ein MCP-Token unter Profile → Security und verbinden Sie Ihren MCP-Host (integrations/mailoo-mcp{.interpreted-text role="doc"}).
Validierungs-Checkliste
- Integrationsstatus ist Active
- Testnachricht oder -inhalt erscheint mit den erwarteten Metadaten
- API-Schlüssel-Berechtigungen passen zu jedem exponierten Webhook
- Ausgehendes SMTP konfiguriert, bevor Abonnenten-Antworten oder Bestell-E-Mails aktiviert werden
Fehlerbehebung
Webhook abgelehnt
: Überprüfen Sie Berechtigungen, Projekt-UID, Integrations-ID und die JSON-Nutzlaststruktur.
Chat-Widget stumm
: Wenn Origin-Prüfungen fehlschlagen, überprüfen Sie die optionalen erlaubten Origins, HTTPS und ob die Einbettungs-IDs mit dem Dashboard-Eintrag übereinstimmen.
Blog- oder Katalog-API leer
: Bestätigen Sie, dass Inhalte für die angeforderte Sprache veröffentlicht sind und der API-Schlüssel die passende Leseberechtigung hat.
Bereit für mehr?
getting-started{.interpreted-text role="doc"} --- konzeptionelle Tour durch das Mailoo-Integrationsmodell- Integrationsanleitungen unter Integrationen
- OpenAPI unter
https://api.mailoo.app/docs/v1