Mit der Multichannel-APISMS in C# versenden
Mit der SMS-API für C# von Esendex können Sie aus Ihrem .NET-Projekt heraus direkt Nachrichten über fünf verschiedene Kommunikationskanäle versenden – mit nur einer einzigen Integration. HttpClient übernimmt die HTTP-Anfrage und das Framework stellt die übrigen Funktionen bereit. Sie müssen den Code für den SMS-Versand nur einmal entwickeln; wenn Sie später RCS-, WhatsApp-Nachrichten oder E-Mails versenden möchten, müssen Sie lediglich einen einzigen Wert in Ihrem Objekt ändern. Der restliche Code bleibt unverändert.
Was die SMS-API für C# von Esendex im Entwicklungsalltag verändert
- Ein einziger Endpunkt für mehrere Kanäle:SMS und RCS (WhatsApp, E-Mail und Sprachanrufe folgen in Kürze).
- Es muss weniger Code geschrieben und gewartet werden als bei separaten APIs.
- Bei einem neuen Kanal muss lediglich eine Einstellung geändert werden – ganz ohne Neuprogrammierung.
- HttpClient und .NET reichen aus, es muss kein NuGet-Paket installiert werden.
- Die Integration ist in durchschnittlich weniger als 3 Stunden eingerichtet.
- Integrierte Vorlagen, Webhooks, Zeitplanung und URL-Kürzung.
- Nach ISO 27001 und Cyber Essentials zertifizierte Infrastruktur.
SMS-API für C#: Versenden Sie Nachrichten über fünf Kanäle direkt aus Ihren .NET-Projekten
Der Versand erfolgt über eine asynchrone POST-Anfrage an /v2/messages mit HttpClient. Sie erstellen den Request-Body im JSON-Format, und die REST-API von Esendex verarbeitet die Anfrage.
Beispielcode mit HttpClient
using System.Text;
var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://api.esendex.fr/v2/messages");
request.Headers.Add("X-Api-Key", "YOUR_KEY_HERE");
var body = @"{
""accountReference"": ""xxxxxxxxxx"",
""channel"": ""SMS"",
""from"": ""MonEntreprise"",
""body"": { ""text"": ""Bonjour, votre commande #1234 a été expédiée."" },
""recipients"": [{ ""msisdn"": ""+33612345678"" }]
}";
request.Content = new StringContent(body, Encoding.UTF8, "application/json");
var response = await httpClient.SendAsync(request);
Console.WriteLine($"HTTP {(int)response.StatusCode}");
Testen Sie Esendex kostenlos
7-tägige kostenlose Testphase.
Mehr über unsere API erfahren
Entdecken Sie unsere speziell für Entwickler konzipierte API.
Das Skript funktioniert ab .NET 6 mit Top-Level-Statements. Sie müssen weder eine Programmklasse noch eine Main-Methode deklarieren.
- HttpClient sendet die Anfrage asynchron über SendAsync().
- Ihr API-Schlüssel wird im HTTP-Header X-Api-Key übermittelt.
- StringContent überträgt den JSON-Inhalt mit UTF-8-Codierung und dem Content-Type application/json.
Die drei Felder, die in JSON angepasst werden müssen
Welcher Absendername wird dem Empfänger angezeigt?
Im JSON-Request-Body legt das Feld from die Absenderkennung fest, die auf dem Mobiltelefon der Empfängerin oder des Empfängers angezeigt wird. Hier können Sie Ihren Unternehmensnamen oder eine dedizierte Rufnummer angeben.
Welches Format soll für die Nummern verwendet werden?
Die Telefonnummern im Feld recipients müssen dem internationalen E.164-Format entsprechen. Das bedeutet, dass die führende 0 durch die jeweilige Ländervorwahl ersetzt wird. Bei einer deutschen Mobilfunknummer wird beispielsweise aus 01701234567 die Nummer +491701234567. Das recipients-Array unterstützt mehrere Telefonnummern. So können Sie dieselbe Nachricht mit einer einzigen API-Anfrage an Dutzende Empfängerinnen und Empfänger versenden.
Wie lässt sich feststellen, ob die Nachricht versendet wurde?
Die API gibt den HTTP-Statuscode 202 zurück, sobald die Nachricht zur Verarbeitung angenommen wurde. Der Response-Body enthält eine eindeutige ID, die Sie mit response.Content.ReadAsStringAsync() auslesen können.
Mit dieser ID können Sie den Zustellstatus der Nachricht über Webhooks nachverfolgen. Der HTTP-Statuscode 400 weist auf einen Fehler in Ihrer Anfrage hin. Die JSON-Antwort gibt an, welches Feld den Fehler verursacht hat. Der Statuscode 401 bedeutet, dass der API-Schlüssel fehlt oder ungültig ist.
Eine einzige .NET-Integration für fünf Kanäle
Die REST-API von Esendex basiert auf einem einzigen Endpunkt. Ihre SMS-API-Integration funktioniert sowohl für SMS als auch für RCS (Hinweis: WhatsApp, E-Mail und Sprachanrufe sind in Kürze verfügbar).
Weniger Code, weniger Wartungsaufwand
Früher erforderte jeder Kommunikationskanal eine eigene Integration. Wenn sowohl SMS als auch E-Mails versendet werden sollen, sind zwei APIs, zwei separate Testsuiten und zwei unterschiedliche Logiken zur Fehlerbehandlung nötig.
Mit der API von Esendex benötigen Sie nur eine einzige Klasse für den Nachrichtenversand. Dadurch reduzieren sich sowohl der Codeumfang als auch die Fehleranfälligkeit. Wenn Sie den API-Aufruf anpassen, gilt die Änderung automatisch für alle Kommunikationskanäle.
Kommunikationskanal wechseln, ohne den Code anzupassen
Der Code, den Sie für den SMS-Versand entwickelt haben, funktioniert unverändert auch für die anderen Kommunikationskanäle. Die URL, der HTTP-Header und die Fehlerbehandlung bleiben gleich. Lediglich der Wert des Feldes channel im JSON-Request-Body ändert sich.
HttpClient und .NET ersetzen externe Bibliotheken
HttpClient ist Teil des .NET-Frameworks.
System.Text.Json konvertiert Ihre C#-Objekte seit .NET Core 3.1 nativ in JSON.
Sie müssen weder NuGet-Pakete noch SDKs von Drittanbietern installieren.
Ihr Projekt verfügt über eine eigene .csproj-Datei, ohne dass externe Abhängigkeiten überwacht werden müssen.
Was nach Ihrem SendAsync()-Aufruf passiert
Bei der Integration einer SMS-API kommt es nicht nur auf den Code an. Die Zuverlässigkeit des Netzwerks und die Datensicherheit sind ebenso wichtig. Ihre Anfrage wird an das SMS-Gateway von Esendex übermittelt, das die Nachricht an den jeweiligen Mobilfunknetzbetreiber oder Kommunikationskanal weiterleitet.
Derselbe HttpClient für SMS, RCS, WhatsApp, E-Mail und Sprachnachrichten
Die HttpClient-Instanz versendet transaktionale SMS, RCS-Kampagnen und WhatsApp-Nachrichten über denselben asynchronen API-Aufruf.
Sie pflegen eine einheitliche Versandlogik für alle fünf Kommunikationskanäle. Ihre Tests und Ihr Monitoring decken sämtliche Nachrichten ab, ohne dass zusätzliche Anpassungen erforderlich sind.
Keine Downtime, keine Überraschungen
Die Esendex-API weist eine Verfügbarkeit von 99,99 % auf.
Die Zertifizierungen ISO 27001 und Cyber Essentials gewährleisten die Datensicherheit bei jeder Übermittlung. Ferner schützt die HTTPS-Verschlüsselung jeden Datenaustausch.
Entdecken Sie die Esendex-API
In Ihrer Programmiersprache
Nach Anwendungsfall
Die SMS-API für C# von Esendex lässt sich mit HttpClient und ohne zusätzliche NuGet-Pakete in Ihre .NET-Projekte integrieren. Ob transaktionale SMS, Sicherheitsbenachrichtigungen oder RCS-Nachrichten – über denselben API-Endpunkt können Sie fünf Kommunikationskanäle nutzen. Erstellen Sie Ihr kostenloses Testkonto, um die API auszuprobieren.
Häufig gestellte Fragen | Alles, was Sie über die C#-SMS-API von Esendex wissen müssen
![]()
Funktioniert die Esendex-API mit dem .NET Framework oder nur mit .NET 6 und höher?
Funktioniert die Esendex-API mit dem .NET Framework oder nur mit .NET 6 und höher?Die REST-API von Esendex akzeptiert jede gültige HTTPS-Anfrage, unabhängig von der .NET-Version. Der Code auf dieser Seite verwendet die vereinfachte Syntax für Top-Level-Anweisungen, die seit .NET 6 verfügbar ist. Unter .NET Framework 4.x lässt sich derselbe HttpClient-Aufruf in einer herkömmlichen Main-Methode in Visual Studio verwenden.
![]()
Muss ich ein NuGet-Paket installieren, um in C# SMS versenden zu können?
Sowohl HttpClient als auch System.Text.Json sind direkt in das .NET-Framework integriert, sodass Sie in C# SMS-Nachrichten ohne externe Abhängigkeiten versenden können.
![]()
Wie erstelle ich den JSON-Body ohne Newtonsoft.Json?
System.Text.Json, das ab .NET Core 3.1 in .NET integriert ist, konvertiert Ihre C#-Objekte automatisch in JSON. Sie können die JSON-Payload auch direkt als Verbatim-Zeichenkette unter Verwendung der Syntax @“…“ schreiben, wie im Beispiel auf dieser Seite gezeigt.
![]()
Kann ich die API von einer ASP.NET-Anwendung oder von Azure Functions aus aufrufen?
Ja. Der API-Aufruf funktioniert in jedem .NET-Projekt, das HttpClient unterstützt. ASP.NET-Anwendungen, Azure Functions, Windows-Services und Konsolenanwendungen verwenden alle dieselbe asynchrone Codestruktur.
![]()
Wie kann ich den Zustellstatus einer in C# versendeten SMS nachverfolgen?
Die API gibt für jede akzeptierte Nachricht eine eindeutige Kennung zurück (HTTP-Statuscode 202). Konfigurieren Sie in Ihrem Esendex-Konto-Dashboard einen Webhook, um Zustellbenachrichtigungen in Echtzeit direkt an Ihrem angegebenen Endpunkt zu erhalten.
![]()
Unterstützt die API den Massenversand von SMS aus einem .NET-Projekt heraus?
Ja. Das recipients-Array akzeptiert mehrere Telefonnummern innerhalb einer einzigen Anfrage. Bei größerem Nachrichtenvolumen können Sie auch eine Verbindung über SMPP herstellen, das speziell für den Massenversand von Nachrichten konzipiert ist.
Lassen Sie uns gemeinsam mit dem Versand starten.
Entdecken Sie das volle Potenzial unserer Mobile-Messaging-Plattform.
