Kako zakazati SMS u R-u

Najjednostavniji način za slanje zakazanih SMS poruka iz R-a 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 telefon primatelja i vratit će HTTP 200 OK odgovor na vaš zahtjev.

kako zakazati sms u r-u
Slika 1 - Kako zakazati SMS u R-u

R kod za slanje zakazanog SMS-a na mobilni telefon

Primjer R SMS koda u nastavku pokazuje kako možete poslati zakazani SMS koristeći http rest SMS API Ozeki SMS Gatewaya s bibliotekom R Ozeki.Libs.Rest. Ova biblioteka vam je dostupna besplatno i možete je koristiti i mijenjati u bilo kojem od vaših projekata.

SendScheduledSms.R
library(Ozeki.Libs.Rest)


configuration <- Ozeki.Libs.Rest::Configuration$new(
  username = "http_user",
  password = "qwe123",
  api_url = "http://127.0.0.1:9509/api"
)

msg <- Ozeki.Libs.Rest::Message$new()
msg$to_address <- "+36201111111"
msg$text <- "Pozdrav svijete!"
msg$time_to_send <- "2021-07-13T14:00:00"

api <- Ozeki.Libs.Rest::MessageApi$new(configuration)

result <- api$send(msg)

print(result$to_string())
	

Kod 1 - SendScheduledSms.R

Kako koristiti R SMS primjer:

Ovaj R SMS primjer može se koristiti u bilo kojoj R aplikaciji. Da biste ga koristili, morate preuzeti biblioteku Ozeki.Libs.Rest. Nakon preuzimanja biblioteke, trebate dodati referencu na nju u svoj R izvorni kod. To će vam omogućiti korištenje klasa koje pruža biblioteka Ozeki.Libs.Rest. 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 putem interneta.

Preuzmite SendScheduledSms.R

Izvorni kod objašnjen u ovom članku može se besplatno preuzeti, koristiti i mijenjati.
Preuzmi: SendScheduledSms.R.zip (391B)

Što se nalazi u datoteci SendScheduledSms.R.zip?

U SendScheduledSms.R.zip pronaći ćete datoteku SendScheduledSms.R, koja sadrži primjer koda koji vam pokazuje kako poslati SMS. Ovaj primjer koda je naveden u nastavku.

Slika 2 - Što se nalazi unutar SendScheduledSms.R.zip

Kako poslati SMS iz R-a (Jednostavne smjernice)

Za slanje SMS-a iz R-a:

  1. Instalirajte HTTP API korisnika
  2. Omogućite bilježenje komunikacijskih događaja na kartici Napredno
  3. Postavite Visual Studio
  4. Preuzmite zatim raspakirajte datoteku SendScheduledSms.R.zip
  5. Pokrenite Ozeki SMS Gateway aplikaciju
  6. Pokrenite R kod SendScheduledSms.R koristeći naredbeni redak
  7. Provjerite zapisnike da vidite je li SMS poslan

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli slati SMS iz R-a, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu na kojem razvijate svoj R kod u bilo kojem tekstualnom editoru, kao što je Windows notepad. Nakon instalacije, sljedeći korak je povezivanje Ozeki SMS Gatewaya s mobilnom mrežom. Možete poslati testni SMS iz Ozeki GUI-ja kako biste potvrdili da vaša mobilna mrežna veza radi. Završ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 R kod.

HTTP API URL za slanje SMS-a iz R-a

Da biste poslali SMS iz R-a, vaš R ć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 na kojem se pokreće R 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 R-a

Da biste autentificirali R 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 R-u možete koristiti sljedeći kod za ovo kodiranje:

username_password <- paste(username, ":", password, sep="")
username_password_encoded <- base64enc::base64encode(charToRaw(username_password))
return (paste("Basic", username_password_encoded, sep=" "))
	

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 R-a

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.

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
	
HTTP zahtjev za slanje SMS-a iz R

Za slanje SMS-a, vaša R 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 niz podataka. Sadrži broj primatelja, tekst i vrijeme kada želimo poslati poruku.

POST /api?action=sendmsg HTTP/1.1
Content-Length: 329
Content-Type: application/json
Accept: application/json
Accept-Encoding: deflate, gzip
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: libcurl/7.64.1 r-curl/4.3.2 httr/1.4.2

{
	"messages": [
		{
			"message_id": "5540aa51-c82d-4813-bbbe-d15919bb8b50",
			"to_address": "+36201111111",
			"text": "Hello world!",
			"create_date": "2021-07-13T12:46:23",
			"valid_until": "2021-07-20T12:46:23",
			"time_to_send": "2021-07-13T15:00:00",
			"is_submit_report_requested": true,
			"is_delivery_report_requested": true,
			"is_view_report_requested": true
		}
	]
}
	

HTTP odgovor primljen u R SMS primjeru

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 kako bi vam pružio korisne detalje o slanju poruke.

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Tue, 13 Jul 2021 14:44:12 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": "5540aa51-c82d-4813-bbbe-d15919bb8b50",
	      "from_station": "%",
	      "to_address": "+36201111111",
	      "to_station": "%",
	      "text": "Hello world!",
	      "create_date": "2021-07-13 12:46:23",
	      "valid_until": "2021-07-20 12:46:23",
	      "time_to_send": "2021-07-13 15:00:00",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ],
	      "status": "SUCCESS"
	    }
	  ]
	}
}
	

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

Ovaj video vam pokazuje kako preuzeti datoteku SendScheduledSms.R.zip s ove stranice. Ako pogledate video, primijetit ćete da su sadržaji SendScheduledSms.R.zip postavljeni na radnu površinu Windowsa. Također ćete vidjeti da pokrećemo naredbeni redak kako bismo poslali SMS.

R SMS primjer: SendScheduledSms.R

Primjer koda u nastavku dio je datoteke SendScheduledSms.R.

r izvorni kod za slanje zakazanog sms-a
Slika 3 - Datoteka SendScheduledSms.R

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

Nakon što je SMS poslan, dobro je provjeriti vaš SMS gateway kako biste vidjeli što je primio. Dnevnik možete provjeriti otvaranjem detalja HTTP korisnika iz konzole za upravljanje Ozeki SMS Gatewayom. Sljedeći video vam pokazuje što trebate tražiti.

Video 2 - Kako provjeriti je li SMS prihvaćen od strane HTTP korisnika (Video tutorial)

Sažetak

Gornji članak imao je za cilj objasniti korake zakazivanja SMS-a u R uz pomoć Ozeki SMS Gatewaya. S ovim rješenjem, odgađanje poruka je moguće, što vam daje priliku da kontaktirate korisnike u savršenom trenutku, kada nisu zauzeti i primjećuju vašu poruku. Na taj način se može poboljšati performansa i imidž prilagođen korisnicima. Ozeki SMS Gateway radi u okruženju koje kontrolirate, tako da su kontakt lista i podaci u sigurnim rukama.

Nastavite čitati na Ozekijevoj stranici s tutorijalima, gdje možete pronaći više informacija o temama poput brisanja u R.

Jedino što sada preostaje je preuzeti Ozeki SMS Gateway i neka posao počne!

More information