Kako poslati SMS iz Delphija

Najjednostavniji način za slanje SMS-a iz Delphija 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 delphija
Slika 1 - Kako poslati SMS iz Delphija

Delphi kod za slanje SMS-a na mobilni telefon

Primjer Delphi SMS koda u nastavku pokazuje kako možete poslati SMS koristeći http rest sms api Ozeki SMS Gatewaya koristeći Delphi Ozeki.Libs.Rest jedinicu. Ova jedinica vam je dostupna besplatno i možete je koristiti i mijenjati u bilo kojem od vaših projekata.

SendSms.delphi 
program SendSms;

{$APPTYPE CONSOLE}

{$R *.res}

uses
  System.SysUtils,
  Ozeki.Libs.Rest in '../Ozeki.Libs.Rest/Ozeki.Libs.Rest.pas';

var configuration : Ozeki.Libs.Rest.Configuration;
var msg : Ozeki.Libs.Rest.Message;
var api : Ozeki.Libs.Rest.MessageApi;
var result : MessageSendResult;
var read : string;

begin
  try
    configuration := Ozeki.Libs.Rest.Configuration.Create;
    configuration.Username := 'http_user';
    configuration.Password := 'qwe123';
    configuration.ApiUrl := 'http://127.0.0.1:9509/api';

    msg := Ozeki.Libs.Rest.Message.Create;
    msg.ToAddress := '+36201111111';
    msg.Text := 'Pozdrav svijete!';

    api := Ozeki.Libs.Rest.MessageApi.Create(configuration);

    result := api.SendMessage(msg);

    Writeln(result.ToString());

    Readln(read);
  except
    on E: Exception do
      Writeln(E.ClassName, ': ', E.Message);
  end;
end.

Kako koristiti Delphi SMS primjer:

Ovaj Delphi SMS primjer može se koristiti u bilo kojoj Delphi aplikaciji. Da biste ga koristili, morate dodati Ozeki.Libs.Rest.pas jedinicu u svoj projekt. Nakon dodavanja jedinice, morate staviti uses Ozeki.Libs.Rest in '../Ozeki.Libs.Rest/Ozeki.Libs.Rest.pas'; direktivu u zaglavlje vašeg Delphi izvornog koda. To će vam omogućiti korištenje klasa koje pruža Ozeki.Libs.Rest jedinica. 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 putem bežične veze ili interneta.

Preuzmite SendSMS.delphi

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

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

SendSms.delphi.zip datoteka sadrži Ozeki.Libs.Rest jedinicu, koja vam daje sve potrebne alate za slanje i primanje SMS poruka. Također ćete pronaći SendSms projekt u zip datoteci, koji sadrži primjer koda koji pokazuje kako poslati SMS. Ovaj primjer koda je naveden u nastavku.

direktorij za slanje sms iz delphija
Slika 2 - Što se nalazi u SendSms.delphi.zip

Kako poslati SMS iz Delphija (Jednostavne smjernice)

Da biste poslali SMS iz Delphija:

  1. Instalirajte HTTP API korisnika
  2. Omogućite bilježenje komunikacijskih događaja na kartici Napredno
  3. Postavite Embarcadero Delphi Studio
  4. Preuzmite zatim raspakirajte SendSms.delphi.zip datoteku
  5. Otvorite SendSms.dproj datoteku u Delphi Studiju dvostrukim klikom na nju
  6. Pokrenite Ozeki SMS Gateway aplikaciju
  7. Pokrenite SendSms.dpr Delphi kod u Delphi Studiju
  8. Provjerite zapisnike da vidite je li SMS poslan

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli poslati SMS iz Delphija, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu gdje razvijate svoj Delphi kod u Visual studiju. Nakon instalacije, sljedeći korak je povezati Ozeki SMS Gateway s mobilnom mrežom. Možete poslati testni sms iz Ozeki GUI-a kako biste potvrdili da vaša mobilna mrežna veza radi. Konačni 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 postavljanja okruženja, možete pokrenuti svoj Delphi kod.

HTTP API url za slanje SMS-a iz Delphija

Da biste poslali SMS iz Delphija, vaš Delphi ć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 Delphi SMS aplikacija, ovo može biti 127.0.0.1. Ako je instaliran na drugom računalu, treba biti IP adresa tog računala. 

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

HTTP autentifikacija za slanje SMS-a iz Delphija

Za autentifikaciju Delphi SMS klijenta, potrebno je poslati korisničko ime i lozinku u base64 kodiranom stringu na server u HTTP zahtjevu. Korišteni format je: base64(korisničko_ime+":"+lozinka). U Delphi-u možete koristiti sljedeći kod za to kodiranje: 

var usernamePassword := username + ':' + password;
var Encoder := TBase64Encoding.Create();
var usernamePasswordEncoded := Encoder.Encode(usernamePassword);
result := Format('Basic %s', [usernamePasswordEncoded]);

Na primjer, ako kodirate 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 Delphija

