Transaktions-E-Mail-API für KI-Agenten: Leitfaden Mailpro™ v2

Wenn Sie unseren Säulen-Leitfaden zu KI-Agenten und der Mailpro™-API gelesen haben, wissen Sie bereits, warum die Anbindung eines KI-Agenten an eine E-Mail-API der kürzeste Weg vom „Chatbot" zum „digitalen Kollegen" ist. Dieser Artikel geht tief auf eine bestimmte API ein — die Mailpro™ Email API v2 — und zeigt ein funktionierendes Setup sowohl für Transaktions- als auch für Kampagnen-Versände, gesteuert von Claude, GPT oder einem beliebigen LLM mit Tool-Calling-Unterstützung.

Kurzfassung

• Mailpro™ Email API v2 nimmt IdClient + ApiKey über HTTPS — kein SDK nötig.
• Die beiden meistgenutzten Endpunkte sind /send/sendmail.json (transaktional) und /send/campaign.json (Bulk).
• Jedes Tool-Calling-LLM kann die API über einen dünnen Wrapper steuern.
• Jeder Endpunkt ist in 20+ Programmiersprachen auf unserem Entwicklerportal dokumentiert.

KI-gesteuerte E-Mails: die Anwendungsfälle, die zählen

Intelligente Bestellbestätigungen

Standard-Bestellbestätigungen sind vorlagenförmig. Ihr KI-Agent kann mehr: Er kann eine persönliche Notiz schreiben („Danke, dass Sie sich für das Modell XL Blau entschieden haben, ein Kundenfavorit") und dynamische Empfehlungen anhängen, um dann die E-Mail-API aufzurufen und alles zu versenden. Sie behalten die Zuverlässigkeit einer strukturierten Vorlage und bekommen die Wärme einer persönlichen Notiz.

Support-Auto-Triage

Wenn ein Ticket eingeht, klassifiziert der Agent es, formuliert eine Antwort und sendet sie — bei ausreichend hoher Konfidenz — direkt. Tickets mit niedriger Konfidenz werden an einen Menschen geroutet. Genau dieses hybride Modell setzen produktive Support-Teams heute ein.

Digest-Generierung

Im großen Stil wollen Führungskräfte Zusammenfassungen, keine Fluten. Ein Agent liest 40 Rechnungen pro Tag und sendet abends um 18 Uhr einen Executive-Digest: „Heute: 12 bezahlt, 3 überfällig, 2 zur Prüfung markiert." Eine E-Mail, null Rauschen. Die Mailpro™ Email API kümmert sich um die Zustellung; das LLM um die Synthese.

Setup in 5 Minuten

1. IdClient und ApiKey abholen

Beide finden Sie in Ihrem Mailpro™-Konto unter Einstellungen → API-Zugang. IdClient ist eine numerische ID; ApiKey ist ein GUID. Bewahren Sie den Schlüssel geheim — behandeln Sie ihn wie ein Passwort.

2. Sanity-Check mit /account/credits.json

Bevor Sie Claude anbinden, prüfen Sie, ob Ihre Credentials funktionieren:

curl "https://api.mailpro.com/v2/account/credits.json?IdClient=YOUR_ID&ApiKey=YOUR_API_KEY"

Sie sollten ein JSON mit Ihren verbleibenden E-Mail-Credits erhalten. Bei 401 den Schlüssel prüfen. Bei 500 die Statusseite prüfen.

3. Vollständige Referenz erkunden

Jeder Endpunkt ist dokumentiert — mit Request/Response-Struktur und einem „Jetzt testen"-Bereich — auf der Email API v2 Referenz. Öffnen Sie sie in einem zweiten Tab und halten Sie sie bereit.

Schritt für Schritt: Claude versendet eine Transaktions-E-Mail

Wir nutzen Claude von Anthropic, aber dasselbe Muster funktioniert mit OpenAI Function Calling oder Gemini Tool Use — das SDK ändert sich, die Architektur nicht.

1. Werkzeugschema definieren

Sie richten transaktionale Versände ein? Die automatischen E-Mails von Mailpro lösen sofort bei jedem Trigger aus — Belege, Bestätigungen, Benachrichtigungen — mit zuverlässiger Zustellung.

tools = [{
    "name": "send_transactional_email",
    "description": "Sendet eine Einzel-E-Mail an einen Empfänger via Mailpro.",
    "input_schema": {
        "type": "object",
        "properties": {
            "to":      {"type": "string", "format": "email"},
            "subject": {"type": "string"},
            "html":    {"type": "string", "description": "Vollständiger HTML-Body"},
            "from":    {"type": "string", "description": "Validierte Absenderadresse"}
        },
        "required": ["to", "subject", "html", "from"]
    }
}]

2. System-Prompt formulieren

Du bist ein Assistent, der Customer-Success-Mitarbeitern hilft, Nachfass-
E-Mails zu verfassen und zu versenden. Wenn der Mensch bestätigt, nutze das
Werkzeug `send_transactional_email`. Sei knapp, freundlich und füge immer
einen klaren Call-to-Action-Link ein.

3. Tool-Call parsen und /send/sendmai&ApiKey=YOUR_API_KEY" \ -d "Subject=Frühlings-Sale — 30% Rabatt" \ -d "Body=<html>...[FirstName]... <a href=\"{link}\">Jetzt kaufen</a></html>"

Der Agent kann das Body-HTML direkt generieren. Nutzen Sie [FirstName], [LastName] und weitere Mailpro™-Platzhalter für Personalisierung pro Kontakt — die API löst sie beim Versand anhand Ihrer Listendaten auf.

Kampagne mit /send/campaign.json starten

curl -X POST "https://api.mailpro.com/v2/send/campaign.json" \
  -d "IdClient=YOUR_ID&ApiKey=YOUR_API_KEY" \
  -d "AddressBookId=42" \
  -d "IDMessage=9001" \
  -d "PlanDate=2026-05-01T09:00:00"

PlanDate ist optional — lassen Sie es weg und die Kampagne geht sofort raus. Setzen Sie es und Mailpro™ plant den Versand für Sie. Gutes Muster: Lassen Sie den Agenten PlanDate nach der Zeitzone des Empfängers wählen.

Personalisierung mit Platzhaltern

Platzhalter wie [FirstName] und [LastName] sind Standard; benutzerdefinierte Felder ([Field1], [Field2]…) bilden die Custom-Spalten Ihrer Liste in der Reihenfolge ab, in der Sie sie definiert haben. Der Agent muss die Werte nicht kennen — er referenziert den Platzhalter im generierten HTML, die API füllt pro Empfänger.

Kontakte per Agenten-Upload massenhaft importieren

Wenn die erste Aktion des Agenten „500 neue Leads hinzufügen" ist, wollen Sie nicht 500 einzelne API-Aufrufe. Nutzen Sie den Endpunkt /import/upload.json, den wir kürzlich hinzugefügt haben:

curl -X POST "https:/   Subject: block.input.subject,
        Body: block.input.html,
        EmailFrom: block.input.from
      })
    });
    console.log(await r.json());
  }
}

