Kako poslati SMS iz Perla

Najjednostavniji način za slanje SMS-a iz Perla je korištenje ugrađenog HTTP/Rest SMS API-ja Ozeki SMS Gatewaya. Kada koristite ovaj API, slati ćete SMS poruke slanjem HTTP Post zahtjeva SMS gatewayu. HTTP Post zahtjev će sadržavati poruku formatiranu u json formatu. SMS gateway će poslati ovaj SMS na telefonski broj primatelja i vratit će HTTP 200 OK odgovor na vaš zahtjev.

kako poslati sms iz perla
Slika 1 - Kako poslati SMS iz Perla

Perl kod za slanje SMS-a na mobilni telefon

Primjer Perl SMS koda ispod pokazuje kako možete poslati SMS koristeći http rest sms api Ozeki SMS Gatewaya koristeći Perl Ozeki.Libs.Rest biblioteku. Ova biblioteka vam je dostupna besplatno, a možete je koristiti i mijenjati u bilo kojem od vaših projekata.

SendSms.pl
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
use Ozeki::Libs::Rest::Configuration;
use Ozeki::Libs::Rest::MessageApi;
use Ozeki::Libs::Rest::Message;
 
my $configuration = new Ozeki::Libs::Rest::Configuration();
$configuration->{ Username } = "http_user";
$configuration->{ Password } = "qwe123";
$configuration->{ ApiUrl } = "http://127.0.0.1:9509/api";
 
my $msg = new Ozeki::Libs::Rest::Message();
$msg->{ ToAddress } = "+36201111111";
$msg->{ Text } = "Pozdrav svijete!";
 
my $api = new Ozeki::Libs::Rest::MessageApi($configuration);
 
my $result = $api->Send($msg);
 
print($result->stringify);
     

Kako koristiti Perl SMS primjer:

Ovaj Perl SMS primjer može se koristiti u bilo kojoj Perl aplikaciji. Da biste ga koristili, morate dodati Ozeki.Libs.Rest biblioteku u svoj projekt. Nakon što je biblioteka dodana, morate staviti using Ozeki.Libs.Rest; direktivu u zaglavlje vašeg Perl izvornog koda. To će vam omogućiti korištenje klasa koje pruža Ozeki.Libs.Rest biblioteka. Možete koristiti klasu Message za kreiranje SMS-a. Možete koristiti klasu MessageApi za slanje SMS-a SMS gatewayu. SMS gateway će proslijediti vašu poruku mobilnoj mreži bilo putem bežične veze ili putem interneta.

Preuzmite SendSms.pl

Izvorni kod objašnjen u ovom članku može se preuzeti, koristiti i mijenjati besplatno.
Preuzmi: SendSms.pl.zip (76.0Kb)

Što se nalazi u SendSms.pl.zip datoteci?

SendSms.pl.zip datoteka sadrži Ozeki.Libs.Rest biblioteku, koja vam daje sve alate potrebne za slanje i primanje SMS poruka. Također ćete pronaći SendSms.pl datoteku u zipu, koja sadrži primjer koda koji pokazuje kako poslati SMS. Ovaj primjer koda je naveden ispod.

Slika 2 - Što se nalazi unutar SendSms.pl.zip

Ovisnosti

Da biste koristili Ozeki::Libs::Rest biblioteku, morate instalirati nekoliko modula:

Ubuntu

1
2
3
4
5
6
$ sudo apt-get install libdatetime-perl
$ cpan
$ install JSON
$ install UUID::Generator::PurePerl
$ install UUID::Object
     

Kod 1 - Kako instalirati ovisnosti na Linuxu

Kako instalirati Perl ovisnosti na Linuxu (Video tutorijal)

U ovom videu pokazujemo vam kako instalirati ovisnosti Perla na Linux OS. Video će započeti otvaranjem terminala i završiti s instaliranim ovisnostima. Video je dug samo 1:10, ali objašnjava proces na detaljan način. Ako pogledate cijeli video, nećete imati problema s ponavljanjem koraka.

Video 1 - Kako instalirati Perl ovisnosti na Linuxu (Video tutorijal)

Windows

1
2
3
4
5
cpanm DateTime
cpanm UUID::Generator::PurePerl
cpanm UUID::Object
cpanm JSON
     

Kod 2 - Kako instalirati ovisnosti na Windowsu

Kako instalirati Perl ovisnosti na Windowsu (Video tutorijal)

U ovom videu pokazujemo vam kako instalirati ovisnosti Perla na Windows OS. Video će započeti otvaranjem naredbenog retka i završiti s instaliranim ovisnostima. Video je dug samo 46 sekundi, ali objašnjava proces na detaljan način. Proces je jednostavan za izvesti, pa uz pomoć ovog videa nećete imati problema s praćenjem koraka.

Video 2 - Kako instalirati Perl ovisnosti na Windowsu (Video tutorijal)

