SMS in eigenen Anwendungen erstellen und versenden (SMS API) Massen SMS, Gruppen SMS, Einzel SMS versenden, SMS Versandsoftware SMSout

<< Zurück zu SMSout.de

SMS in eigenen Anwendungen erstellen und versenden

Für den Versand von Einzel-SMS in eigenen Anwendungen, entwickelt z.B. in Borland Delphi, PHP, C++, Java usw., ist ein einfacher HTTP-Aufruf notwendig. Es ist ebenfalls möglich über die Mail2SMS-Schnittstelle Einzel-SMS per E-Mail zu versenden.

Guthaben und aktuelles SMS-Paket abfragen

Mit Hilfe des Scripts sendsms.php kann ebenfalls das eigene Guthaben abgefragt werden. Infos dazu finden Sie am Ende dieser Seite.

Verwendung von Sonderzeichen

Beachten Sie bitte folgende Regeln zur Verwendung von Sonderzeichen:

Eine SMS sollte immer mit einem Buchstaben (A-Z, a-Z) oder Ziffer (0-9) beginnen, auf keinen Fall Sonderzeichen oder Umlaute verwenden.
Verzichten Sie so weit es geht auf Sonderzeichen, da diese nicht auf allen Handys korrekt dargestellt werden. Empfohlen ist die Verwendung der Zeichen A-Z 0-9 , + _ : . z.B. die Zeichen <> {[]}²³§%$& @ € sind problematisch.
Die Verwendung von Hochkommas ' oder ` ´ ist nicht gestattet, diese werden aus Sicherheitsgründen entfernt.
Alle übergebenen Zeichen müssen iso-8859-1 codiert übergeben werden, nicht im Unicode/UTF-8-Format. Werden Zeichen im Unicode/UTF-8-Format übergeben, dann werden Umlaute/Sonderzeichen mit jeweils 2 Zeichen an das Mobiltelefon übermittelt, dies kann die Länge der SMS erheblich beeinflussen und führt zu Problemen beim Lesen der SMS durch den Empfänger. Ist eine Umwandlung UTF-8 nach iso-8859-1 programmiertechnisch nicht möglich, dann verwenden Sie das spezielle Script sendsmsutf8.php, dieses wandelt alle UTF-8 codierten Zeichen in iso-8859-1 vor dem Versand um.

Der HTTP-Aufruf

http://www.smsout.de/client/sendsms.php?Username=<smsout-username>&Password=<smsout-password>&SMSTo=<rufnummer oder mehrere rufnummern mit semikolon(;) getrennt>&SMSType=<smstype>&SMSText=<smstext 160 Zeichen urlencoded>

oder der Aufruf über https://

https://www.smsout.de/client/sendsms.php?Username=<smsout-username>&Password=<smsout-password>&SMSTo=<rufnummer oder mehrere rufnummern mit semikolon(;) getrennt>&SMSType=<smstype>&SMSText=<smstext 160 Zeichen urlencoded>

die Parameter

<smsout-username>	Geben Sie den SMSout-Benutzernamen an.
<smsout-password>	Geben Sie das SMSout-Passwort an. Hinweis: Sollte das Passwort Sonderzeichen enthalten, dann müssen diese urlencoded übergeben werden.
<rufnummer oder mehrere rufnummern mit semikolon(;) getrennt>	Geben Sie die Mobilfunknummer in der Form 0049<handyvorwahl><rufnummer> oder <handyvorwahl><rufnummer> an, nicht in der Form +49 oder 0049. Z.B. 00491791234567 oder 01791234567 Mehrere Rufnummern Mehrere Rufnummern können mit Semikolon (;) getrennt angegeben werden. Alle angegebenen Rufnummern erhalten den gleichen SMS-Text. Hinweis: Eine URL sollte nicht mehr als 255 Zeichen umfassen, daher sollte der Aufruf immer per HTTP Post erfolgen, ansonsten könnte Angaben nicht korrekt übermittelt werden.. Bei Angabe mehrerer Rufnummern fallen entsprechend die Kosten pro SMS für jede angegebene Rufnummer an.
<smstype>	Folgende SMS-Typen können genutzt werden: V1 um eine SMS ohne eigenem Absender zu versenden. V2 um eine SMS ohne eigenem Absender aber mit Antwort-Option zu versenden. V3 um eine SMS mit eigenem Absender oder Absender-Text zu versenden. V4 um eine "LowCost" SMS ohne eigenem Absender zu versenden. V5 um eine SMS ohne eigenem Absender mit Versandstatusbericht zu versenden. V6 um eine "Maxi"-SMS mit bis zu 1560 Zeichen zu versenden, der Versand muss wegen der Länge des Texts per HTTP POST erfolgen.
<smstext urlencoded>	Der Text der SMS muss urlencoded angegeben werden, siehe PHP Funktion urlencode(). Bei den SMS-Typen V1 bis V5 darf der SMS-Text die Länge von 160 Zeichen nicht überschreiten. Beim Typ V6 sind bis 1560 Zeichen zulässig, wobei der Versand per HTTP POST erfolgen muss. Mit Anzahl Zeichen ist immer der reine Text gemeint, nicht der urlencodede Text. Alle SMS-Texte müssen mit der Zeichencodierung iso-8859-1 übergeben werden, verwenden Sie keine Unicode/UTF-8-Codierung für den SMS-Text.
Optionaler Parameter
&SendDateTime=<senddatetime>	Fügen Sie den optionalen Parameter &SendDateTime=<senddatetime> hinzu um die SMS zu einem bestimmten Zeitpunkt zu versenden. Das Datum und Uhrzeit muss im Format JJJJ-MM-TT HH:NN:SS übergeben werden. JJJJ=Jahr 4stellig MM=Monat 2stellig TT=Tag 2stellig HH=Stunde 2stellig NN=Minute 2stellig SS=Sekunde 2stellig
&AltDisplayText=	Nur bei den SMS-Typen V3 und V6 (SMS mit eigenem Absender oder Absender-Text, bzw. Maxi-SMS). Sie können einen 11stelligen Text angeben, der als Absender verwendet werden soll. Der Text darf nur die Buchstaben A-Z, die Ziffern 0-9 und den Punkt (.) enthalten. Wird die Angabe AltDisplayText= weggelassen, dann wird entweder die im SMSout-Kundenbereich hinterlegte Mobilfunknummer oder der hinterlegte 11stellige Text verwendet.
&SMSCampaignName=	Optional kann der Name einer SMS-Kampagne, url-encoded, angegeben werden. Im SMSout-Kundenbereich können Sie in der Statistik eine Aufstellung der versendeten SMS und angefallene Kosten für jede SMS-Kampagne abrufen. Der Name der SMS-Kampagne sollte keine Umlaute/Sonderzeichen enthalten, werden Umlaute/Sonderzeichen angegeben, dann müssen diese iso-8859-1 codiert übergeben werden.