cURL Einzeiler

curl -X POST "https://api.mailpro.com/v2/send/sendmail.json" \
  -d "IdClient=YOUR_ID&ApiKey=YOUR_API_KEY" \
  -d "[email protected]" \
  -d "Subject=Ihr Beleg" \
  -d "Body=<h1>Danke Jane!</h1>" \
  -d "[email protected]"

Für denselben Aufruf in rund zwazzig weiteren Sprachen (PHP, Go, Ruby, C#, Java, Swift…), öffnen Sie die Email API v2 Referenz — jeder Endpunkt liefert das entsprechende Snippet fertig zum Kopieren.

Stolperfallen und Tipps

• Antwortfelder in PascalCase. v2 liefert Result, IDSend, RemainingCredits (kein camelCase). Wenn Ihr Agent Antworten parst, nennen Sie das im System-Prompt — sonst halluziniert er result und idSend.
• Abgemeldete Adressen werden stillschweigend übersprungen. Setzen Sie Force=1 auf /email/add nur mit ausdrücklicher Einwilligung — es umgeht die Opt-out-Prüfung, was sonst ein DSGVO-Risiko ist.
• Rate Limit: 500 Anfragen/Minute pro Schlüssel. Bündeln Sie Kontakte in /email/add (Bulk) statt einen /email/addSingle-Aufruf pro Kontakt.
• Bleiben Sie bei JSON. XML wird unterstützt (.xml-Suffix), JSON ist schneller zu parsen und harmoniert besser mit LLM-Tool-Outputs.

Anwendungsfall (fiktiv): „NovaFit" — Fitness-Kette mit KI-personalisierten Kurs-Erinnerungen