ActiveX component για αποστολή SMS
Το ActiveX component που σας προσφέρουμε, σας επιτρέπει να χρησιμοποιείτε την πλατφόρμα μας (αποστολή SMS, get SMS status, κοκ.) μέσα από οποιαδήποτε εφαρμογή Windows που μπορεί να χρησιμοποιήσει ActiveX.
Ενσωμάτωση του LiveAll.eu σε εφαρμογές Windows
Το ActiveX component που σας προσφέρουμε, σας επιτρέπει να χρησιμοποιείτε την πλατφόρμα μας (αποστολή SMS, get SMS status, κοκ.) μέσα από οποιαδήποτε εφαρμογή Windows που μπορεί να χρησιμοποιήσει ActiveX.
Προϋπόθεση για τρέξει είναι να υπάρχει εγκατεστημένο (αν όχι, το setup που το κατεβάζει και το κάνει εγκατάσταση) το .net Framework 4.6.1.
Τεχνικά Χαρακτηριστικά
01 Δημιουργία του ActiveX object
Για να μπορέσετε να καλέσετε τις μεθόδους του 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);02 SendSingleSms()
Με την SendSingleSms() μπορούμε να στείλουμε μόνο ένα SMS σε ένα παραλήπτη.
| apitoken | είναι η συμβολοσειρά που βρίσκουμε εδώ |
|---|---|
| senderid | είναι το όνομα αποστολέα (Προσοχή! Επιτρεπόμενο μήκος μέχρι 11 λατινικοί χαρακτήρες) |
| destination | είναι ο αριθμός παραλήπτη. Να προτιμάτε ο αριθμός να έχει και τον κωδικό χώρας. Αναγνωρίζεται αυτόματα ο Ελληνικός και ο Κυπριακός αριθμός κινητού |
| message | είναι το κείμενο του μηνύματος |
| price_category | είναι μία προαιρετική μεταβλητή που καθορίζει την τιμολογιακή κατηγορία (normal ή low cost) που θέλουμε να χρησιμοποιήσουμε. Αν δεν την ορίσουμε, το σύστημα θα στείλει με normal cost. Οι αποδεκτές τιμές είναι 0: Normal cost & 1: Low cost |
03 SendMultiSms()
Με την SendMultiSms() μπορούμε να στείλουμε σε περισσότερους από 1 παραλήπτες, συν ότι μπορούμε να ορίσουμε διαφορετικό κείμενο για κάθε αριθμό.
Πως λειτουργεί; Η μέθοδος αυτή λειτουργεί ακριβώς όπως και η SendSingleSms(), αλλά στη παράμετρο destinations μπορούμε να ορίσουμε περισσότερους από έναν αριθμούς. Η μεταβλητή είναι τύπου string, οπότε για να χωρίσουμε τους αριθμούς χρησιμοποιούμε το χαρακτήρα | σαν delimiter. πχ.:
306912345678|306912345677|306912345676|306912345675|306912345674Το ίδιο ισχύει και για τη μεταβλητή messages σε περίπτωση που θέλουμε να στείλουμε διαφορετικό κείμενο σε κάθε παραλήπτη. Χωρίζουμε το κάθε κείμενο επίσης με τον χαρακτήρα | Αν αυτό δεν το θέλουμε, μπορούμε απλώς να βάλουμε ένα κείμενο (χωρίς να έχει τον χαρακτήρα | που μέσα του) και το ίδιο κείμενο θα πάει σε όλους τους προορισμούς.
Η μέθοδος αυτή επιστρέφει είτε με μήνυμα σφάλματος ή επιτυχία. Το result είναι το ίδιο όπως περιγράφεται και στη σελίδα με το Simple HTTP API.
04 CheckSmsStatus()
Η μέθοδος 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Η μέθοδος αυτή επιστρέφει είτε με μήνυμα σφάλματος ή επιτυχία. Το result είναι το ίδιο όπως περιγράφεται και στη σελίδα με το Simple HTTP API.
Παρακάτω φαίνεται η επεξήγηση των πεδίων:
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η εφαρμογή μέσα από το πρόγραμμά τους.
JavaScript
Μπορούμε δηλαδή μέσω πχ. από ένα 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
Το ίδιο ισχύει και για 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)Microsoft Office
Επίσης μέσα από το 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Ξεκινήστε την αποστολή SMS μέσω ActiveX
Κατεβάστε το ActiveX component του LiveAll.eu και συνδέστε τη μαζική αποστολή SMS με τις εφαρμογές Windows που χρησιμοποιείτε.
Λήψη ActiveX ComponentΔείτε ακόμη
Υπηρεσίες Liveall.eu