Rückgabe-Werte

Fehler bei Angabe einer Rufnummer:

Prüfen Sie einfach ob in der zurückgegebenen Zeichenkette das Wort "ERROR" vorkommt, in diesem Fall wurde die SMS nicht versendet. Im Falle eines fehlerhaften Versands kann der zusätzliche Wert hinter dem Wort ErrorText: ausgewertet werden, dieser gibt den aufgetretenen Fehler an. z.B.

Return: ERROR
ErrorCode: 9999
ErrorText: Login fehlgeschlagen

Fehler bei Angabe mehrerer Rufnummern:

Prüfen Sie einfach ob in der zurückgegebenen Zeichenkette das Wort "ERROR" vorkommt, in diesem Fall wurden eine oder mehrere SMS nicht versendet. Im Falle eines fehlerhaften Versands kann der zusätzliche Wert hinter dem Wort ErrorText: ausgewertet werden, dieser gibt den aufgetretenen Fehler an. z.B.

Return: ERROR
ErrorCode: 9985
ErrorText: SMS-Text fehlt.
SMSSentCount: Anzahl der erfolgreich versendeten SMS bevor der Fehler auftrat
Nur während des eigentlichen Sendeversuchs:
LastTriedCellNo: Mobilfunknummer, bei welcher der Fehler auftrat, an diese Mobilfunknummer und die weiteren Nummern wurde keine SMS gesendet.

Wurde eine SMS versendet, wird OK zurückgegeben. Zusätzlich werden die Kosten der SMS zurückgegeben, z.B.

Return: OK
ErrorCode: 0
CustomerId: Kundennummer
SMSCosts: Kosten der SMS brutto (mit MwSt.),
SMSCostsWithOutVAT: Kosten der SMS netto (ohne MwSt.),
SMSSentCount: Anzahl der versendeten SMS, nur bei Angabe mehrerer Rufnummern
SessionId: diese Angabe ist leer

Beispiel-URLs

Versand einer SMS ohne Absender an die Mobilfunknummer 01791234567 und SMS-Text Das ist eine Test SMS.

http://www.smsout.de/client/sendsms.php?Username=smsout-username&Password=smsout-password&SMSTo=01791234567&SMSType=V1&SMSText=Das+ist+eine+Test+SMS

Versand mehrerer SMS ohne Absender an die Mobilfunknummern 01791234567 und 01791234568 mit dem SMS-Text Das ist eine Test SMS.

http://www.smsout.de/client/sendsms.php?Username=smsout-username&Password=smsout-password&SMSTo=01791234567;01791234568&SMSType=V1&SMSText=Das+ist+eine+Test+SMS

Beispiel Versand einer SMS mit eigenem Absender and die Mobilfunknummer 01791234567 und SMS-Text Das ist eine Test SMS.

http://www.smsout.de/client/sendsms.php?Username=smsout-username&Password=smsout-password&SMSTo=01791234567&SMSType=V3&SMSText=Das+ist+eine+Test+SMS

Beispiel Versand einer SMS mit eigenem Absender aber mit dem Absender-Text SMSout_SMS and die Mobilfunknummer 01791234567 und SMS-Text Das ist eine Test SMS.

