1. Home
  2. Docs
  3. Gateway
  4. HTTP Api
  5. SMS Versand

SMS Versand

Nutzen Sie diese API zum Versand von SMS mit zahlreichen Funktionen an einen oder mehrere Empfänger gleichzeitig.

Bitte richten Sie Ihren Request an folgende URL:

https://gateway.sms77.io/api/sms

Benötigte Parameter

Zusätzlich zur Authentifizierung werden folgende Parameter benötigt:

ParameterBeschreibungBeispiele
toEmpfängernummer – möglich sind Nummern und Adressbucheinträge (Gruppen und Kontakte). Mehrere Empfänger können per Komma separiert angegeben werden0049171999999999
0171999999999
49171999999999
Gruppe1
textTextnachrichtBis zu 1520 Zeichen
(Bei mehr als 160 Zeichen wird der Text auf mehrere SMS verteilt, jede SMS wird einzeln berechnet)

Optionale Parameter

1 = Parameter wird aktiviert
0 = Parameter inaktiv

ParameterBeschreibungBeispiele
typeSMS-Typ entsprechend der SMS-Typen auf sms77.io. Bitte verwenden Sie für wichtige SMS den Typ Direct. Bei Economy SMS kann es technischen Gründen zu verzögertem oder fehlendem Versand kommen.economy
direct
fromAbsendernummer. Dieser darf maximal 11 alphanumerische oder 16 numerische Zeichen enthalten.Absender
01761234567890
FirmaABC
debugFalls aktiviert werden keine SMS verschickt oder berechnet.1
0
delayDatum/Zeit für zeitversetzten VersandWahlweise Unix-Timestamp oder Format yyyy-mm-dd hh:ii
Bsp: 1141511104
oder
2016-03-04 23:25:04
no_reloadReloadsperre ausschalten. Diese Sperre verhindert den Versand von gleichen SMS (Text, Typ & Empfänger gleich) innerhalb von 180 Sekunden. Diese Sperre können Sie auch dauerhaft in Ihrem Login unter Einstellungen > SMS deaktivieren.1
0
unicodeVersand als Unicode SMS (kyrillisch, arabische etc Schriftzeichen). Die SMS Länge verkürzt sich dadurch auf 70 Zeichen. Bitte beachten Sie, dass unser Gatway die Kodierung automatisch erkennt. Dieser Parameter ist daher nicht notwendig. Sie können hiermit allerdings eine bestimmte Versandart forcieren. Nur Direct SMS unterstützen unicode Nachrichten.1
0
flashSMS als Flash SMS versenden. Diese werden direkt im Display des Empfängers angezeigt (nur bei Direct SMS verfügbar)1
0
udhNur für Direct SMS. Individueller User Data Header (UDH) der SMS. Sofern angegeben und Variable text Hexcode enthält, wird die Nachricht als 8-bit Binary SMS versendet050003CC0201 (Verkettete Nachricht: Referenznummer 204, Teil 1 von 2)
utf8Forciert die Erkennung als UTF8 Zeichensatz und überschreibt die automatische Erkennung der API1
0
ttlGibt die Validity Period (Gültigkeitsdauer) der SMS in Millisekunden an. Nur bei Direct SMS verfügbar86400000 24h (Default)
300000 5min
detailsZeigt zahlreiche Details zur verschickten SMS an. Praktisch zum Debugging1
0
return_msg_idIst dieser Parameter gesetzt, wird in in der zweiten Zeile nach dem Statuscode die ID der SMS ausgegeben1 = ID zurückgeben
0 = Nur Statuscode (Standard)
labelSetzen Sie optional für jede SMS ein eigenes Label, um diese in Ihren Statistiken zuordnen zu können. Erlaubte Zeichen: a-z, A-Z, 0-9, .-_@Kunde_1
Marketing_22.02.2018
Splittest17
jsonDie Ausgabe erfolgt detaillierter im JSON Format1 – Ausgabe als JSON
performance_trackingKlick und Performance Tracking für im SMS Text gefundene URLs aktivieren1 – Performance Tracking aktiv
0 – Performance Tracking deaktiviert (Standard)

