E-Mail ist der Standardkanal. SMS ist der Kanal für dringende Nachrichten. Wenn Ihr KI-Agent innerhalb von Sekunden einen echten Menschen benachrichtigen muss – bei einem Ausfall, einer Betrugswarnung, einem OTP oder einer Versandaktualisierung –, wird eine SMS tatsächlich innerhalb einer Minute gelesen. Dieser Leitfaden führt Sie durch die Anbindung von Claude, GPT oder jedem anderen LLM, das Tools aufruft, an die Mailpro™ SMS-API, sowohl für Einzelversendungen als auch für Massenkampagnen.
TL;DR
Die Mailpro™ SMS-API authentifiziert sich über HTTPS mit id_client + api_key.
Verwenden Sie /send/add_single.json für eine einzelne SMS und /send/add.json für Massenversand.
Nummern verwenden das internationale E.164-Format (z. B. +447700900123) oder die entsprechende 00-Vorwahl – die API akzeptiert beides und speichert die normalisierte Form.
Jeder Endpunkt ist in über 20 Programmiersprachen auf unserem Entwicklerportal dokumentiert.
Wo KI-gesteuerte SMS tatsächlich Sinn machen
Echtzeit-Benachrichtigungen
Ihre Überwachungs-Pipeline erkennt einen Anstieg von 5xx-Fehlern. Ein KI-Agent liest die Anomalie, stuft den Schweregrad ein und sendet eine SMS mit Kontext an den Bereitschaftsingenieur („API v3: 12-fache Fehlerrate in den letzten 5 Minuten, betrifft CRM-Endpunkte“) – nicht nur einen Piepton auf dem Pager. Schnellere Diagnose, weniger Alarmmüdigkeit.
OTPs und Two-Factor-Flows
Der Agent erhält eine Anfrage „authentifiziere diesen Nutzer", generiert einen 6-stelligen Code, speichert ihn mit Ablaufdatum und sendet ihn per SMS. Der Nutzer tippt ihn zurück, der Agent verifiziert. Heute ein selbstgebauter Flow; mit dem kommenden Verify/OTP-Endpunkt (siehe unsere SMS-API-Roadmap) wird es ein einziger API-Aufruf.
Kanal-Fallback
Die E-Mail wurde in 2 Stunden nicht geöffnet, aber es ist dringend. Der Agent wechselt auf SMS — „Ihr Termin ist in 1 Stunde" — mit derselben Kontakt-Karte aus Mailpro™ v3. Kanalübergreifende Orchestrierung durch LLM-Raisonnement.
Ereignisgesteuerte Kampagnen
Black Friday Mittag: Der Agent wählt die Zielgruppe nach einem Frische-Kriterium („Kunden, die in den letzten 14 Tagen eine E-Mail geöffnet haben"), schreibt ein 140-Zeichen-Angebot und feuert eine Massen-Kampagne via /send/add.json. Angebot live in unter einer Minute, null Dashboard-Klicks.
Setup und SMS-Preismodell
id_client + api_key
Gleiches Auth-Muster wie die v2 Email API. Beide Werte finden Sie im Mailpro™-Konto unter Einstellungen → API-Zugang. Die SMS-API nutzt snake_case-Parameter (id_client, nicht IdClient) — kleiner Unterschied zu v2, im System-Prompt des Agenten erwähnen.
Credits, Länderraten, Testguthaben
SMS sind nicht pauschal bepreist: Der Preis pro Nachricht hängt vom Zielland ab. Guthaben jederzeit prüfen:
curl "https://api.mailpro.com/sms/credit/get.json?id_client=YOUR_ID&api_key=YOUR_API_KEY"
Antwort:
{ "TotalCredits": 1476 }
Für Preise pro Land siehe Mailpro-Preise.
Sandbox
Noch keine dedizierte Sandbox — testen Sie mit kleinen Volumina auf Ihrem echten Konto. Beginnen Sie mit /send/add_single.json an Ihre eigene Handynummer, bevor Sie Massenversand anschalten.
Schritt für Schritt: Einzel-SMS durch einen KI-Agenten
1. Werkzeugschema
tools = [{
"name": "send_sms",
"description": "Sendet eine Einzel-SMS an eine Nummer via Mailpro.",
"input_schema": {
"type": "object",
"properties": {
"to": {"type": "string", "description": "Internationales E.164-Format, z. B. +4915123456789"},
"message": {"type": "string", "description": "SMS-Body, max 160 Z. für ein Segment"}
},
"required": ["to", "message"]
}
}]
2. Formatierung der Rufnummern
Verwenden Sie das internationale E.164-Format: +-Zeichen, Ländercode, nationale Nummer, ohne Leerzeichen und Bindestriche. Der 00-Präfix statt + funktioniert ebenfalls. Beispiele:
-
Deutschland:
+4915123456789 -
Österreich:
+43660123456 -
Schweiz:
+41791234567 -
Niederlande:
+31612345678
Wenn Ihr Agent ungeputzte Eingaben erhält („0151 234 567 89"), normalisieren Sie vor dem Senden — Bibliotheken wie phonenumbers (Python) oder libphonenumber-js (Node) erledigen das sauber.
3. /send/add_single.json aufrufen
curl -X POST "https://api.mailpro.com/sms/send/add_single.json" \
-d "id_client=YOUR_ID&api_key=YOUR_API_KEY" \
-d "to=+4915123456789" \
-d "message=Ihr Bestätigungscode lautet 482913. 10 Min gültig."
Antwort:
{
"Result": "OK",
"IdSend": 98765,
"RemainingCredits": 1474
}
4. Zustellstatus aus der Antwort
Result: "OK" bedeutet, dass die SMS vom Gateway angenommen wurde — noch nicht ans Handy zugestellt. Für die Zustellbestätigung (DLR) lauschen Sie auf den kommenden Webhook sms.delivered (siehe SMS-API-Roadmap). Solange zeigt Ihnen RemainingCredits, dass der Versand berechnet wurde.
Massen-SMS: eine ganze Liste erreichen
Nummernlisten verwalten (/list, /phone)
SMS-Listen sind das Pendant zu E-Mail-Adressbüchern bei SMS. Endpunkte zum Auflisten, Anlegen, Ändern, Löschen von Listen und Nummern liegen unter /list/*.json und /phone/*.json.
Kampagne mit /send/add.json starten
curl -X POST "https://api.mailpro.com/sms/send/add.json" \
-d "id_client=YOUR_ID&api_key=YOUR_API_KEY" \
-d "id_list=11088" \
-d "message=Black Friday: 30% Rabatt bis Mitternacht. mailp.ro/bf2026"
Der Endpunkt stellt die Kampagne in die Warteschlange und feuert SMS an jede Nummer der Liste.
Geplant vs sofort
Fügen Sie plan_date=2026-11-27T12:00:00 hinzu zum Planen. Lassen Sie es weg, um sofort zu senden. Der Agent kann die Zeit nach der Zeitzone der Empfänger wählen — aber beachten Sie die aggregierte Zustellzeit: 10.000 SMS können mehrere Minuten durch das Gateway brauchen.
Nummern per Datei massenhaft importieren
Wie die E-Mail-API bietet auch die SMS-API jetzt einen Datei-Upload-Endpunkt:
Sie bauen einen KI-Agenten, der SMS sendet? Die Mailpro-Tarife enthalten die SMS-API, Zustellauswertung und das nötige Volumen — zu einem planbaren Preis.
curl -X POST "https://api.mailpro.com/sms/import/upload.json" \
-F "id_client=YOUR_ID" \
-F "api_key=YOUR_API_KEY" \
-F "id_list=11088" \
-F "[email protected]" \
-F "webhook_url=https://example.com/hooks/import-done"
Die erste Spalte der CSV muss Phone oder PhoneNumber heißen. Nummern werden serverseitig normalisiert; ungültige Einträge werden übersprungen (und im Job-Report gemeldet). Vollständige Spezifikation im Import-Abschnitt der SMS-Referenz.
Codebeispiele
Python (Agent → SMS mit Retry)
import anthropic, requests, time
def send_sms(to, message, retries=3):
for attempt in range(retries):
r = requests.post(
"https://api.mailpro.com/sms/send/add_single.json",
data={
"id_client": MAILPRO_ID, "api_key": MAILPRO_KEY,
"to": to, "message": message
}
)
if r.status_code == 429:
time.sleep(2 ** attempt) # exponentielles Backoff
continue
return r.json()
raise Exception("SMS-Versand nach mehreren Versuchen fehlgeschlagen")
Node.js (Express-Webhook → Claude → SMS)
import express from "express";
import Anthropic from "@anthropic-ai/sdk";
const app = express();
const ai = new Anthropic();
app.post("/alert", async (req, res) => {
const { severity, message } = req.body;
const resp = await ai.messages.create({
model: "claude-sonnet-4-5",
max_tokens: 256,
tools: [/* send_sms-Schema */],
messages: [{ role: "user", content: `Alarm ${severity}: ${message}. Bereitschaft benachrichtigen.` }]
});
for (const b of resp.content) {
if (b.type === "tool_use") {
await fetch(`https://api.mailpro.com/sms/send/add_single.json`, {
method: "POST",
body: new URLSearchParams({
id_client: ID, api_key: KEY,
to: b.input.to, message: b.input.message
})
});
}
}
res.sendStatus(200);
});
cURL
curl -X POST "https://api.mailpro.com/sms/send/add_single.json" \
-d "id_client=YOUR_ID&api_key=YOUR_API_KEY" \
-d "to=+4915123456789" \
-d "message=Ihr Mailpro-Backup ist um 03:04 UTC erfolgreich abgeschlossen."
Für denselben Aufruf in rund zwanzig weiteren Sprachen (PHP, Go, Ruby, C#, Java, Swift…) siehe die SMS-Referenz — jeder Endpunkt liefert das passende Snippet zum Kopieren.
Bald: Verify/OTP und Phone Lookup
Zwei Features unserer SMS-API-Roadmap sind für KI-Agenten-Integrationen besonders nützlich:
Verify/OTP-Endpunkt
Statt einen eigenen OTP-Flow zu bauen (Code generieren, speichern, senden, prüfen), erledigen die kommenden /verify/start- und /verify/check-Endpunkte alles: Code-Generierung, Hashing, Rate Limits, mehrsprachige Vorlagen, Versuchszähler. Der Agent ruft nur /verify/start und später /verify/check auf.
HLR Phone Lookup
Der kommende /phone/lookup-Endpunkt liefert Echtzeit-Carrier-Infos (mobile / fest / voip), Portierungserkennung (MNP) und Erreichbarkeit. Essenziell, um Lead-Listen vor einer SMS-Kampagne zu säubern — ein abgeschaltetes Handy ist verlorenes Budget.
Beide Features werden dasselbe Auth-Modell nutzen und sofort für KI-Agenten konsumierbar sein.
Tipps und Stolperfallen
PascalCase-Antworten (wie v2 E-Mail)
Die Mailpro™ SMS-API liefert Result, IdSend, RemainingCredits — PascalCase. Passt zu v2 E-Mail, anders als v3 CRM (snake_case). Erwähnen Sie es im System-Prompt.
STOP-Behandlung und Nummern-Sperrliste
Nutzer können STOP antworten, um sich abzumelden. Aktuell kümmert sich unser Gateway darum und blockiert weitere Versände automatisch. Der kommende /suppressions-Endpunkt wird die Sperrliste als API-Ressource bereitstellen — für Audit und manuelle Pflege.
DSGVO und Einwilligung
Holen Sie immer eine explizite Einwilligung für Marketing-SMS ein. Für transaktionale SMS (OTP, durch Nutzeraktion ausgelöste Alarme) ist die Einwilligung implizit. Ihr Agent soll nicht darüber entscheiden, ob ein Nutzer opt-in ist — das ist eine rechtliche, keine prompterische Entscheidung.
Anwendungsfall (fiktiv): „VeloKurier" — Berliner Lieferdienst mit KI-gesteuerten ETA-SMS
VeloKurier liefert Speisen und Pakete in Berlin. Früher bekamen Kunden zum Abholzeitpunkt eine SMS „Ihr Kurier ist unterwegs", das war's. Das Team schaltete Claude hinter das Dispatch-System: Sobald der GPS des Kuriers weniger als 500 m vom Zielpunkt anzeigte, feuerte der Agent eine Mailpro™-SMS mit angepasstem Text je nach Bestellart („Ihr Kaffee ist in 2 Minuten da — bitte an der Tür sein"). Der NPS beim Ankunftsschritt stieg um 18 Punkte. SMS-Volumen wuchs um 30%, kosten-technisch blieb Mailpro™ deutlich unter den eingesparten Supportkontakten. Das Dispatch-Team überwacht gesendete Nachrichten in der Mailpro™-Historie; gelegentlich wird der Prompt angepasst, wenn der Tonfall nicht stimmt.
Nächster Schritt
SMS ist der letzte Hauptkanal im Mailpro™-Stack. Wenn Sie unseren Säulen-Leitfaden zu KI-Agenten und Mailpro noch nicht gelesen haben, beginnen Sie dort für den Überblick. Für die E-Mail-Leitfäden siehe Transaktions-E-Mail v2 und CRM v3.
Referenz: Mailpro SMS-API. Preise: Mailpro-Preise.
FAQ
Kann ein KI-Agent OTPs via Mailpro senden?
Heute ja, selbstgebaut: 6-stelligen Code generieren, mit Ablaufdatum speichern, via /send/add_single.json senden. Demnächst wird ein dedizierter /verify/start + /verify/check-Endpunkt das alles in einem Aufruf erledigen. Siehe SMS-API-Roadmap.
Was kostet eine SMS?
Abhängig vom Zielland. Siehe Preise für die aktuelle Preisliste.
Unterstützt die API internationale Nummern?
Ja, Mailpro™ sendet in 200+ Länder. Nutzen Sie E.164 (+<Ländercode><Nummer>, z. B. +4915123456789) oder das äquivalente 00-Präfix — die API akzeptiert beides.
Wie blockiere ich eine Nummer, die STOP geantwortet hat?
Aktuell automatisch auf Gateway-Ebene. Der kommende /suppressions-Endpunkt erlaubt es, gesperrte Nummern per API aufzulisten, hinzuzufügen und zu entfernen — nützlich für den Abgleich mit Ihrer eigenen Präferenzdatenbank.
Mailpro und die SMS-API
Lassen Sie Ihren KI-Agenten SMS senden — Mailpro übernimmt den Rest
Verbinden Sie Ihren KI-Agenten mit der SMS-API von Mailpro, und er verschickt SMS eigenständig — Erinnerungen, Hinweise, Bestätigungen. Sie behalten Reichweite und Auswertung; sehen Sie, was der Betrieb kostet.
