Dokumentation

Alles was Sie über Mailtre wissen müssen

Willkommen zur Mailtre Dokumentation

Willkommen in der umfassenden Dokumentation von Mailtre – Ihrer professionellen Lösung für modernes E-Mail-Marketing. Diese Dokumentation wurde entwickelt, um Ihnen bei jedem Schritt Ihrer E-Mail-Marketing-Reise zu helfen, von der ersten Registrierung bis hin zu fortgeschrittenen Automatisierungen und API-Integrationen.

Mailtre ist mehr als nur ein Newsletter-Tool. Es ist eine vollständige Marketing-Plattform, die es Ihnen ermöglicht, personalisierte E-Mail-Kampagnen zu erstellen, Ihre Zielgruppe zu segmentieren, Marketing-Prozesse zu automatisieren und detaillierte Analysen durchzuführen. Egal ob Sie ein kleines Unternehmen, eine Agentur oder ein großes Enterprise sind – Mailtre skaliert mit Ihren Anforderungen.

Was Sie in dieser Dokumentation finden

  • Schnellstart: In 5 Minuten zur ersten Integration
  • API-Referenz: Vollständige Dokumentation aller verfügbaren Endpunkte
  • Integrationen: WordPress, WooCommerce, Shopify und weitere
  • Code-Beispiele: Praktische Anwendungsfälle mit fertigem Code
  • Best Practices: Tipps für optimale E-Mail-Marketing-Performance
  • Troubleshooting: Lösungen für häufige Probleme

Warum Mailtre?

Mailtre ist eine cloudbasierte E-Mail-Marketing-Plattform, die Ihnen alle Tools bietet, die Sie für erfolgreiches E-Mail-Marketing benötigen. Keine komplizierte Installation, keine Server-Wartung – einfach registrieren und loslegen!

Neu bei Mailtre?

Wenn Sie gerade erst mit Mailtre beginnen, empfehlen wir, mit unserem Schnellstart-Guide zu starten. Dieser führt Sie in nur 5 Minuten durch die wichtigsten Schritte: Account-Erstellung, Listen-Setup, API-Token-Generierung und die erste Integration.

Für praktische Implementierungen schauen Sie sich unsere Integrationsbeispiele an, wo Sie fertige Code-Snippets für WordPress, WooCommerce und andere Plattformen finden.

Support & Community

Haben Sie Fragen oder benötigen Hilfe? Unser Support-Team steht Ihnen zur Verfügung:

Schnellstart Guide

Dieser Schnellstart-Guide bringt Sie in nur 5-10 Minuten von der Registrierung bis zu Ihrer ersten funktionierenden Newsletter-Integration. Folgen Sie einfach diesen vier Schritten, und Sie sind bereit, E-Mails zu versenden!

1. Account erstellen & Dashboard erkunden

Beginnen Sie mit der Registrierung eines kostenlosen Accounts unter mail.mailtre.com/users/register. Nach der Aktivierung per E-Mail landen Sie im Dashboard. Hier sehen Sie:

  • Übersicht: Statistiken, aktive Kampagnen, letzte Aktivitäten
  • Kontakte: Verwaltung Ihrer Abonnenten-Listen
  • Kampagnen: Newsletter erstellen und versenden
  • Automatisierung: E-Mail-Flows und Autoresponder
  • Berichte: Analytics und Performance-Daten
  • Einstellungen: API, SMTP, Benutzer, Domains

2. Erste Liste erstellen

Listen sind Container für Ihre Abonnenten. So erstellen Sie Ihre erste Liste:

  1. Klicken Sie im Menü auf "Listen" → "Neue Liste erstellen"
  2. Geben Sie einen Namen ein (z.B. "Newsletter Hauptliste")
  3. Fügen Sie eine Beschreibung hinzu (intern, für Ihre Übersicht)
  4. Legen Sie Standard-Absendername und -adresse fest
  5. Wählen Sie Ihre Zeitzone
  6. Konfigurieren Sie Double-Opt-In (dringend empfohlen!)
  7. Speichern Sie die Liste

