Cum să trimiți SMS din Node.js

Cea mai simplă metodă de a trimite SMS din Node.Js este utilizarea API-ului HTTP/Rest SMS încorporat al Ozeki SMS Gateway. Când folosești acest API, vei trimite mesaje SMS prin emiterea unei cereri HTTP Post către gateway-ul SMS. Cererea HTTP Post va conține un mesaj formatat în format json. Gateway-ul SMS va trimite acest SMS către telefonul destinatar și va returna un răspuns HTTP 200 OK la cererea ta.

Exemplul de cod JavaScript pentru SMS de mai jos demonstrează cum poți trimite SMS folosind API-ul http rest sms al Ozeki SMS Gateway cu ajutorul bibliotecii JavaScript Ozeki.Libs.Rest. Această bibliotecă este oferită gratuit și poți să o folosești și să o modifici în oricare dintre proiectele tale.

import { Configuration, Message, 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);

var msg = new Message();
msg.ToAddress = "+36201111111";
msg.Text = "Hello world!";

const result = await api.Send(msg);

console.log(result.toString());
	

Cum să folosești exemplul de SMS în JavaScript:

Poți folosi clasa Message pentru a crea SMS-ul și poți folosi clasa MessageApi pentru a trimite SMS-ul către gateway-ul SMS. Gateway-ul SMS va transmite mesajul tău către rețeaua mobilă fie printr-o conexiune wireless fie prin Internet.

Codul sursă explicat în acest articol poate fi descărcat, folosit și modificat gratuit.
Descarcă: SendSms.js.zip (4.35Kb)

Fișierul SendSms.js.zip conține biblioteca Ozeki.Libs.Rest, care îți oferă toate instrumentele necesare pentru a trimite și primi mesaje SMS. Vei găsi de asemenea un fișier SendSms.mjs în proiect, care conține codul exemplu pentru a-ți arăta cum să trimiți un SMS. Acest cod exemplu este listat mai jos.

Acest proiect are dependențe, așa că înainte de a începe trebuie să instalezi pachetul node-fetch cu următoarea comandă:

npm install node-fetch
	

Pentru a trimite sms din Node.Js:

1. Instalează Ozeki SMS Gateway
2. Conectează Ozeki SMS Gateway la rețeaua mobilă
3. Trimite un sms de test din interfața Ozeki
4. Creează un utilizator HTTP sms api
5. Visual Studio Code sau Windows Notepad
6. Descarcă proiectul exemplu de mai sus
7. Creează SMS-ul prin crearea unui nou obiect Message
8. Creează un api pentru a trimite mesajul tău
9. Folosește metoda Send pentru a trimite mesajul tău
10. Citește mesajul de răspuns pe consolă
11. Verifică jurnalele din gateway-ul SMS

Pentru a putea trimite SMS din Node.Js, mai întâi trebuie să instalezi Ozeki SMS Gateway. Gateway-ul SMS poate fi instalat pe același calculator unde dezvolți codul tău JavaScript în Visual Studio Code sau orice alt editor de cod. După instalare, următorul pas este să conectezi Ozeki SMS Gateway la rețeaua mobilă. Poți trimite un sms de test din interfața Ozeki pentru a verifica dacă conexiunea ta la rețeaua mobilă funcționează. Ultimul pas pentru a-ți pregăti mediul este să creezi un utilizator HTTP sms api. Creează un utilizator cu numele de utilizator "http_user" și parola "qwe123" pentru a face exemplul să funcționeze fără modificări.

După ce mediul este configurat, poți rula codul tău JavaScript.

Pentru a trimite SMS din Node.Js, JavaScript-ul tău va trebui să emită o cerere HTTP către gateway-ul SMS. URL-ul API este afișat mai jos. Reține că adresa IP (127.0.0.1) ar trebui să fie înlocuită cu adresa IP a gateway-ului tău SMS. Dacă Ozeki SMS Gateway este instalat pe același calculator unde rulează aplicația JavaScript pentru SMS, aceasta poate fi 127.0.0.1. Dacă este instalat pe un alt calculator, ar trebui să fie adresa IP a acelui calculator.

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

Pentru a autentifica clientul SMS Node.Js, trebuie să trimiți numele de utilizator și parola într-un șir codificat base64 către server într-o cerere HTTP. Formatul folosit este: base64(nume_utilizator+":"+parolă). În JavaScript poți folosi următorul cod pentru a face această codificare:

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

De exemplu, dacă codezi numele de utilizator 'http_user' și parola 'qwe123', vei obține următorul șir codificat base64: aHR0cF91c2VyOnF3ZTEyMw==. Pentru a trimite

Pentru a trimite mesajele SMS, trebuie să incluzi următoarele linii ca antete în cererea HTTP. Reține că includem un antet Content-Type și un antet Authorization.

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

Cerere HTTP pentru trimiterea SMS din Node.Js