Rückgabe

Als Antwort auf Ihren Request erhalten Sie einen numerischen Rückgabewert und die Msg ID der gesendeten Nachricht. Mittels der ID können Sie später z.B. Statusberichte zuordnen. Bei Angabe des Parameters details erhalten Sie zahlreiche weitere Informationen – unter anderem den Guthabenstand und das verbuchte Guthaben. Die Rückgabe erfolgt als einfacher Text wobei jeder Wert jeweils getrennt durch \n in einer Zeile steht.

Folgende Rückgabecodes sind möglich:

StatuscodeBeschreibung
100SMS wurde erfolgreich verschickt
101Versand an mindestens einen Empfänger fehlgeschlagen
201Absender ungültig. Erlaubt sind max 11 alphanumerische oder 16 numerische Zeichen.
202Empfängernummer ungültig
301Variable to nicht gesetzt
304Variable type nicht gesetzt
305Variable text nicht gesetzt
400type ungültig. Siehe erlaubte Werte oben.
401Variable text ist zu lang
402Reloadsperre – diese SMS wurde bereits innerhalb der letzten 180 Sekunden verschickt
403Maximales Limit pro Tag für diese Nummer erreicht.
500Zu wenig Guthaben vorhanden.
600Carrier Zustellung misslungen
700Unbekannter Fehler
900Authentifizierung ist fehlgeschlagen. Bitte Benutzer und Api Key prüfen
902http API für diesen Account deaktiviert
903Server IP ist falsch
11SMS Carrier temporär nicht verfügbar

Zeichensatz

SMS unterstützen einen ganz eigenen 7-bit Zeichensatz (GSM 0338), der einige UTF-8 Zeichen wie z.B. deutsche Umlaute enthält, nicht aber z.B. ó oder chinesische, arabische, kyrillische Zeichen etc. Hierzu müsste eine unicode SMS versendet werden, welche mit 8 Bit kodiert ist und daher nur 70 Zeichen Platz je SMS benötigt. Eine Unicode SMS mit z.B. 120 Zeichen würde also das doppelte einer normalen SMS kosten.

Hier erfahren Sie mehr zu den Spezifikationen des SMS Zeichensatz und können die komplette Liste der erlaubten Zeichen in normalen (nicht unicode) SMS einsehen: https://en.wikipedia.org/wiki/GSM_03.38#GSM_7-bit_default_alphabet_and_extension_table_of_3GPP_TS_23.038_.2F_GSM_03.38.

Beispiele

1. Einfacher SMS Versand

Der Aufruf folgender URL sendet eine SMS mit dem Inhalt meine erste nachricht als Direct SMS mit dem Absender sms77.de an die Rufnummer 49160999999999:

Request:
https://gateway.sms77.io/api/sms?p=api-key&to=49160999999999&text=meine%20erste%20nachricht&type=direct&from=sms77.de&return_msg_id=1

Response:
100
123456789

Die SMS wurde erfolgreich übertragen – die Msg ID lautet 123456789.

2. Debugmodus mit detaillierter Ausgabe

Dieser Aufruf sendet aufgrund des gesetzten Parameters debug keine SMS, zeigt aber zahlreiche Details zu der Nachricht.

Request: http://gateway.sms77.io/api/sms?p=api-key&to=Gruppe1&type=direct&text=Test+SMS&from=SMS&flash=0&details=1&debug=1

Response:
100
Verbucht: 0
Preis: 0.089
Guthaben: 27.38
Text: Test SMS
SMS-Typ: direct
Flash SMS: off
Encoding: ASCII
GSM0338: true
Debug: true

Was this article helpful to you? Yes 9 No 2
Menü