Kako zakazati SMS u Rubyju

Najjednostavniji način za slanje zakazanog SMS-a iz Rubyja je korištenje ugrađenog HTTP/Rest SMS API-ja Ozeki SMS Gatewaya. Kada koristite ovaj API, slat ć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.

Ruby kod za slanje zakazanog SMS-a na mobilni telefon

Ruby SMS primjer koda ispod pokazuje kako možete poslati zakazani SMS koristeći HTTP REST SMS API Ozeki SMS Gatewaya koristeći Ruby ozeki_libs_rest gem. Ova knjižnica vam je dostupna besplatno i možete je koristiti i mijenjati u bilo kojem od vaših projekata.

require 'ozeki_libs_rest'

configuration = Configuration.new(
    "http_user",
    "qwe123",
    "http://127.0.0.1:9509/api"
);

msg = Message.new
msg.to_address = "+36201111111"
msg.text = "Pozdrav svijete!"
msg.time_to_send = DateTime.parse('2021-07-06T013:00:00')

api = MessageApi.new(configuration)

result = api.send(msg)

print(result)
	

Kako koristiti Ruby SMS primjer:

Preuzmi SendScheduledSms.rb

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

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

SendScheduledSms.rb.zip sadrži datoteku SendScheduledSms.rb, koja sadrži primjer koda koji vam pokazuje kako poslati SMS. Ovaj primjer koda je naveden ispod.

Kako poslati zakazani SMS iz Rubyja (Brzi koraci)

Za slanje zakazanog SMS-a iz Rubyja:

1. Preuzmite datoteku SendScheduledSms.rb.zip
2. Ekstrahirajte .zip datoteku iz mape Preuzimanja
3. Otvorite datoteku SendScheduledSms.rb u bilo kojem uređivaču teksta poput Windows Notepada
4. Pokrenite Ozeki SMS Gateway
5. Kreirajte HTTP API korisnika u Ozekiju
6. Pokrenite SendScheduledSms.rb Ruby kod koristeći naredbeni redak
7. Provjerite poslane poruke u Ozeki SMS Gatewayu

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli slati SMS iz Rubyja, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu na kojem razvijate svoj Ruby kod u Visual studiju. 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. 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 što je okruženje postavljeno, možete pokrenuti svoj Ruby kod.

HTTP API URL za slanje SMS-a iz Rubyja

Za slanje SMS-a iz Rubyja, vaš Ruby ć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 Ruby 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 Rubyja

Za autentifikaciju Ruby SMS klijenta, 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 Rubyju možete koristiti sljedeći kod za ovo kodiranje:

username_password = username + ':' + password
username_password_encoded = Base64.encode64(username_password)
'Basic ' + username_password_encoded
	

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 Rubyja

Za slanje SMS poruka, 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==
	

Za slanje SMS-a, vaša Ruby aplikacija će poslati HTTP zahtjev sličan onome ispod. 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 i tekst poruke.

POST /api?action=sendmsg HTTP/1.1
Content-Length: 339
Content-Type: application/json
Accept: application/json
Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Faraday v1.5.0
  
{
	"messages":	[
		{
			"message_id":	"f0f02105-0a78-46a9-ae14-f0728bac2aa6",
			"to_address":	"+36201111111",
			"text":	"Hello world!",
			"create_date":	"2021-07-06T14:32:21",
			"valid_until":	"2021-07-13T14:32:21",
			"time_to_send":	"2021-07-06T13:00:00",
			"is_submit_report_requested":	true,
			"is_delivery_report_requested":	true,
			"is_view_report_requested":	true,
			"tags":	[]
		}
	]
}
	

HTTP odgovor primljen u Ruby 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 koja vam pruža 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, 06 Jul 2021 14:26:41 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"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": "f0f02105-0a78-46a9-ae14-f0728bac2aa6",
	      "from_station": "%",
	      "to_address": "+36201111111",
	      "to_station": "%",
	      "text": "Hello world!",
	      "create_date": "2021-07-06 14:32:21",
	      "valid_until": "2021-07-13 14:32:21",
	      "time_to_send": "2021-07-06 13:00:00",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ],
	      "status": "SUCCESS"
	    }
	  ]
	}
}
	

Ruby SMS primjer: SendScheduledSms.rb

U sljedećem videu, prikazujemo vam proces preuzimanja izvornog koda projekta. Video će započeti s preuzimanjem datoteka projekta i vodit će vas sve do otvorene projektne datoteke. Video će vam pokazati kako preuzeti projektnu datoteku i otvoriti je uz pomoć Notepada. Ovaj 36-sekundni video je detaljan i sadrži sve informacije koje su vam potrebne za uspješno dovršavanje procesa preuzimanja.

Primjer koda

Primjer koda u nastavku dio je datoteke SendScheduledSms.rb. Možete modificirati primjer projekta pronalaženjem odgovarajućeg retka i zamjenom dijela koda s ispravnim podacima. Na primjer, varijabla msg.to_address sadrži telefonski broj na koji će poruka biti dostavljena (Slika 3). Varijabla msg.text sadrži tekst poruke. Izmijenite je prema vlastitim željama i pokrenite projekt kako biste poslali testnu poruku.

Kako poslati zakazani SMS koristeći Ruby (Video tutorial)

U ovom videu, pokazat ćemo vam proces pokretanja primjera projekta. Video će započeti s pripremljenim izvornim kodom i završit će s logom zakazanog SMS-a. Video će vas naučiti kako odrediti vrijeme za slanje poruke i konfiguraciju koju trebate napraviti u naredbenom retku. Ovaj video traje samo 1:30, ali je vrlo detaljan. Naučit ćete sve ključne korake koje trebate poduzeti kako biste zakazali SMS. Koristimo Ozeki SMS Gateway u ovom videu, tako da ćete raditi s vrlo intuitivnim korisničkim sučeljem. Nećete imati problema s praćenjem koraka.

Zaključak

Gornji članak pokazao je korake zakazivanja SMS-a u Ruby jeziku uz pomoć Ozeki SMS Gatewaya. S ovim rješenjem, moguće je postići savršeno vrijeme isporuke SMS-a, što dovodi do veće učinkovitosti i prilagođenog imidža prema korisnicima. Primatelji dobivaju poruke kada nisu u svojim zauzetim satima, tako da imaju vremena pročitati ih. Ozeki SMS Gateway je vrlo pouzdan softver i njime se može vrlo lako upravljati.

Nastavite čitanje na Ozekijevoj stranici s tutorijalima gdje možete pronaći više informacija o sličnim temama, poput primanja u Rubyju.

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