Hogyan küldjünk SMS-t Node.js-ből

A legegyszerűbb módja SMS küldésének Node.Js-ből az Ozeki SMS Gateway beépített HTTP/Rest SMS API-jának használata. Amikor ezt az API-t használod, SMS üzeneteket küldhetsz HTTP POST kérések kiadásával az SMS gateway felé. A HTTP POST kérés egy JSON formátumban formázott üzenetet fog tartalmazni. Az SMS gateway továbbítja ezt az SMS-t a címzett telefonszámára, és egy HTTP 200 OK választ küld vissza a kérésedre.

hogyan küldjünk sms-t node js-ből
1. ábra - Hogyan küldjünk SMS-t Node.Js-ből

JavaScript kód SMS küldésére mobilra

Az alábbi JavaScript SMS kód minta bemutatja, hogyan küldhetsz SMS-t az Ozeki SMS Gateway HTTP REST SMS API-jával a JavaScript Ozeki.Libs.Rest könyvtár segítségével. Ez a könyvtár ingyenesen elérhető, és bármely projektjében felhasználhatja és módosíthatja.

SendSms.mjs 
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());

A JavaScript SMS példa használata:

A Message osztály segítségével hozhatod létre az SMS-t, és a MessageApi osztály segítségével küldheted az SMS-t az SMS gatewaynek. Az SMS gateway továbbítja az üzenetedet a mobilhálózatnak vezeték nélküli kapcsolaton vagy az interneten keresztül.

SendSms.js letöltése

A cikkben ismertetett forráskód letölthető, felhasználható és módosítható ingyenesen.
Letöltés: SendSms.js.zip (4.35Kb)

Mi található a SendSMS.js.zip fájlban?

A SendSms.js.zip fájl tartalmazza az Ozeki.Libs.Rest könyvtárat, amely minden szükséges eszközt biztosít SMS üzenetek küldéséhez és fogadásához. A projektben találsz egy SendSms.mjs fájlt is, amely tartalmazza a példakódot, amely bemutatja, hogyan küldj egy SMS-t. Ez a példakód az alábbiakban látható.

példa projekt sms küldésére node js használatával
2. ábra - SendSms.js könyvtár

Ennek a projektnek vannak függőségei, ezért a kezdés előtt telepítened kell a node-fetch csomagot a következő paranccsal: 

npm install node-fetch

1. kód - Parancs a node-fetch csomag telepítéséhez

.

Hogyan küldjünk SMS-t Node.Js-ből (Gyors lépések)

SMS küldése Node.Js-ből:

  1. Telepítsd az Ozeki SMS Gateway-t
  2. Kapcsold az Ozeki SMS Gateway-t a mobilhálózathoz
  3. Küldj egy teszt SMS-t az Ozeki GUI-ból
  4. Hozz létre egy HTTP SMS API felhasználót
  5. Visual Studio Code vagy Windows Jegyzettömb
  6. Töltsd le a fenti példa projektet
  7. Hozd létre az SMS-t egy új Message objektum létrehozásával
  8. Hozz létre egy API-t az üzeneted küldéséhez
  9. Használd a Send metódust az üzeneted küldéséhez
  10. Olvasd el a válaszüzenetet a konzolon
  11. Ellenőrizd a naplókat az SMS gateway-ben

Ozeki SMS Gateway telepítése és HTTP API felhasználó létrehozása

Ahhoz, hogy SMS-t tudj küldeni Node.Js-ből, először telepítened kell az Ozeki SMS Gateway-t. Az SMS gateway telepíthető ugyanarra a számítógépre, ahol a JavaScript kódodat fejleszted a Visual Studio Code-ban vagy bármely más kódszerkesztőben. A telepítés után a következő lépés az, hogy az Ozeki SMS Gateway-t csatlakoztatod a mobilhálózathoz. létrehozol egy HTTP SMS API felhasználót. Hozz létre egy felhasználót "http_user" felhasználónévvel és "qwe123" jelszóval, hogy a példa módosítás nélkül működjön.

Miután a környezet be van állítva, futtathatod a JavaScript kódodat.

HTTP API URL SMS küldéséhez Node.Js-ből

Ahhoz, hogy SMS-t küldj Node.Js-ből, a JavaScriptednek HTTP kérést kell küldenie az SMS gatewaynek. Az API URL az alábbiakban látható. Figyelj arra, hogy az IP cím (127.0.0.1) helyére az SMS gateway IP címét kell beírnod. Ha az Ozeki SMS Gateway ugyanarra a számítógépre van telepítve, ahol a JavaScript SMS alkalmazás fut, ez lehet 127.0.0.1. Ha másik számítógépre van telepítve, annak az IP címét kell megadnod. 

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

HTTP hitelesítés SMS küldéséhez JavaScriptből

A Node.Js SMS kliens hitelesítéséhez a felhasználónevet és a jelszót base64 kódolt sztringként kell elküldened a szervernek egy HTTP kérésben. A használt formátum: base64(username+":"+password). JavaScriptben a következő kódot használhatod ehhez a kódoláshoz: 

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

