Esendex war hilfreich bei der Anpassung unser komplexen geschäftlichen Anforderungen und hat einen erstklassigen Service abgeliefert, der sein Geld wert ist.
Anthony Tunley, University of Nottingham
Wenn Sie mittels des APIs Nachrichten übertragen, ist Ihnen evtl. nicht bewusst, dass wir die Möglichkeit zum Versand mehrerer Nachrichten in einem Anruf bieten, anstatt viele einzelne Übertragungen durchführen zu müssen.
Die Batch-Übertragung hat eine Reihe von Vorteilen, darunter:
- Eine Reduzierung der Anzahl Netzanrufe, die Sie durchführen müssen,
- Schnellere Ankunft Ihrer Nachrichten,
- Optimierter Durchsatz zu unserem Gateway.
Die Ihnen verfügbaren Batch-Optionen unterscheiden sich abhängig von dem zugrunde liegenden API, das Ihr Code nutzt. Ihr Code kann entweder einen SOAP Web Service verwenden oder HTTP-Anrufe einer ASPX-Seite durchführen.
SOAP Web-Service
Wenn Sie API-Anrufe beim SendService Web Service durchführen, dann haben Sie vollen Zugriff auf beide Batch-Methoden, die wir zur Verfügung stellen. Mit diesen Methoden können Sie:
- Den selben Nachrichtentext an mehrere Mobiltelefonnummern senden,
- Eine Sammlung von Nachrichten-Objekten übertragen, die unterschiedliche Mobiltelefonnummern und Nachrichtentexte enthalten.
Wenn Sie den selben Nachrichtentext an mehrere Mobiltelefonnummern (z. B. eine Marketing-Nachricht an eine Gruppe von Abonnenten) übertragen möchten, dann nutzen Sie die Methoden SendMessageMultipleRecipients und SendMessageMultipleRecipientsFull. Diese akzeptieren eine Sammlung von Mobiltelefonnummern anstatt einer einzelnen Nummer.
Wenn Sie mehrere Nachrichten gleichzeitig übertragen müssen, deren Inhalt aber voneinander abweicht (z. B. beim Senden persönlich angepasster Nachrichten an Ihre Kunden), dann können Sie die Methode SendMessageBatch verwenden. Diese Methode nimmt eine Sammlung von messagesubmission-Objekten an, wobei ein messagesubmission-Objekt alle Nachrichteninformationen für eine Einzelnachricht enthält.
HTTP Post
Wenn Sie die HTTP Post-Schnittstelle zum Versenden von Nachrichten verwenden, dann besteht die einzige Batch-Option darin, die selbe Nachricht an eine Sammlung von Mobiltelefonnummern zu senden. Hierfür brauchen Sie nur die Mobiltelefonnummern als Teil des Empfänger-Parameters in einem SendSMS HTTP-Anruf mit Kommata getrennt zu übergeben.
Verarbeiten der Antwort
Der Aufruf einer dieser Methoden führt zu einer Reihe von Nachrichten-IDs, die Ihnen zurückgeliefert werden, anstatt einer einzelnen ID, die Sie erhalten, wenn Sie eine Einzelnachricht versenden. Diese Sammlung von IDs hat die selbe Reihenfolge wie die ursprünglich gesendeten Nachrichten.
Wichtige Hinweise
- Unsere Tests haben ergeben, dass die optimale Anzahl von Nachrichten pro Batch nicht höher als 50 sein sollte.
- Empfangsbestätigungen und etwaige auf eine Stapel-Nachricht eingehende Antworten werden nicht anders gehandhabt als bei Einzelübertragungen
- Wenn eine einzelne Nachricht in einem Stapel nicht akzeptiert wird (und der Rest des Stapels OK ist), ist die zurückgegebene Nachrichten-ID für d