http://www.smsout.de/client/sendsms.php?Username=smsout-username&Password=smsout-password&SMSTo=01791234567&SMSType=V3&AltDisplayText=SMSout_SMS&SMSText=Das+ist+eine+Test+SMS

Einfaches Beispiel in Delphi 7 mit den Indy-Internet-Komponenten (Indy Komponenten)

// Funktion für URLEncode
function UrlEncode(Src : String) : String;
var
I : Integer;
begin
Result := '';
For I := 1 to Length(Src) Do
begin
If Src[I] = '+' then
Result := Result + '%' + IntToHex(ord(Src[I]), 2)
else
If Src[I] = ' ' then
Result := Result + '+'
else
If Src[I] in ['a'..'z', 'A'..'Z', '0'..'9'] Then
Result := Result + Src[I]
else
If (Ord(Src[I]) < 32) or (Ord(Src[I]) >= 127) Or (Src[I] in [':', '/', '\', '<', '>', '?', ';', '=', '&']) Then
Result := Result + '%' + IntToHex(ord(Src[I]), 2)
else
Result := Result + Src [I]
end;
end;

// SMSTyp darf nur 1, 2, 3, 4, 5 sein.
// SMSText maximal 160 Zeichen
// Indy HTTP Komponente wird für den SMS-Versand genutzt

// Für SMSTyp 6 muss der Aufruf mit HTTP.Post() ausgeführt werden

function SendSMS(const SMSoutUsername, SMSoutPassword: String; const SMSTo: String; const SMSTyp: Integer; const SMSText: String): String;
Var
HTTP : TIdHTTP;

begin

   HTTP := TIdHTTP.Create(NIL);
   try
    Data := Format('?Username=%s&Password=%s&SMSTo=%s&SMSType=V%d&SMSText=%s', [SMSoutUsername,
                             UrlEncode(SMSoutPassword), SMSTo, SMSTyp, UrlEncode(SMSText)] );

Result := HTTP.Get('http://www.smsout.de/client/sendsms.php' + Data)
finally

HTTP.Free;
end;
end;

// Testen

var
S: String;

S := SendSMS('username', 'password', '01791234567', 1, 'Das ist eine Test-SMS');

If Pos('ERROR', S) > 0 Then
ShowMessage('SMS-Versand fehlgeschlagen, Fehler: ' + S)
else
ShowMessage('Die SMS wurde versendet, Rückgabe: ' + S);

Beispiel in PHP 4/5

<?php

# Zugangsdaten
$Username = "smsout-username";
$Password = urlencode("smsout-passwort");

# Zielrufnummer korrekt angeben!
$SMSTo = "01791234";

# Text der SMS, maximal 160 Zeichen
# beim Typ V6 bis zu 1560 Zeichen, wobei der Aufruf beim Typ 6 per HTTP Post erfolgen muss
$SMSText = urlencode("Das ist eine Test SMS");

# SMS ohne eigenem Absender versenden, andere Werte V2, V3, V4, V5
$SMSType = "V1";

# Aufruf für den Versand der SMS
# Rückgabe ein Array mit dem Versandstatus
$result = file("http://www.smsout.de/client/sendsms.php?Username=$Username&Password=$Password&SMSTo=$SMSTo&SMSType=$SMSType&SMSText=$SMSText");

if(is_array($result)) # falls es kein array ist, dann einfach so ausgeben
print join("<br>", $result);
else
print $result;

?>

Guthaben und aktuelles SMS-Paket abfragen

Mit dem Aufruf

http://www.smsout.de/client/sendsms.php?Username=<smsout-username>&Password=<smsout-password>&GetAccountData=1

oder der Aufruf über https://

https://www.smsout.de/client/sendsms.php?Username=<smsout-username>&Password=<smsout-password>&GetAccountData=1

kann das Guthaben und das aktuelle SMS-Paket abgefragt werden.

Als Rückgabewert bei korrekter Angabe von Benutzername/Passwort erhalten Sie diese Daten:

Return: OK
ErrorCode: 0
CustomerId: Kundennummer
AvailMoney: Verfügbares Guthaben mit MwSt.
AvailMoneyWithOutVAT: Verfügbares Guthaben ohne MwSt.
SMSPackageName: Aktuelles SMS-Paket
SessionId:

SMS mit UTF-8 codierten Zeichen

Anstatt des Scripts sendsms.php verwenden Sie das Script sendsmsutf8.php. Dieses Script wandelt alle UTF-8 codierten Zeichen vor dem SMS-Versand in iso-8859-1 codierte Zeichen um. Sind Zeichen nicht in iso-8859-1 umwandelbar, dann werden ? im SMS-Text enthalten sein.
Verwenden Sie das spezielle Script sendsmsutf8.php nur, wenn eine Umwandlung in iso-8859-1 nicht oder nur schwer möglich ist z.B. in JavaScript auf utf-8 codierten Webseiten oder in Smartphone Apps (SMSout App für Android).

Weitere Informationen finden Sie im Internet SMS-API.