Wie man E-Mails und SMS mit einem KI-Agenten versendet (Mailpro™ API-Leitfaden)

Ein KI-Agent, der nur reden kann, ist ein Chatbot. Ein KI-Agent, der die E-Mail versendet, dem Kunden eine SMS schickt und den Kontaktdatensatz aktualisiert, ist ein Teammitglied. Dieser Leitfaden zeigt, wie Sie Claude, GPT oder jedes andere LLM mit Tool Calling an die Mailpro™ APIs anbinden, damit Ihr Agent E-Mails und SMS selbstständig und sicher versendet — jede Nachricht protokolliert und nachvollziehbar.

Das Wichtigste in Kürze

• Mailpro™ stellt drei HTTPS-APIs bereit, die Ihr Agent aufrufen kann: die Email API v2 (Transaktions-E-Mails und Kampagnen), die CRM API v3 (Kontakte, Listen, Tags) und die SMS API.
• Jede Aktion wird in ein kleines Tool verpackt: Das Modell entscheidet, wann es aufgerufen wird, Ihr Code führt die HTTP-Anfrage aus.
• Authentifizieren Sie sich mit einem OAuth-2.0-Token, das auf die vom Agenten benötigten Scopes beschränkt ist — niemals mit Ihrem Master-API-Schlüssel in einem Prompt.
• Nutzen Sie Webhooks (email.delivered, email.bounced, sms.delivered…), damit der Agent weiß, was tatsächlich passiert ist.
• Behalten Sie für Massenversände und unbekannte Empfänger einen menschlichen Freigabeschritt bei.

Warum sollte Ihr KI-Agent E-Mails und SMS versenden können?

Weil der größte Nutzen eines Agenten in dem liegt, was er tut, nachdem er die Anfrage verstanden hat. Ein Support-Agent, der eine Antwort entwirft, ist hilfreich; einer, der die Antwort versendet, die Erstattung per SMS bestätigt und den Kontakt als "erstattet" taggt, schließt das Ticket. Typische Aufgaben, die heute schon gut funktionieren:

• Nachfassen bei Bestellungen und Buchungen — eine Bestätigungs-E-Mail mit einer persönlichen Notiz des Agenten, dazu eine SMS-Erinnerung am Vortag.
• Support-Triage — der Agent klassifiziert das Ticket, beantwortet einfache Anfragen per E-Mail und leitet den Rest an einen Menschen weiter.
• Einmalcodes und Benachrichtigungen — der Agent erzeugt einen Code, sendet ihn per SMS und prüft ihn, wenn der Nutzer antwortet.
• Tägliche Zusammenfassungen — der Agent liest die Daten des Tages und versendet eine einzige Übersichts-E-Mail statt vierzig Benachrichtigungen.

Was sind die Mailpro™ APIs, in 30 Sekunden erklärt?

