ActiveX component για αποστολή SMS

Το ActiveX component που σας προσφέρουμε, σας επιστρέπει να χρησιμοποιείτε την πλατφόρμα μας (αποστολή SMS, get SMS status, κοκ.) μέσα από οποιαδήποτε εφαρμογή Windows που μπορεί να χρησιμοποιήσει ActiveX.

Προϋπόθεση να τρέξει είναι να υπάρχει εγκατεστημένο (αν όχι, το setup του το κατεβάζει και το κάνει εγκατάσταση) το .net Framework 4.6.1.

Μπορείτε να κατεβάσετε το component κάνοντας click στο παρακάτω εικονίδιο:

LiveAllActiveXHelperSetup_1.0.1.exe

Τεχνικά Χαρακτηριστικά

Για να μπορέσετε να καλέσετε τις μεθόδους του component θα πρέπει πρώτα να δημιουργήσετε το object καλώντας το όνομα που έχει γίνει ήδη registered (θα πρέπει πρώτα να τρέξετε το setup) στο σύστημα των Windows.
Το όνομα του component είναι το:

Terracom.Liveall.SMSHelper

Υπάρχουν οι εξής μέθοδοι που μπορείτε να καλέσετε από την εφαρμογή σας μέσω ActiveX:

    • string SendSingleSms(string apitoken, string senderid, string destination, string message, int price_category = 0);
    • string SendMultiSms(string apitoken, string senderid, string destinations, string messages, int price_category = 0);
    • string CheckSmsStatus(string apitoken, string sms_ids);

Με την SendSingleSms() μπορούμε να στείλουμε μόνο ένα SMS σε ένα παραλήπτη.

apitoken	είναι η συμβολοσειρά που βρίσκουμε εδώ
senderid	είναι το όνομα αποστολέα (Προσοχή! Επιτρεπόμενο μήκος μέχρι 11 λατινικοί χαρακτήρες)
destination	είναι ο αριθμός παραλήπτη. Να προτιμάτε ο αριθμός να έχει και τον κωδικό χώρας. Αναγνωρίζεται αυτόματα ο Ελληνικός και ο Κυπριακός αριθμός κινητού
message	είναι το κείμενο του μηνύματος
price_category	είναι μία προεραιτική μεταβλητή που καθορίζει την τιμολογιακή κατηγορία (normal ή low cost) που θέλουμε να χρησιμοποιήσουμε. Αν δεν την ορίσουμε, το σύστημα θα στείλει με normal cost. Οι αποδεκτές τιμές είναι 0: Normal cost & 1: Low cost

Με την SendMultiSms() μπορούμε να στείλουμε σε περισσότερους από 1 παραλήπτες, συν ότι μπορούμε να ορίσουμε διαφορετικό κείμενο για κάθε αριθμό.

Πως λειτουργεί; Η μέθοδος αυτή λειτουργεί ακριβώς όπως και η SendSingleSms(), αλλά στη παράμετρο destinations μπορούμε να ορίσουμε περισσότερους από έναν αριθμούς. Η μεταβλητή είναι τύπου string, οπότε για να χωρίσουμε τους αριθμούς χρησιμοποιούμε το χαρακτήρα | σαν delimiter.
πχ.:

306912345678|306912345677|306912345676|306912345675|306912345674

Το ίδιο ισχύει και για τη μεταβλητή messages σε περίπτωση που θέλουμε να στείλουμε διαφορετικό κείμενο σε κάθε παραλήπτη. Χωρίζουμε το κάθε κείμενο επίσης με τον χαρακτήρα | Αν αυτό δεν το θέλουμε, μπορούμε απλώς να βάλουμε ένα κείμενο (χωρίς να έχει τον χαρακτήρα | που μέσα του) και το ίδιο κείμενο θα πάει σε όλους τους προορισμούς.

Η μέθοδος αυτή επιστρέφει είτε με μήνυμα σφάλματος ή επιτυχία. Το result είναι το ίδιο όπως περιγράφεται και στη σελίδα με το Simple HTTP API.

Η μέθοδος CheckSmsStatus() μας βοηθά να τσεκάρουμε το status καποιου(ων) μηνυμάτων, δίνοντας το(α) id τους.

Χρησιμοποιούμε το api token μας, που είναι μοναδικό για κάθε χρήστη και με την παράμετρο sms_ids τροφοδοτούμε τη μέθοδο με τα message ids χωρισμένα με τον delimiter |
Το αποτέλεσμα αυτής της κλήσης θα είναι κάτι σαν το παρακάτω παράδειγμα (είναι αποτελέσματα από 2 αποστολές - smsids: 29394701 & 29394702):

29394701:1505463807:1505463812:306912345678:200000:Delivered:1:0.0379|29394702:1505463807:1505463812:306912345111:200000:Delivered:1:0.0379

Παρακάτω φαίνεται η επεξήγηση των πεδίων:

SMS_ID:SubmittedON:LastStatusTime:Destination:StatusCode:StatusMessage:SMSParts:ChargeAmount

SMS_ID:	Το sms id μηνύματος
SubmittedON:	Ημερομηνία/ώρα καταχώρησης
LastStatusTime:	Ημερομηνία/ώρα της τελευταίας αλλαγής κατάστασης του μηνύματος
Destination:	Παραλήπτης
StatusCode:	(integer) Κωδικός status
StatusMessage:	(string) Λεκτικό status
SMSParts:	Πόσα SMS έχουν καταναλωθεί γι' αυτό το μήνυμα
ChargeAmount	Χρέωση του μηνύματος

Παραδείγματα χρήσης

Το ActiveX είναι ένα πολύ χρήσιμο εργαλείο για τους προγραμματιστές των Windows και τους επιτρέπει να συνδέουν / χρησιμοποιούν ετερογενείς εφαρμογές μεταξύ τους, δίνοντάς τους τη δυνατότητα να καλούν μεθόδους από κάποια 3η εφαρμογή μέσα από το πρόγραμμά τους.

Μπορούμε δηλαδή μέσω πχ. από ένα JScript (γράφοντας Javascript) αρχείο να στείλουμε SMS πολύ εύκολα από την γραμμή εντολών των Windows, όπως φαίνεται παρακάτω:

// SMS send-out from javascript
    var laaxcomp = new ActiveXObject("Terracom.Liveall.SMSHelper");
    var res = laaxcomp.SendSingleSms("MYAPITOKEN", "mySenderid", "306912345678", "This is my test ActiveX SMS text!");
    WScript.Echo(res);

Το ίδιο ισχύει και για Vbscript:

'SMS send-out from vbscript
    Dim laaxcomp
    Dim res
    Set laaxcomp = CreateObject("Terracom.Liveall.SMSHelper")
    res = laaxcomp.SendSingleSms("MYAPITOKEN", "mySenderid", "306912345678", "This is my test ActiveX SMS text!")
    WScript.Echo(res)

Επίσης μέσα από το Office (Excel, Word, Access), μπορούμε να δημιουργήσουμε μία function που θα καλούμε από κάποιο Macro ή κάποια φόρμα Access και θα στέλνουμε SMS. Παρακάτω φαίνεται μια πολύ απλή χρήση του ActiveX:

Function SendSmsFromLiveallActiveX()
    'SMS send-out from VBA
    Dim laaxcomp As Object
    Dim res As String
    Set laaxcomp = CreateObject("Terracom.Liveall.SMSHelper")
    
    res = laaxcomp.SendSingleSms("MYAPITOKEN", "mySenderid", "306912345678", "This is my test ActiveX SMS text!")
    
    MsgBox res
End Function