Kako poslati SMS iz Perla (Jednostavne smjernice)

Da biste poslali SMS iz Perla:

  1. Instalirajte HTTP API korisnika
  2. Omogućite bilježenje komunikacijskih događaja na kartici Napredno
  3. Preuzmite i raspakirajte SendSms.pl.zip datoteku
  4. Otvorite sendsms.pl datoteku u bilo kojem tekstualnom editoru
  5. Pokrenite Ozeki SMS Gateway aplikaciju
  6. Pokrenite SendSms.pl Perl kod u naredbenom retku
  7. Provjerite zapisnike kako biste vidjeli je li SMS poslan

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli slati SMS iz Perla, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu gdje razvijate svoj Perl kod u Windows Notepadu ili Visual Studio Codeu. Nakon instalacije, sljedeći korak je povezivanje Ozeki SMS Gatewaya s mobilnom mrežom. Možete poslati testnu SMS poruku iz Ozeki GUI-a kako biste potvrdili da vaša mobilna mrežna veza radi. Posljednji korak za pripremu vašeg okruženja je kreiranje HTTP SMS API korisničkog računa. Kreirajte korisnika s korisničkim imenom "http_user" i lozinkom "qwe123" kako bi primjer radio bez izmjena.

Nakon što je okruženje postavljeno, možete pokrenuti svoj Perl kod.

HTTP API URL za slanje SMS-a iz Perla

Da biste poslali SMS iz Perla, vaš Perl će morati poslati HTTP zahtjev SMS gatewayu. API URL je prikazan u nastavku. Imajte na umu da IP adresa (127.0.0.1) treba biti zamijenjena IP adresom vašeg SMS gatewaya. Ako je Ozeki SMS Gateway instaliran na istom računalu gdje se pokreće Perl SMS aplikacija, ovo može biti 127.0.0.1. Ako je instaliran na drugom računalu, treba biti IP adresa tog računala.

1
2
http://127.0.0.1:9509/api?action=rest
     

HTTP autentifikacija za slanje SMS-a iz Perla

Da biste autentificirali Perl SMS klijent, morate poslati korisničko ime i lozinku u base64 kodiranom stringu na poslužitelj u HTTP zahtjevu. Korišteni format je: base64(korisničko_ime+":"+lozinka). U Perlu možete koristiti sljedeći kod za ovu enkodaciju:

1
2
3
4
5
my ($self, $Username, $Password) = @_;
my $Username_Password = "${Username}:${Password}";
my $Username_Password_encoded = encode_base64($Username_Password);
return "Basic ${Username_Password_encoded}";
     

Na primjer, ako enkodirate korisničko ime 'http_user' i lozinku 'qwe123', dobit ćete sljedeći base64 kodirani string: aHR0cF91c2VyOnF3ZTEyMw==. Za slanje

HTTP zaglavlje zahtjeva za slanje SMS-a iz Perla

Da biste poslali SMS poruke, morate uključiti sljedeće retke kao zaglavlja u HTTP zahtjevu. Imajte na umu da uključujemo content type i Authorization zaglavlje.

1
2
3
Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
     

HTTP zahtjev za slanje SMS-a iz Perla

Da biste poslali SMS, vaša Perl aplikacija će poslati HTTP zahtjev sličan onome u nastavku. Imajte na umu da ovaj zahtjev sadrži dio HTTP zaglavlja i dio HTTP tijela. HTTP tijelo je JSON kodirani podatkovni string. Sadrži broj primatelja i tekst poruke.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
POST /api?action=sendmsg HTTP/1.1
Connection: TE, close
Content-Length: 341
Content-Type: application/json; charset=utf8
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
Te: deflate,gzip;q=0.3
User-Agent: libwww-perl/6.52
 
{
    "messages": [
        {
            "message_id": "fa32293f-db00-11eb-804d-ffacbeab4160",
            "to_address": "+36201111111",
            "text": "Hello world!",
            "create_date": "2021-07-02T06:44:40",
            "valid_until": "2021-07-09T06:44:40",
            "time_to_send": "2021-07-02T06:44:40",
            "submit_report_requested": true,
            "delivery_report_requested": true,
            "view_report_requested": true,
            "tags": []
        }
    ]
}
     

HTTP odgovor primljen od Perl SMS primjera

Nakon što SMS gateway primi ovaj zahtjev, generirat će HTTP odgovor. HTTP odgovor će sadržavati statusni kod, kako bi naznačio je li zahtjev za slanje SMS-a bio uspješan ili ne. Također će vratiti JSON kodiranu strukturu koja vam pruža korisne detalje o slanju poruke.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Tue, 29 Jun 2021 11:48:38 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked
 
