Kako primiti SMS u Node.js

Najjednostavniji način za slanje SMS-a iz Node.Js 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 prema SMS gatewayu. HTTP Post zahtjev će sadržavati poruku formatiranu u json formatu. SMS gateway će poslati ovaj SMS primatelju na telefon i vratit će HTTP 200 OK odgovor na vaš zahtjev.

kako primiti sms poruke koristeći node js
Slika 1 - Kako primiti SMS iz Node.Js

JavaScript kod za primanje SMS poruka

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

ReceiveSms.mjs
import { Configuration, MessageApi } from './Ozeki.Libs.Rest.js';


var configuration = new  Configuration();
configuration.Username = "http_user";
configuration.Password = "qwe123";
configuration.ApiUrl = "http://127.0.0.1:9509/api";

var api = new MessageApi(configuration);

const result = await api.DownloadIncoming();

console.log(result.toString());

for (let i = 0; i < result.MessageCount; i++) {
    console.log(result.Messages[i].toString());
}
	

Kako koristiti JavaScript sms primjer:

Možete koristiti klasu Message za kreiranje SMS-a i možete koristiti klasu MessageApi za slanje SMS-a prema SMS gatewayu. SMS gateway će proslijediti vašu poruku mobilnoj mreži bilo putem bežične veze ili putem interneta.

Preuzmi ReceiveSms.js

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

Što se nalazi u ReceiveSms.js.zip datoteci?

ReceiveSms.js.zip datoteka sadrži Ozeki.Libs.Rest biblioteku, koja vam daje sve potrebne alate za slanje, označavanje, brisanje i primanje SMS poruka. Također ćete pronaći ReceiveSms.mjs datoteku u projektu, koja sadrži primjer koda koji pokazuje kako primiti SMS poruke. Ovaj primjer koda je naveden ispod.

primjer projekta za primanje sms koristeći node js
Slika 2 - ReceiveSms.js direktorij

Ovaj projekt ima ovisnosti, pa prije početka morate instalirati node-fetch paket sa sljedećom naredbom:

npm install node-fetch
	

Kod 1 - Naredba za instalaciju node-fetch paketa

.

Kako primiti SMS poruke iz Node.Js (Brzi koraci)

Za primanje SMS poruka iz Node.Js:

  1. Instalirajte Ozeki SMS Gateway
  2. Povežite Ozeki SMS Gateway s mobilnom mrežom
  3. Pošaljite testni sms iz Ozeki GUI-a
  4. Kreirajte HTTP sms api korisnika
  5. Apache NetBeans
  6. Preuzmite gore navedeni primjer projekta
  7. Kreirajte SMS kreiranjem novog Message objekta
  8. Kreirajte api za slanje vaše poruke
  9. Koristite metodu DownloadIncoming() za primanje vaše poruke(e)
  10. Pročitajte odgovor poruke na konzoli i ispišite poruke na konzolu
  11. Provjerite zapisnike u SMS gatewayu

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli slati SMS iz Node.Js, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu gdje razvijate svoj JavaScript kod u Visual Studio Codeu ili bilo kojem drugom uređivaču koda. Nakon instalacije, sljedeći korak je povezivanje Ozeki SMS Gatewaya 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 korisnika. Kreirajte korisnika s korisničkim imenom "http_user" i lozinkom "qwe123" kako bi primjer radio bez modifikacija.

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

HTTP API url za primanje sms iz Node.Js

Da biste primili SMS iz Node.Js, vaš JavaScript će morati poslati HTTP zahtjev prema 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 gdje se pokreće JavaScript 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 iz JavaScripta

Za autentifikaciju Node.Js sms klijenta, morate poslati korisničko ime i lozinku u base64 kodiranom stringu prema serveru u HTTP zahtjevu. Korišteni format je: base64(korisničko_ime+":"+lozinka). U JavaScriptu možete koristiti sljedeći kod za ovo kodiranje:

var usernamePassword = username + ":" + password;
return `Basic ${Base64.encode(usernamePassword)}`;
	

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 JavaScripta

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

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

HTTP zahtjev za slanje SMS-a iz Node.Js

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