Nach dem Speichern sehen Sie Ihre Listen-ID in der URL (z.B. 68f38b90304c6). Diese benötigen Sie für die API-Integration!

3. API Token generieren

Um Mailtre mit Ihrer Website oder Anwendung zu verbinden, benötigen Sie einen API Token:

  1. Navigieren Sie zu Einstellungen → API
  2. Klicken Sie auf "Neuen Token erstellen"
  3. Geben Sie einen Namen ein (z.B. "Website Integration")
  4. Wählen Sie die Berechtigungen (Empfehlung: "Abonnenten verwalten")
  5. Klicken Sie auf "Token erstellen"
  6. WICHTIG: Kopieren Sie den Token sofort! Er wird nur einmal angezeigt
  7. Speichern Sie den Token sicher (z.B. in einem Passwort-Manager)

Token-Sicherheit

Behandeln Sie Ihren API Token wie ein Passwort! Niemals in öffentlichem Code speichern oder im Frontend verwenden. Bei Verdacht auf Kompromittierung sofort widerrufen und neu erstellen.

4. Erste Integration einrichten

Jetzt verbinden Sie Mailtre mit Ihrer Website. Die einfachste Methode ist ein HTML-Formular:

HTML + PHP
<?php if ($_SERVER['REQUEST_METHOD'] === 'POST') { $email = filter_var($_POST['email'], FILTER_SANITIZE_EMAIL); if (filter_var($email, FILTER_VALIDATE_EMAIL)) { // HIER IHRE DATEN EINTRAGEN: $api_token = 'IHR_API_TOKEN'; // ← Von Schritt 3 $list_id = 'IHRE_LISTEN_ID'; // ← Von Schritt 2 $url = "https://mail.mailtre.com/api/v1/subscribers?api_token=" . $api_token; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, [ 'list_uid' => $list_id, 'EMAIL' => $email ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($http_code == 200) { echo '<p style="color: green;">Erfolgreich! Bitte E-Mail bestätigen.</p>'; } else { echo '<p style="color: red;">Fehler bei der Anmeldung.</p>'; } } } ?> <form method="POST"> <input type="email" name="email" placeholder="E-Mail-Adresse" required> <button type="submit">Newsletter abonnieren</button> </form>

Testen Sie die Integration: Geben Sie eine Test-E-Mail ein und prüfen Sie, ob:

  • Eine Bestätigungsmail versendet wird (bei aktiviertem Double-Opt-In)
  • Der Kontakt in Ihrer Liste erscheint (nach Bestätigung)
  • Die Erfolgsmeldung angezeigt wird

Geschafft! Sie haben erfolgreich Ihre erste Mailtre-Integration eingerichtet. Für erweiterte Funktionen und weitere Integrationen, schauen Sie sich die detaillierte Integrationsanleitung an.

API Authentifizierung

Mailtre verwendet Token-basierte Authentifizierung. Ihr API Token wird bei jeder Anfrage als URL-Parameter übergeben.

Token generieren

  1. Melden Sie sich in Ihrem Mailtre Dashboard an
  2. Navigieren Sie zu Einstellungen → API
  3. Klicken Sie auf "Neuen Token erstellen"
  4. Kopieren Sie den Token und bewahren Sie ihn sicher auf

Sicherheitshinweis

Bewahren Sie Ihren API Token sicher auf und geben Sie ihn niemals weiter. Speichern Sie ihn niemals im Frontend-Code!

Beispiel

HTTP
POST https://mail.mailtre.com/api/v1/subscribers?api_token=IHR_API_TOKEN

Abonnenten API

Verwalten Sie Ihre Abonnenten programmatisch über die API.

Abonnent hinzufügen

Endpoint: POST /api/v1/subscribers

Parameter

Parameter Typ Erforderlich Beschreibung
api_token string Ja Ihr API Token
list_uid string Ja Die ID der Liste (13 Zeichen)
EMAIL string Ja E-Mail-Adresse des Abonnenten
FIRST_NAME string Nein Vorname
LAST_NAME string Nein Nachname

Beispiel: PHP

PHP
$api_token = 'IHR_API_TOKEN'; $list_id = 'IHRE_LISTEN_ID'; $url = "https://mail.mailtre.com/api/v1/subscribers?api_token=" . $api_token; $data = [ 'list_uid' => $list_id, 'EMAIL' => 'kunde@beispiel.de', 'FIRST_NAME' => 'Max', 'LAST_NAME' => 'Mustermann' ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); $response = curl_exec($ch); $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($http_code == 200) { echo "Abonnent erfolgreich hinzugefügt!"; }

Antwort

JSON
{ "status": "success", "message": "Subscriber added successfully", "subscriber_uid": "5f8a3b1c4d2e9" }

Kampagnen API

Erstellen und verwalten Sie E-Mail-Kampagnen über die API.

Kampagne erstellen

Endpoint: POST /api/v1/campaigns

Kampagne versenden

Endpoint: POST /api/v1/campaigns/{uid}/send

Hinweis

Detaillierte Kampagnen-API Dokumentation finden Sie unter API-Referenz.

Listen API

Verwalten Sie Ihre Abonnentenlisten.

Listen abrufen

Endpoint: GET /api/v1/lists

Liste erstellen

Endpoint: POST /api/v1/lists

Listen-ID finden

Die Listen-ID finden Sie in der URL Ihrer Liste:

https://mail.mailtre.com/lists/68f38b90304c6/overview └─────┬─────┘ Listen-ID

Templates API - E-Mail-Vorlagen verwalten

E-Mail-Templates sind wiederverwendbare Design-Vorlagen, die Ihnen Zeit sparen und für Konsistenz in Ihrer Kommunikation sorgen. Mit der Templates API können Sie programmatisch Templates erstellen, abrufen, aktualisieren und löschen – ideal für Agenturen, die Templates für mehrere Kunden verwalten, oder für automatisierte Workflow-Systeme.

Warum Templates verwenden?

  • Zeitersparnis: Erstellen Sie einmal, verwenden Sie immer wieder
  • Konsistenz: Einheitliches Branding über alle Kampagnen
  • Skalierbarkeit: Perfekt für Multi-Client-Umgebungen
  • Versionierung: Behalten Sie verschiedene Versionen Ihrer Designs
  • A/B-Testing: Testen Sie verschiedene Designs gegeneinander

Templates abrufen

Endpoint: GET /api/v1/templates?api_token=YOUR_TOKEN

Ruft alle verfügbaren E-Mail-Templates ab. Die Antwort enthält Template-ID, Name, Vorschaubild, Erstellungsdatum und Status.

Template erstellen

Endpoint: POST /api/v1/templates

Parameter

Parameter Typ Erforderlich Beschreibung
name string Ja Name des Templates
content string Ja HTML-Inhalt des Templates
subject string Nein Standard-Betreffzeile

Beispiel: Template erstellen

PHP
$api_token = 'IHR_API_TOKEN'; $url = "https://mail.mailtre.com/api/v1/templates?api_token=" . $api_token; $data = [ 'name' => 'Willkommens-E-Mail', 'subject' => 'Willkommen bei uns!', 'content' => '<html><body><h1>Willkommen!</h1></body></html>' ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']); $response = curl_exec($ch); curl_close($ch);

Template löschen

Endpoint: DELETE /api/v1/templates/{template_uid}

WordPress Integration

Integrieren Sie Mailtre nahtlos in Ihre WordPress-Website.

Method 1: Plugin verwenden

  1. Laden Sie das Mailtre WordPress Plugin herunter
  2. Installieren Sie das Plugin über das WordPress Backend
  3. Konfigurieren Sie Ihren API Token in den Plugin-Einstellungen
  4. Verwenden Sie den Shortcode [mailtre_newsletter] in Ihren Posts/Pages

Method 2: Manuell über functions.php

Siehe WordPress Integration Guide

WooCommerce Integration

Verbinden Sie Mailtre mit WooCommerce für automatisches E-Mail-Marketing bei Bestellungen.

Installation

  1. Installieren Sie das Mailtre WooCommerce Plugin
  2. Aktivieren Sie das Plugin unter Plugins → Installierte Plugins
  3. Navigieren Sie zu WooCommerce → Einstellungen → Mailtre
  4. Geben Sie Ihren API Token und Listen-ID ein

Automatische Synchronisation

Das Plugin synchronisiert automatisch:

  • Neue Kunden werden zur Mailtre-Liste hinzugefügt
  • Bestellinformationen werden als Custom Fields gespeichert
  • Kunden können sich beim Checkout für den Newsletter anmelden
  • Verlassene Warenkörbe können getrackt werden

Manuelle Integration (Code)

Fügen Sie diesen Code in Ihre functions.php ein:

PHP
// Hook nach erfolgreicher Bestellung add_action('woocommerce_thankyou', 'mailtre_add_customer', 10, 1); function mailtre_add_customer($order_id) { $order = wc_get_order($order_id); $email = $order->get_billing_email(); $first_name = $order->get_billing_first_name(); $last_name = $order->get_billing_last_name(); $api_token = 'IHR_API_TOKEN'; $list_id = 'IHRE_LISTEN_ID'; $url = "https://mail.mailtre.com/api/v1/subscribers?api_token=" . $api_token; $data = [ 'list_uid' => $list_id, 'EMAIL' => $email, 'FIRST_NAME' => $first_name, 'LAST_NAME' => $last_name, 'ORDER_COUNT' => $order->get_order_number(), 'TOTAL_SPENT' => $order->get_total() ]; wp_remote_post($url, ['body' => $data]); }

Verlassene Warenkörbe

Richten Sie automatische Erinnerungen für verlassene Warenkörbe ein:

  1. Aktivieren Sie Cart-Tracking in den Plugin-Einstellungen
  2. Erstellen Sie eine Automation in Mailtre
  3. Trigger: Tag "abandoned_cart" wird hinzugefügt
  4. E-Mail nach 1 Stunde, 24 Stunden und 3 Tagen

Webhooks

Erhalten Sie Echtzeit-Benachrichtigungen über wichtige Events.

Unterstützte Events

  • subscriber.subscribed: Neuer Abonnent hinzugefügt
  • subscriber.unsubscribed: Abonnent abgemeldet
  • campaign.sent: Kampagne versendet
  • email.opened: E-Mail geöffnet
  • email.clicked: Link geklickt
  • email.bounced: E-Mail nicht zustellbar

Webhook einrichten

  1. Navigieren Sie zu Einstellungen → Webhooks
  2. Klicken Sie auf "Neuen Webhook erstellen"
  3. Geben Sie Ihre Webhook-URL ein
  4. Wählen Sie die Events aus, die Sie empfangen möchten
  5. Speichern Sie den Webhook

Code Beispiele

Praktische Code-Beispiele für häufige Anwendungsfälle.

1. Newsletter-Anmeldung mit Bestätigung

PHP
<?php if ($_POST['email']) { $email = filter_var($_POST['email'], FILTER_SANITIZE_EMAIL); if (filter_var($email, FILTER_VALIDATE_EMAIL)) { $api_token = 'IHR_API_TOKEN'; $list_id = 'IHRE_LISTEN_ID'; $url = "https://mail.mailtre.com/api/v1/subscribers?api_token=" . $api_token; $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, [ 'list_uid' => $list_id, 'EMAIL' => $email ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $result = curl_exec($ch); $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($http_code == 200) { echo "Bitte bestätigen Sie Ihre E-Mail-Adresse!"; } else { echo "Fehler bei der Anmeldung."; } } } ?>

2. Mehrere Abonnenten gleichzeitig hinzufügen

PHP
$subscribers = [ ['email' => 'kunde1@beispiel.de', 'name' => 'Max Mustermann'], ['email' => 'kunde2@beispiel.de', 'name' => 'Maria Muster'], ['email' => 'kunde3@beispiel.de', 'name' => 'John Doe'] ]; $api_token = 'IHR_API_TOKEN'; $list_id = 'IHRE_LISTEN_ID'; $url = "https://mail.mailtre.com/api/v1/subscribers?api_token=" . $api_token; foreach ($subscribers as $sub) { $data = [ 'list_uid' => $list_id, 'EMAIL' => $sub['email'], 'FIRST_NAME' => $sub['name'] ]; $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_exec($ch); curl_close($ch); // Kleine Pause um Rate Limits zu vermeiden usleep(100000); // 0.1 Sekunden }

3. AJAX Newsletter-Anmeldung (jQuery)

JavaScript
jQuery('#newsletter-form').on('submit', function(e) { e.preventDefault(); var email = jQuery('#email').val(); jQuery.ajax({ url: '/newsletter-handler.php', method: 'POST', data: { email: email }, success: function(response) { jQuery('#message').html('<p class="success">Erfolgreich angemeldet!</p>'); jQuery('#email').val(''); }, error: function() { jQuery('#message').html('<p class="error">Fehler bei der Anmeldung</p>'); } }); });

4. Abonnent-Status prüfen

PHP
function check_subscriber_status($email) { $api_token = 'IHR_API_TOKEN'; $list_id = 'IHRE_LISTEN_ID'; $url = "https://mail.mailtre.com/api/v1/subscribers?api_token=" . $api_token; $url .= "&list_uid=" . $list_id; $url .= "&email=" . urlencode($email); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $data = json_decode($response, true); if ($data['status'] == 'subscribed') { return 'Abonnent ist aktiv'; } else { return 'Nicht gefunden'; } }

5. Custom Fields dynamisch setzen

PHP
$api_token = 'IHR_API_TOKEN'; $list_id = 'IHRE_LISTEN_ID'; $custom_data = [ 'list_uid' => $list_id, 'EMAIL' => 'kunde@beispiel.de', 'FIRST_NAME' => 'Max', 'LAST_NAME' => 'Mustermann', 'COMPANY' => 'Beispiel GmbH', 'PHONE' => '+49 123 456789', 'BIRTHDAY' => '1990-01-15', 'INTERESTS' => 'Marketing, Technology', 'CUSTOMER_ID' => '12345', 'VIP_STATUS' => 'Gold' ]; $url = "https://mail.mailtre.com/api/v1/subscribers?api_token=" . $api_token; $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $custom_data); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch);

Mehr Beispiele benötigt?

Besuchen Sie unsere Integrationsseite für weitere Beispiele und Schritt-für-Schritt-Anleitungen.

Best Practices

1. Double-Opt-In verwenden

Nutzen Sie immer Double-Opt-In für DSGVO-Konformität und bessere Listen-Qualität.

2. Segmentierung nutzen

Segmentieren Sie Ihre Abonnenten nach Interessen und Verhalten für höhere Engagement-Raten.

3. Regelmäßig cleanen

Entfernen Sie inaktive Abonnenten regelmäßig, um Ihre Zustellrate zu verbessern.

4. A/B Testing

Testen Sie verschiedene Betreffzeilen, Inhalte und Versandzeiten.

5. Mobile-First Design

Über 60% der E-Mails werden auf Mobilgeräten geöffnet. Optimieren Sie Ihre Templates entsprechend.

Fehlerbehebung

API gibt 401 Unauthorized zurück

Lösung: Überprüfen Sie Ihren API Token. Stellen Sie sicher, dass er korrekt kopiert wurde.

Abonnent wird nicht hinzugefügt

Lösung: Prüfen Sie die Listen-ID. Sie muss genau 13 Zeichen lang sein.

E-Mails kommen nicht an

Lösung: Überprüfen Sie Ihre SMTP-Einstellungen und stellen Sie sicher, dass Ihr Absender-Domain korrekt konfiguriert ist (SPF, DKIM, DMARC).

Rate Limit erreicht

Lösung: Upgrade auf einen höheren Plan oder warten Sie, bis das Rate Limit zurückgesetzt wurde.

Weitere Hilfe benötigt?

Kontaktieren Sie unseren Support unter support@mailtre.com oder besuchen Sie unser Hilfe Center.