Pentru a trimite SMS-ul, aplicația dvs. Node.Js va trimite o cerere HTTP similară cu cea de mai jos. Rețineți că această cerere conține o parte de antet HTTP și o parte de corp HTTP. Corpul HTTP este un șir de date codificat în JSON. Acesta conține numărul destinatarului și textul mesajului.

POST /api?action=sendmsg HTTP/1.1
Connection: close
Content-Length: 319
Content-Type: application/json
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)
  
{
	"messages":	[
		{
			"message_id":	"faac3935-8358-d465-835c-0919186ddf7b",
			"to_address":	"+36201111111","text":"Hello world!",
			"create_date":	"2021-06-14T11:47:05",
			"vaild_date":	"2021-06-21T11:47:05",
			"time_to_send":	"2021-06-14T11:47:05",
			"submit_report_requested":	true,
			"delivery_report_requested":	true,
			"view_report_requested":	true
		}
	]
}
	

Răspuns HTTP primit de exemplul JavaScript pentru SMS

Odată ce gateway-ul SMS primește această cerere, va genera un răspuns HTTP. Răspunsul HTTP va conține un cod de stare, pentru a indica dacă cererea de trimitere a SMS-ului a fost reușită sau nu. De asemenea, va returna o structură codificată în JSON pentru a vă oferi detalii utile despre trimiterea mesajului.

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": "Messages queued for delivery.",
	"data": {
	  "total_count": 1,
	  "success_count": 1,
	  "failed_count": 0,
	  "messages": [
	    {
	      "message_id": "faac3935-8358-d465-835c-0919186ddf7b",
	      "from_station": "%",
	      "to_address": "+36201111111",
	      "to_station": "%",
	      "text": "Hello world!",
	      "create_date": "2021-06-14 11:47:05",
	      "valid_until": "2021-06-21 11:47:05",
	      "time_to_send": "2021-06-14 11:47:05",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ],
	      "status": "SUCCESS"
	    }
	  ]
	}
}
	

Cum să trimiți SMS din Node.Js folosind API-ul SMS (Tutorial video)

Acest videoclip vă arată cum să descărcați și să utilizați proiectul SendSms.js. După ce ați adăugat fișierele necesare în proiectul dvs., s-ar putea să observați că există un fișier numit Ozeki.Lbis.Rest.js. Acesta este fișierul care conține MessageApi și toate elementele necesare pentru a trimite un SMS folosind JavaScript.

Exemplu SMS Node.Js: SendSms.mjs (în Notepad)

În această imagine, puteți găsi codul sursă al proiectului, deschis în Notepad (Figura 3). După cum puteți vedea, acesta poate fi deschis în Notepad și poate fi editat și el. Dacă sunteți familiarizat cu Node.js, nu ezitați să modificați variabilele din cod și trimiteți un mesaj personalizat la o adresă a dvs.

Exemplu SMS Node.Js: SendSms.mjs (în Visual Studio Code)

Dacă căutați o modalitate mai sofisticată de a deschide codul sursă, încercați să utilizați Visual Studio Code (Figura 4). Acesta vă oferă codare color, mai multă ajutor și completare automată. Este un IDE (Mediu de Dezvoltare Integrat) ușor, open-source și gratuit de utilizat.

Cum să verificați că SMS-ul a fost acceptat de utilizatorul HTTP

După ce SMS-ul a fost trimis, este o idee bună să verificați gateway-ul dvs. SMS, pentru a vedea ce a primit. Puteți verifica jurnalul deschizând detaliile utilizatorului HTTP din consola de management Ozeki SMS Gateway. Următorul videoclip vă arată ce să căutați.

Cum să verificați că SMS-ul a fost trimis către rețeaua mobilă

Pasul final în verificarea procedurii este să vă uitați la jurnalele conexiunii cu rețeaua mobilă. S-ar putea să fie nevoie să activați jurnalizarea în configurația conexiunii înainte de a trimite mesajul pentru a vedea jurnalele. Dacă jurnalizarea este activată, veți vedea numărul de telefon și textul mesajului pe care l-ați trimis.

Pentru a activa jurnalizarea în http_user, trebuie să urmați aceleași instrucțiuni.

Concluzie

Acest ghid oferă toate informațiile necesare despre cum să trimiteți mesaje SMS din Node.js cu utilizatorul HTTP al Ozeki SMS Gateway. Trebuie să configurați o conexiune de utilizator HTTP în Ozeki SMS Gateway și să folosiți programul furnizat pentru aplicația dvs. Node.js, astfel această soluție oferă o conexiune foarte fiabilă și mesagerie rapidă. Utilizarea acestui serviciu vă ajută să faceți munca să meargă mai ușor, deoarece vă oferă posibilitatea să remodelați mediul de lucru în funcție de nevoile angajaților și ale dumneavoastră.

Găsiți mai multe articole pentru a vă ajuta pe site-ul Ozeki, așa că asigurați-vă că continuați să citiți. Apoi, aflați Cum să trimiteți mai multe SMS din Node.js.

Descărcați Ozeki SMS Gateway! Este simplu să-l configurați, faceți-o acum!