Alle drei akzeptieren dasselbe OAuth-2.0-Token (einmalig ausgestellt unter https://api.mailpro.com/oauth/token), liefern JSON zurück und teilen sich ein monatliches Anfragekontingent pro Konto. Jeder Endpoint ist mit Anfrage- und Antwortbeispielen im Mailpro™ Entwicklerportal dokumentiert.

Wie ruft ein KI-Agent eine E-Mail- oder SMS-API auf?

Über Tool Calling (bei Anthropic heißt es Tool Use, bei OpenAI Function Calling). Sie beschreiben jede Aktion als Tool mit einem JSON-Schema. Entscheidet das Modell, dass eine Aktion nötig ist, gibt es einen Tool-Aufruf mit Argumenten zurück; Ihr Code prüft diese, ruft die Mailpro™ API auf und gibt das Ergebnis an das Modell zurück. Das Modell hat nie Zugriff auf Ihre Zugangsdaten und führt die HTTP-Anfrage nie selbst aus.

Wenn Sie die Schleife nicht selbst schreiben möchten, lassen sich dieselben Tools über einen MCP-Server (Model Context Protocol) bereitstellen, den Claude Desktop, Claude Code und Cursor direkt nutzen können. Die zugrunde liegenden API-Aufrufe sind dieselben.

Minimalbeispiel: Claude versendet eine E-Mail und eine SMS

1. Ein Token mit eingeschränkten Scopes anfordern

curl -X POST https://api.mailpro.com/oauth/token \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "scope=email:send email:read sms:send"

Legen Sie Client-ID und Secret in Ihrem Mailpro™ Konto unter Settings → API access (Einstellungen → API-Zugang) an. Das Access-Token ist 20 Minuten gültig; Ihr Code fordert nach Ablauf ein neues an.

2. Die Tools definieren

tools = [
  {
    "name": "send_email",
    "description": "Sendet eine Transaktions-E-Mail an einen einzelnen Empfänger.",
    "input_schema": {
      "type": "object",
      "properties": {
        "to": {"type": "string"},
        "subject": {"type": "string"},
        "html": {"type": "string"}
      },
      "required": ["to", "subject", "html"]
    }
  },
  {
    "name": "send_sms",
    "description": "Sendet eine SMS (max. 160 Zeichen) an eine einzelne Telefonnummer.",
    "input_schema": {
      "type": "object",
      "properties": {
        "to": {"type": "string", "description": "Internationales Format, z. B. +41791234567"},
        "message": {"type": "string"}
      },
      "required": ["to", "message"]
    }
  }
]

3. Die Tool-Aufrufe ausführen

import requests

API = "https://api.mailpro.com"
SENDER_ID = 201  # aus GET /v2/senderEmail/list

def run_tool(name, args, token):
    h = {"Authorization": f"Bearer {token}"}
    if name == "send_email":
        r = requests.post(f"{API}/v2/send/sendmail.json", headers=h, data={
            "IDEmailExp": SENDER_ID,
            "EmailData": args["to"],
            "Subject": args["subject"],
            "BodyHTML": args["html"],
            "ActivateStatistics": "true",
        })
    elif name == "send_sms":
        r = requests.post(f"{API}/sms/send/add_single.json", headers=h, data={
            "to": args["to"],
            "message": args["message"],
        })
    else:
        return {"error": "unknown tool"}
    return r.json()

Binden Sie run_tool in Ihre übliche Claude- (oder OpenAI-)Schleife ein: Senden Sie die Nutzernachricht mit tools, führen Sie jeden vom Modell zurückgegebenen Tool-Aufruf aus und geben Sie das Ergebnis als Tool Result zurück. Der E-Mail-Aufruf liefert eine IdSingleSend, der SMS-Aufruf eine Id. Speichern Sie beide: Damit verfolgen Sie die Zustellung.

Lieber ohne Code? Die automatischen E-Mails von Mailpro versenden Bestätigungen, Erinnerungen und Benachrichtigungen auf Basis von Auslösern, die Sie mit wenigen Klicks einrichten.

Woher weiß der Agent, ob die Nachricht zugestellt wurde?

Eine 200-Antwort bedeutet, dass Mailpro™ die Nachricht angenommen hat — nicht, dass sie im Posteingang oder auf dem Telefon angekommen ist. Es gibt zwei Wege, den Kreis zu schließen:

• Polling — GET /v2/send/{IdSingleSend}/status.json liefert für eine Transaktions-E-Mail queued, sent, delivered, deferred oder bounced.
• Webhooks (empfohlen) — Sie abonnieren einmalig mit POST /webhooks, und Mailpro™ sendet ein signiertes Ereignis an Ihren Server: email.delivered, email.bounced, email.opened, sms.delivered, sms.failed und weitere. Jede Anfrage enthält einen HMAC-Header X-Mailpro-Signature, mit dem Sie prüfen können, dass sie wirklich von Mailpro™ stammt.

Geben Sie diese Ereignisse an den Agenten zurück, dann kann er selbstständig reagieren: eine fehlgeschlagene SMS per E-Mail nachholen oder eine gebouncte Adresse an einen Menschen melden.

Sicherheit und Best Practices für den KI-gesteuerten Versand

Geben Sie dem Agenten ein Token mit eingeschränkten Scopes, nicht Ihre Schlüssel

OAuth-Tokens tragen Scopes wie email:send, email:read, contacts:read oder sms:send. Ein Agent, der nur Bestätigungen versendet, braucht kein contacts:write. Ein Aufruf außerhalb seiner Scopes schlägt mit 403 insufficient_scope fehl. Bewahren Sie das Client-Secret in serverseitigen Umgebungsvariablen auf und schreiben Sie es niemals in einen Prompt.

Behalten Sie bei riskanten Versänden einen Menschen in der Schleife

Lassen Sie den Agenten Einzelnachrichten selbstständig versenden, verlangen Sie aber eine Freigabe für Kampagnen (/v2/send/campaign, /sms/send/add), für Empfänger außerhalb Ihrer Kontaktlisten und für jede Nachricht, in der es um Geld geht. Eine einfache Allowlist von Empfängerdomains oder -listen im Code Ihrer Tools verhindert, dass ein fehlerhafter Prompt eine Massenmail an Ihre Kunden auslöst.

Kontingent beachten und bei Fehlern zurückhaltend wiederholen

Ihre API-Anfragen teilen sich ein monatliches Kontingent über die Email-, CRM- und SMS-APIs hinweg (abrufbar mit GET /v2/account/limits.json). Ein Agent, der in einer Schleife festhängt, kann es schnell aufbrauchen: Begrenzen Sie die Tool-Aufrufe pro Konversation und wiederholen Sie bei 429- und 5xx-Antworten mit exponentiellem Backoff, statt sofort erneut zu senden.

Einwilligungen und Abmeldungen respektieren

Abgemeldete und auf der Blacklist stehende Kontakte werden automatisch übersprungen, und die API teilt Ihnen das mit. Lassen Sie den Agenten das nicht umgehen. Prüfen Sie bei SMS vor dem Versand von Marketingnachrichten die Regeln des jeweiligen Ziellandes.

Alles protokollieren

Speichern Sie jeden Tool-Aufruf mit seinen Argumenten, der API-Antwort und der zurückgegebenen ID. Wenn ein Kunde fragt "Warum habe ich das bekommen?", können Sie in Sekunden antworten.

Fallstudie (fiktiv): "LoopKart" lässt Claude die E-Mails nach dem Kauf schreiben

LoopKart ist ein kleiner Onlineshop für generalüberholte Küchengeräte. Seine E-Mails nach dem Kauf bestanden aus einer einzigen Vorlage für alle. Das Team hat Claude mit einem einzigen send_email-Tool an die Mailpro™ Email API angebunden: Nach jeder Bestellung liest der Agent die Bestellung und die Kundenhistorie, schreibt einen kurzen persönlichen Absatz (Pflegetipps für genau dieses Produkt, ein Hinweis bei Stammkunden) und versendet die E-Mail über /v2/send/sendmail. Ein zweites Tool verschickt eine SMS, sobald das Paket unterwegs ist. Bestellungen über einem festgelegten Betrag sowie jede Nachricht, in der eine Erstattung erwähnt wird, warten vor dem Versand auf den Klick eines Menschen. Die Einrichtung dauerte zwei Tage, die meiste Zeit davon floss in das Formulieren und Testen der Freigaberegel.

Häufig gestellte Fragen

Welche KI-Modelle funktionieren mit der Mailpro™ API?

Jedes Modell, das Tool Calling oder Function Calling unterstützt: Claude, GPT, Gemini, Mistral sowie Open-Source-Modelle, die über ein Tool-Calling-Framework bereitgestellt werden. Die API selbst ist reines HTTPS mit JSON, das Modell braucht also nur einen schlanken Wrapper.

Brauche ich einen kostenpflichtigen Mailpro™ Tarif, um loszulegen?

Nein. Sie können mit dem kostenlosen Tarif starten, alles testen und upgraden, sobald Ihr Volumen es rechtfertigt. Siehe Mailpro Preise.

Kann der Agent an eine ganze Liste senden?

Ja, mit /v2/send/campaign für E-Mails und /sms/send/add für SMS. Wir empfehlen dafür einen menschlichen Freigabeschritt.

Gibt es einen MCP-Server?

Sie können dieselben Tools über jedes beliebige MCP-Server-Framework bereitstellen; die zugrunde liegenden Aufrufe sind die oben gezeigten.

Weiterführende Artikel

• Transaktions-E-Mails und Kampagnen im Detail: Transaktions-E-Mail-API für KI-Agenten
• Kontakte, Listen und Tags: CRM mit KI automatisieren
• SMS, Codes und Erinnerungen: SMS mit einem KI-Agenten senden
• Im Posteingang ankommen: E-Mail-Zustellbarkeit
• Das SMS-Gateway selbst: Mailpro SMS-API