GET /api?action=receivemsg&folder=inbox HTTP/1.1
Connection: close
Accept: */*
Accept-Encoding: gzip,deflate
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: node-fetch/1.0 (+https://github.com/bitinn/node-fetch)
	

HTTP odgovor primljen u JavaScript 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 pojedinosti o slanju poruke.

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.120 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Mon, 14 Jun 2021 09:12:00 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "limit": "1000",
	  "data": [
	    {
	      "message_id": "02ccc4d5-4aeb-7f64-b980-9aa262ef86fb",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36201111111",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 1",
	      "create_date": "2021-06-14 12:00:14",
	      "valid_until": "2021-06-21 12:00:14",
	      "time_to_send": "2021-06-14 12:00:14",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "bb663f6c-fcf2-df32-bd33-1778e8578f23",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36202222222",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 2",
	      "create_date": "2021-06-14 12:00:14",
	      "valid_until": "2021-06-21 12:00:14",
	      "time_to_send": "2021-06-14 12:00:14",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "ca555a52-2f5a-285a-b6e2-6aa1fa3353f8",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36203333333",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 3",
	      "create_date": "2021-06-14 12:00:14",
	      "valid_until": "2021-06-21 12:00:14",
	      "time_to_send": "2021-06-14 12:00:14",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    }
	  ]
	}
}
	

Kako primiti SMS iz Node.Js koristeći SMS API (Video tutorial)

Ovaj video vam pokazuje kako preuzeti i koristiti projekt ReceiveSms.js. Nakon što dodate potrebne datoteke u svoj projekt, možda ćete primijetiti da postoji datoteka pod nazivom Ozeki.Lbis.Rest.js. Ovo je datoteka koja sadrži MessageApi i sve što vam je potrebno za slanje SMS-a koristeći JavaScript.

Video 1 - Kako preuzeti Ozeki.Libs.Rest i postaviti svoj projekt (Video tutorial)

Node.Js SMS primjer: ReceiveSms.mjs (u Notepadu)

Na sljedećoj slici možete vidjeti izvorni kod ReceiveSMS.mjs otvoren (Slika 3). U ovom slučaju koristili smo Notepad za otvaranje izvornog koda, koji se također može koristiti za njegovo uređivanje. Kao što možete vidjeti, kod sadrži unaprijed postavljene varijable korisničkog imena i lozinke. Ako ste upoznati s Node.js programskim jezikom, slobodno promijenite vrijednosti varijabli kako bi odgovarale vašim HTTP korisničkim podacima za prijavu.

javascript primjer za primanje SMS poruka
Slika 3 - ReceiveSms.mjs u Notepadu

Node.Js SMS primjer: ReceiveSms.mjs (u Visual Studio Codeu)

Ako želite koristiti IDE s ugrađenim bojanjem koda, korisnom dokumentacijom i proširenjima, koristite Visual Studio Code. To je lagano i besplatno programsko okruženje koje možete koristiti za uređivanje koda u mnogim različitim jezicima. Kao što možete vidjeti, kodirali smo primjer korisničkog imena i lozinke u izvorni kod. Ako ste upoznati s Node.js programskim jezikom, slobodno ih uredite kako bi odgovarali vašem HTTP korisniku.

javascript primjer za primanje SMS poruka
Slika 4 - ReceiveSms.mjs u Visual Studio Codeu

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

Nakon što je zahtjev poslan, dobro je provjeriti svoj 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.

Video 2 - Kako primati SMS poruke s gore navedenim JavaScript kodom (Video tutorial)

Sažetak

Vodič je objasnio kako postaviti ovaj SMS API za primanje SMS poruka s Node.js programom koristeći HTTP korisnika Ozeki SMS pristupnika. Ovo rješenje vam pomaže organizirati dolazne poruke premještajući ih iz mape Inbox u vašu Node.js aplikaciju. Primjena ovog programa omogućuje vam da održavate svoj sustav poruka organiziranim i dopuštate da važne informacije stižu do vas.

Siguran sam da želite naučiti više o učinkovitom upravljanju porukama, sve što vam treba možete pronaći na Ozeki web stranici. Puno pomaže ako razvrstavate poruke i zadržavate samo ono što vam je potrebno, pa pročitajte sljedeći članak o Kako izbrisati SMS u Node.js-u.

Postavite Ozeki SMS pristupnik sada i iskoristite ono što ste naučili!

More information