Kako poslati SMS iz R-a

Najjednostavniji način za slanje SMS-a 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.

Što je R?

R je programski jezik i okruženje koje se uglavnom koristi za statističko računanje i grafiku.

R kod za slanje SMS-a na mobilni telefon

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

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 <- "Hello world!"

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

result <- api$send(msg)

print(result$to_string())
	

Kako koristiti R SMS primjer:

Ovaj R SMS primjer može se koristiti u bilo kojoj R aplikaciji. Da biste ga koristili, morate preuzeti Ozeki.Libs.Rest biblioteku. Nakon što se biblioteka preuzme, trebate dodati referencu na nju u svoj R izvorni kod. 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 putem bežične veze ili putem interneta.

Preuzmite SendSms.R

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

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

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

Kako instalirati Ozeki.Libs.Rest biblioteku koristeći Windows shell

r
install.packages("devtools")
library(devtools)
install_github('ozekisms/r-send-sms-http-rest-ozeki')
	

Možete testirati je li biblioteka uspješno instalirana upisivanjem:

library(Ozeki.Libs.Rest)
	

Ako nije vratio nikakvu grešku, biblioteka je uspješno instalirana.

Kako instalirati Ozeki.Libs.Rest biblioteku

U ovom videu pokazat ćemo vam kako instalirati Ozeki.Libs.Rest biblioteku za kasniju upotrebu. Video će započeti otvaranjem naredbenog retka i vodit će vas kroz sve instalirane pakete. Video je dug samo 1:29, ali vrlo detaljan. Ovaj video će biti velika pomoć u procesu.

Kako poslati SMS iz R-a (Jednostavne smjernice)

Da biste poslali SMS iz R-a:

1. Instalirajte HTTP API korisnika
2. Omogućite Log komunikacijske događaje na kartici Napredno
3. Postavite Visual Studio
4. Preuzmite zatim raspakirajte SendSms.R.zip datoteku
5. Pokrenite Ozeki SMS Gateway aplikaciju
6. Pokrenite SendSms.R R kod 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 uređivaču teksta, kao što je Windows notepad. 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 kreirati HTTP SMS API korisnički račun. 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 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 ispod. 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

Za autentifikaciju R 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 R-u možete koristiti sljedeći kod za to 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

Za slanje SMS poruka, potrebno je uključiti sljedeće retke kao zaglavlja u HTTP zahtjev. Imajte na umu da uključujemo tip sadržaja i zaglavlje za autorizaciju.

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

HTTP zahtjev za slanje SMS-a iz R-a

Za slanje SMS-a, vaša R aplikacija će poslati HTTP zahtjev sličan donjem primjeru. Imajte na umu da ovaj zahtjev sadrži dio HTTP zaglavlja i dio tijela HTTP-a. Tijelo HTTP-a je JSON kodirani podatkovni string. Sadrži broj primatelja i tekst poruke.

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": "38ad4dfe-3fa3-449c-95c9-b5e9c6ce3b62",
			"to_address": "+36201111111",
			"text": "Pozdrav svijete!",
			"create_date": "2021-07-13T12:46:23",
			"valid_until": "2021-07-20T12:46:23",
			"time_to_send": "2021-07-13T12:46:23",
			"is_submit_report_requested": true,
			"is_delivery_report_requested": true,
			"is_view_report_requested": true
		}
	]
}
	

HTTP odgovor primljen od R 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 kako bi vam pružila 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 13:39:07 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": "38ad4dfe-3fa3-449c-95c9-b5e9c6ce3b62",
	      "from_station": "%",
	      "to_address": "+36201111111",
	      "to_station": "%",
	      "text": "Pozdrav svijete!",
	      "create_date": "2021-07-13 12:46:23",
	      "valid_until": "2021-07-20 12:46:23",
	      "time_to_send": "2021-07-13 12:46:23",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "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 (Video tutorial)

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 R-a, potrebno je postaviti HTTP API korisnički račun u Ozeki SMS Gatewayu. U ovom videu objasnit ćemo vam proces instalacije HTTP API-ja. Video traje samo 30 sekundi i sadrži sve informacije koje su vam potrebne za postavljanje HTTP API-ja. Naučit ćete kako kreirati novog korisnika u Ozeki SMS Gatewayu i kako ga konfigurirati.

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

Ovaj video pokazuje kako preuzeti datoteku SendSms.R.zip s ove stranice. Ako pogledate video, primijetit ćete da su sadržaji SendSms.R.zip-a smješteni na Windows radnoj površini. Također ćete vidjeti da pokrećemo naredbeni redak za slanje SMS-a. Video traje samo 32 sekunde i prikazuje sve korake koje trebate poduzeti. Koristimo Ozeki SMS Gateway u ovom videu, što je moćna, ali laka za naučiti aplikacija gatewaya.

R SMS primjer: SendSms.R

Primjer koda u nastavku dio je SendSms.R datoteke.

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

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 slanja poruke kako biste vidjeli dnevnike. Ako je bilježenje uključeno, vidjet ćete broj telefona i tekst poruke koju ste poslali.

Kako primiti SMS na Android telefonu (Video tutorial)

U ovom videu svjedočit ćete procesu primanja SMS-a na Android telefonu. Počet će s običnom Android početnom stranicom. Vidjet ćete kako se pojavljuje obavijest o SMS-u. Također ćete naučiti kako otvoriti SMS poruku iz obavijesti. Video traje samo 18 sekundi, ali prikazuje cijeli proces.

Sažetak

Svrha ovog vodiča bila je pokazati proces slanja SMS-a u R uz pomoć Ozeki SMS pristupnika. Ovo znanje omogućuje kontaktiranje korisnika pomoću jednostavnog R koda i Ozeki SMS pristupnika. Važno je napomenuti da Ozeki SMS pristupnik radi u bilo kojoj zemlji i može slati i primati SMS putem različitih mobilnih veza, što znači da je međunarodno slanje poruka također moguće s ovim programom.

Pobrinite se da svoje učenje ne završite ovdje, posjetite Ozeki stranicu s tutorialima gdje možete pronaći više informacija o sličnim temama, poput slanja više SMS poruka i planiranja SMS poruka u R.

Sljedeća stvar koju trebate učiniti je preuzeti Ozeki SMS pristupnik i početi raditi!