Za slanje SMS poruka, potrebno je uključiti sljedeće retke kao zaglavlja u HTTP zahtjev. Imajte na umu da uključujemo Content-Type i Authorization zaglavlje. 

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

HTTP zahtjev za slanje SMS-a iz Delphija

Za slanje SMS-a, vaša Delphi aplikacija će poslati HTTP zahtjev sličan donjem primjeru. 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. 

POST /api?action=sendmsg HTTP/1.0
Connection: keep-alive
Content-Type: application/json
Content-Length: 412
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
Accept: application/json
User-Agent: Mozilla/3.0 (compatible; Indy Library)

{
	"messages": [
		{
			"message_id": "ae0d1fe5-7e93-4241-b31c-5b3ebf867c5b",
			"from_connection": "",
			"from_address": "",
			"from_station": "",
			"to_connection": "",
			"to_address": "+36201111111",
			"to_station": "",
			"text": "Hello world!",
			"create_date": "2021-07-27T14:22:12",
			"valid_until": "2021-08-03T14:22:12",
			"time_to_send": "2021-07-27T14:22:12",
			"submit_report_requested": true,
			"delivery_report_requested": true,
			"view_report_requested": true
		}
	]
}

HTTP odgovor primljen od Delphi 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 uspio ili ne. Također će vratiti JSON kodiranu strukturu koja vam pruža korisne detalje o slanju poruke. 

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf8
Last-Modified: Tue, 27 Jul 2021 06:58:42 GMT
Server: 10/10.3.123 Microsoft-HTTPAPI/2.0
User-Agent: OZEKI 10.3.123 (myozeki.com)
Date: Tue, 27 Jul 2021 12:22:12 GMT
Connection: close

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Messages queued for delivery.",
  "data": {
    "total_count": 1,
    "success_count": 1,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "ae0d1fe5-7e93-4241-b31c-5b3ebf867c5b",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hello world!",
        "create_date": "2021-07-27 14:22:12",
        "valid_until": "2021-08-03 14:22:12",
        "time_to_send": "2021-07-27 14:22:12",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}

Povežite svoj SMS gateway s mobilnom mrežom i kreirajte 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 na mobilni telefon iz Delphija, potrebno je postaviti HTTP API korisnički račun u Ozeki SMS Gateway-u.

Video 1 - Kako postaviti HTTP API korisnički račun (Video tutorial)

Kako poslati SMS iz Delphija koristeći Delphi SMS API (Video tutorial)

Ovaj video vam pokazuje kako preuzeti datoteku SendSms.delphi.zip s ove stranice, i kako preuzeti njen sadržaj u Delphi studio. Ako pogledate video, primijetit ćete da je sadržaj SendSms.delphi zip datoteke smješten na Windows radnu površinu. Također ćete vidjeti da dvoklikom na SendSms.dproj projektnu datoteku otvaramo projekt.

Delphi SMS primjer: SendSms.dproj

U ovom rješenju postoji samo jedan projekt: SendSms.dproj, i dvije datoteke: SendSms.dpr i Ozeki.Libs.Rest.pas.

Slika 3 - SendSms.dproj

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

Nakon što je SMS poslan, dobra je praksa provjeriti vaš SMS gateway, kako biste vidjeli što je primio. Dnevnik možete provjeriti otvaranjem detalja HTTP korisnika iz Ozeki SMS Gateway upravljačke konzole. Sljedeći video vam pokazuje što trebate tražiti.

Video 3 - Slanje SMS-a s gornjim Delphi kodom (Video tutorial)

Kako provjeriti je li SMS poslan na mobilnu mrežu

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

Video 4 - Kako testirati je li zahtjev prihvaćen od strane SMPP klijenta (Video tutorial)

Kako izgleda primitak SMS poruke na Androidu (Video tutorial)

U ovom videu pokazat ćemo vam kako izgleda primitak SMS poruke na Androidu. Video traje samo 18 sekundi, ali na njemu možete vidjeti cijeli proces. Počet će s običnom početnom stranicom Androida. Vidjet ćete obavijest za SMS i otvorenu aplikaciju Poruke s vidljivom porukom.

Video 5 - SMS poruka primljena na mobilni telefon (Video tutorial)

Sažetak

Ovaj članak pokazao vam je najjednostavniji način slanja SMS-a iz Delphija. Ako ste pročitali ovaj tutorial, znate kako kreirati HTTP SMS API korisnika u Ozeki SMS pristupniku kako biste mogli slati SMS iz Delphija. Jedna od mnogih prednosti ovog rješenja je da dani primjer SMS-a u Delphiu možete koristiti i modificirati u bilo kojem svom projektu.

Možete pronaći više dokumenata koji nude druge Delphi programske kodove, iskoristite svaku priliku i proučite ih. Ako želite koristiti ovu uslugu Ozeki SMS pristupnika u širem krugu, pogledajte članak Kako preuzeti najnoviju Delphi SMS API jedinicu s Githuba i naučite više.

Preuzmite Ozeki SMS pristupnik sada i postavite sustav!

More information