Például, ha a 'http_user' felhasználónevet és a 'qwe123' jelszót kódolod, a következő base64 kódolt sztringet kapod: aHR0cF91c2VyOnF3ZTEyMw==.

HTTP kérés fejléc SMS küldéséhez JavaScriptből

Az SMS üzenetek küldéséhez a következő sorokat kell belefoglalnod fejlécnek az HTTP kérésbe. Figyelj arra, hogy egy tartalomtípust és egy Authorization fejlécet is tartalmazunk. 

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

HTTP kérés SMS küldéséhez Node.Js-ből

Az SMS beküldéséhez a Node.Js alkalmazásod egy olyan HTTP kérést fog küldeni, mint az alábbi. Figyelj arra, hogy ez a kérés tartalmaz egy HTTP fejléc részt és egy HTTP törzs részt. Az HTTP törzs egy JSON kódolt adatsztring. Tartalmazza a címzett számát és az üzenet szövegét. 

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
		}
	]
}

HTTP válasz, amit a JavaScript SMS példa kap

Amint az SMS gateway megkapja ezt a kérést, generál egy HTTP választ. Az HTTP válasz tartalmazni fog egy állapotkódot, amely jelzi, hogy az SMS beküldési kérés sikeres volt-e vagy sem. Egy JSON kódolt struktúrát is visszaad, amely hasznos részleteket nyújt az üzenet beküldéséről. 

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"
	    }
	  ]
	}
}

Hogyan küldjünk SMS-t Node.Js-ből az SMS API-val (Videó útmutató)

Ez a videó bemutatja, hogyan töltsd le és használd a SendSms.js projektet. Miután hozzáadtad a szükséges fájlokat a projektedhez, észreveheted, hogy van egy Ozeki.Lbis.Rest.js nevű fájl. Ez a fájl tartalmazza a MessageApi-t és minden szükséges eszközt az SMS küldéséhez JavaScript használatával.

1. videó - Hogyan töltsd le az Ozeki.Libs.Rest-et és állítsd be a projektet (Videó útmutató)

Node.Js SMS példa: SendSms.mjs (Jegyzettömbben)

Ezen a képen megtalálod a projekt forráskódját, amelyet egy jegyzettömbben nyitottunk meg (3. ábra). Láthatod, hogy egy jegyzettömbben is megnyitható és szerkeszthető. Ha ismered a Node.js-t, nyugodtan módosíthatod a változókat a kódban, és testreszabott üzenetet küldhetsz a saját címedre.

javascript példa sms küldésére
3. ábra - SendSms.mjs Jegyzettömbben

Node.Js SMS példa: SendSms.mjs (Visual Studio Code-ban)

Ha kifinomultabb módon szeretnéd megnyitni a forráskódot, próbáld ki a Visual Studio Code-ot (4. ábra). Ez színkódolást, több segítséget és automatikus kiegészítést kínál. Ez egy könnyű IDE (Integrált Fejlesztői Környezet), amely nyílt forráskódú és ingyenesen használható.

4. ábra - SendSms.mjs Visual Studio Code-ban

Hogyan ellenőrizd, hogy az SMS-t elfogadta-e az HTTP felhasználó

Miután elküldted az SMS-t, érdemes megnézned az SMS gatewayt, hogy mit kapott meg. A naplót az Ozeki SMS Gateway kezelőfelületén az HTTP felhasználó részleteinek megnyitásával ellenőrizheted. A következő videó bemutatja, hogy mit kell keresned.

2. videó - SMS küldése a fenti JavaScript kóddal (Videó útmutató)

Hogyan ellenőrizd, hogy az SMS el lett-e küldve a mobilhálózatnak

A folyamat ellenőrzésének utolsó lépése, hogy megnézed a mobilhálózati kapcsolat naplóit. Lehet, hogy be kell kapcsolnod a naplózást a kapcsolat beállításaiban, mielőtt elküldöd az üzenetet, hogy lásd a naplókat. Ha a naplózás be van kapcsolva, látni fogod a telefonszámot és az elküldött üzenet szövegét.

3. videó - Hogyan kapcsold be a naplózást az Ozeki SMS Gateway-ben (Videó útmutató)

A naplózás bekapcsolásához az http_user-ben ugyanezeket az utasításokat kell követned.

Összegzés

Ez az útmutató minden szükséges információt tartalmaz arról, hogyan küldj SMS üzeneteket Node.js-ből az Ozeki SMS Gateway HTTP felhasználójával. Be kell állítanod egy HTTP felhasználói kapcsolatot az Ozeki SMS Gateway-ben, és használnod kell a megadott programot a Node.js alkalmazásodhoz, így ez a megoldás nagyon megbízható kapcsolatot és gyors üzenetküldést biztosít. Ennek a szolgáltatásnak a használata segít a munka simábbá tételében, mert lehetőséget ad a munkakörnyezet átalakítására az alkalmazottaid és a saját igényeid szerint.

További cikkeket találsz az Ozeki weboldalán, hogy segítsenek neked, ezért mindenképpen olvass tovább. Következő lépésként tanuld meg, Hogyan küldj több SMS-t Node.js-ből.

Töltsd le az Ozeki SMS Gateway-t! Egyszerű beállítani, tedd meg most!

More information