{
    "http_code": 200,
    "response_code": "SUCCESS",
    "response_msg": "Poruke su u redu za isporuku.",
    "data": {
      "total_count": 1,
      "success_count": 1,
      "failed_count": 0,
      "messages": [
        {
          "message_id": "fa32293f-db00-11eb-804d-ffacbeab4160",
          "from_station": "%",
          "to_address": "+36201111111",
          "to_station": "%",
          "text": "Hello world!",
          "create_date": "2021-07-02 06:44:40",
          "valid_until": "2021-07-09 06:44:40",
          "time_to_send": "2021-07-02 06:44:40",
          "submit_report_requested": true,
          "delivery_report_requested": true,
          "view_report_requested": false,
          "tags": [
            {
              "name": "Type",
              "value": "SMS:TEXT"
            }
          ],
          "status": "SUCCESS"
        }
      ]
    }
}
     
Povežite svoju SMS pristupnu točku s mobilnom mrežom i stvorite HTTP API korisnički račun

Pretpostavljamo da ste već instalirali Ozeki SMS Gateway i da ste ga povezali s mobilnom mrežom. Kako biste mogli slati SMS poruke na mobilni telefon iz Perla, potrebno je postaviti HTTP API korisnički račun u Ozeki SMS Gatewayu. U ovom videu objasnit ćemo vam proces stvaranja novog HTTP API korisničkog računa. Video će započeti otvaranjem aplikacije Ozeki SMS gateway i vodit će vas do stvaranja HTTP API korisnika. Tijekom procesa naučit ćete kako konfigurirati novog korisnika i kako uključiti opciju bilježenja. Video traje samo 30 sekundi i vrlo detaljno objašnjava proces. Nećete imati problema s razumijevanjem koraka.

Video 3 - Kako izgleda proces stvaranja novog HTTP API korisničkog računa (Video vodič)

Kako poslati SMS iz Perla pomoću Perl SMS API-ja (Video vodič)

Ovaj video pokazuje kako preuzeti datoteku SendSms.pl.zip s ove stranice i kako otvoriti datoteku SendSms.pl u Notepadu. Ako pogledate video, primijetit ćete da su sadržaji SendSms.pl zipa smješteni na radnu površinu Windowsa. Također ćete vidjeti da otvaramo SendSms.pl datoteku s Windows Notepadom.

Video 4 - Kako preuzeti i postaviti gornje rješenje

Primjer SMS-a u Perlu: SendSms.pl

Na slici 1 možete vidjeti izvorni kod primjera projekta. Ako ste upoznati s programskim jezikom Perl, slobodno izmijenite kod prema vlastitim željama. Ovaj kod će poslati SMS na telefonski broj pohranjen u varijabli toAddress, s tekstom pohranjenim u varijabli Text.

Slika 3 - Datoteka SendSms.pl

Kako provjeriti je li SMS prihvaćen od strane HTTP korisnika

Nakon što je SMS poslan, dobro je provjeriti svoju SMS pristupnu točku, kako biste vidjeli što je primila. Dnevnik možete provjeriti otvaranjem detalja HTTP korisnika iz upravljačke konzole Ozeki SMS Gatewaya. Sljedeći video pokazuje što trebate tražiti.

Video 5 - Kako poslati SMS s gornjim Perl kodom (Video vodič)

Kako provjeriti je li SMS poslan na mobilnu mrežu

Završni korak u provjeri postupka je pogledati dnevnike veze s mobilnom mrežom. Možda ćete morati uključiti bilježenje u konfiguraciji veze prije nego što pošaljete poruku kako biste vidjeli dnevnike. Ako je bilježenje omogućeno, vidjet ćete telefonski broj i tekst poruke koju ste poslali.

Video 6 - Kako testirati je li zahtjev prihvaćen od strane SMPP klijenta (Video vodič)

Kako izgleda primanje SMS-a na Android telefonu (Video vodič)

U ovom videu vidjet ćete kako izgleda primanje SMS poruke na Android uređaju. Počet će s običnom početnom stranicom Androida. Vidjet ćete kako se pojavljuje obavijest, a zatim otvorenu aplikaciju Poruke s vidljivim SMS-om u njoj. Video traje samo 18 sekundi, ali prikazuje cijeli proces.

Video 7 - Kako izgleda primanje SMS poruke na Android uređaju (Video vodič)

Zaključak

Ovaj vodič trebao je pokazati kako poslati SMS u Perlu uz pomoć Ozeki SMS Gatewaya. Ako ste sve pažljivo pročitali, slanje poruka vašim korisnicima u Perlu s Ozeki SMS Gatewayom ne bi trebalo predstavljati nikakav problem. Potrebno je naglasiti da Ozeki SMS Gateway omogućuje bilježenje SMS poruka u bazu podataka i nudi razne mogućnosti izvješćivanja kako bi pružio više informacija o SMS vezi.

Nastavite čitati na Ozekijevoj stranici s vodičima gdje možete pronaći više informacija o temama kao što su zakazivanje SMS-a u Perlu.

Jedino što sada preostaje je preuzeti Ozeki SMS Gateway i početi raditi!

More information