Jak wysłać SMS z Node.js
Najprostszym sposobem wysyłania SMS-ów z Node.js jest użycie wbudowanego interfejsu HTTP/Rest SMS API Ozeki SMS Gateway. Korzystając z tego API, będziesz wysyłać wiadomości SMS, wysyłając żądanie HTTP Post do bramki SMS. Żądanie HTTP Post będzie zawierać wiadomość sformatowaną w formacie json. Bramka SMS wyśle tę wiadomość na telefon odbiorcy i zwróci odpowiedź HTTP 200 OK na Twoje żądanie.
Kod JavaScript do wysyłania SMS-ów na telefon
Poniższy przykładowy kod JavaScript do wysyłania SMS-ów demonstruje, jak możesz wysyłać SMS-y, korzystając z interfejsu HTTP REST SMS API Ozeki SMS Gateway przy użyciu biblioteki JavaScript Ozeki.Libs.Rest. Ta biblioteka jest dostarczana bezpłatnie i możesz jej używać oraz modyfikować w dowolnym z Twoich projektów.
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());
Jak używać przykładu kodu JavaScript do wysyłania SMS-ów:
Możesz użyć klasy Message do tworzenia SMS-ów, a klasy MessageApi do wysyłania SMS-ów do bramki SMS. Bramka SMS przekaże Twoją wiadomość do sieci komórkowej poprzez połączenie bezprzewodowe lub przez Internet.
Pobierz SendSms.js
Kod źródłowy omówiony w tym artykule można pobrać, używać i modyfikować bezpłatnie.
Pobierz: SendSms.js.zip (4.35Kb)
Co znajduje się w pliku SendSMS.js.zip?
Plik SendSms.js.zip zawiera bibliotekę Ozeki.Libs.Rest, która dostarcza wszystkich narzędzi niezbędnych do wysyłania i odbierania wiadomości SMS. Znajdziesz tam również plik SendSms.mjs w projekcie, który zawiera przykładowy kod pokazujący, jak wysłać SMS. Ten przykładowy kod jest wymieniony poniżej.
Ten projekt ma zależności, więc przed rozpoczęciem należy zainstalować pakiet node-fetch za pomocą następującej komendy:
npm install node-fetch
Jak wysłać SMS z Node.js (Szybkie kroki)
Aby wysłać SMS z Node.js:
- Zainstaluj Ozeki SMS Gateway
- Podłącz Ozeki SMS Gateway do sieci komórkowej
- Wyślij testowy SMS z interfejsu Ozeki
- Utwórz użytkownika HTTP SMS API
- Visual Studio Code lub Notatnik Windows
- Pobierz przykładowy projekt powyżej
- Utwórz SMS, tworząc nowy obiekt Message
- Utwórz API do wysłania wiadomości
- Użyj metody Send do wysłania wiadomości
- Odczytaj odpowiedź w konsoli
- Sprawdź logi w bramce SMS
Zainstaluj Ozeki SMS Gateway i utwórz użytkownika HTTP API
Aby móc wysyłać SMS-y z Node.js, najpierw musisz zainstalować Ozeki SMS Gateway. Bramka SMS może być zainstalowana na tym samym komputerze, na którym tworzysz swój kod JavaScript w Visual Studio Code lub innym edytorze kodu. Po instalacji następnym krokiem jest podłączenie Ozeki SMS Gateway do sieci komórkowej. Możesz wysłać testowy SMS z interfejsu Ozeki, aby sprawdzić, czy Twoje połączenie z siecią komórkową działa. Ostatnim krokiem przygotowania środowiska jest utworzenie użytkownika HTTP SMS API. Utwórz użytkownika z nazwą "http_user" i hasłem "qwe123", aby przykład działał bez modyfikacji.
Po skonfigurowaniu środowiska możesz uruchomić swój kod JavaScript.
URL API HTTP do wysyłania SMS-ów z Node.js
Aby wysyłać SMS-y z Node.js, Twój JavaScript będzie musiał wysłać żądanie HTTP do bramki SMS. URL API jest pokazany poniżej. Pamiętaj, że adres IP (127.0.0.1) powinien zostać zastąpiony adresem IP Twojej bramki SMS. Jeśli Ozeki SMS Gateway jest zainstalowana na tym samym komputerze, na którym działa aplikacja JavaScript do wysyłania SMS-ów, może to być 127.0.0.1. Jeśli jest zainstalowana na innym komputerze, powinien to być adres IP tego komputera.
http://127.0.0.1:9509/api?action=rest
Uwierzytelnianie HTTP do wysyłania SMS-ów z JavaScript
Aby uwierzytelnić klienta SMS w Node.js, musisz wysłać nazwę użytkownika i hasło w zakodowanym ciągu base64 do serwera w żądaniu HTTP. Używany format to: base64(nazwa_użytkownika+":"+hasło). W JavaScript możesz użyć następującego kodu do wykonania tego kodowania:
var usernamePassword = username + ":" + password;
return `Basic ${Base64.encode(usernamePassword)}`;
Na przykład, jeśli zakodujesz nazwę użytkownika 'http_user' i hasło 'qwe123', otrzymasz następujący zakodowany ciąg base64: aHR0cF91c2VyOnF3ZTEyMw==. Aby wysłać
Nagłówek żądania HTTP do wysyłania SMS z JavaScript
Aby wysłać wiadomości SMS, należy dołączyć następujące linie jako nagłówki w żądaniu HTTP. Należy zauważyć, że zawieramy typ zawartości i nagłówek autoryzacji.
Content-Type: application/json Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Żądanie HTTP do wysyłania SMS z Node.Js
Aby przesłać SMS, Twoja aplikacja Node.Js wyśle żądanie HTTP podobne do poniższego. Należy zauważyć, że to żądanie zawiera część nagłówka HTTP i część ciała HTTP. Ciało HTTP to ciąg danych zakodowany w formacie JSON. Zawiera numer odbiorcy i tekst wiadomości.
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
}
]
}
Odpowiedź HTTP otrzymana przez przykład SMS w JavaScript
Po otrzymaniu tego żądania, brama SMS wygeneruje odpowiedź HTTP. Odpowiedź HTTP będzie zawierać kod statusu, aby wskazać, czy żądanie wysłania SMS zakończyło się sukcesem, czy nie. Zwróci również strukturę zakodowaną w JSON, aby dostarczyć przydatne informacje o przesłaniu wiadomości.
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"
}
]
}
}
Jak wysłać SMS z Node.Js za pomocą API SMS (Samouczek wideo)
Ten film pokazuje, jak pobrać i użyć projektu SendSms.js. Po dodaniu potrzebnych plików do projektu, możesz zauważyć, że istnieje plik o nazwie Ozeki.Lbis.Rest.js. To plik zawierający MessageApi i wszystko, czego potrzebujesz, aby wysłać SMS za pomocą JavaScript.
Przykład SMS w Node.Js: SendSms.mjs (w Notatniku)
Na tym obrazku można znaleźć kod źródłowy projektu, otwarty w notatniku (Rysunek 3). Jak widać, można go otworzyć w notatniku i edytować również w nim. Jeśli znasz Node.js, możesz zmienić zmienne w kodzie i wysłać spersonalizowaną wiadomość na swój adres.
Przykład SMS w Node.Js: SendSms.mjs (w Visual Studio Code)
Jeśli szukasz bardziej zaawansowanego sposobu otwierania kodu źródłowego, spróbuj użyć Visual Studio Code (Rysunek 4). Oferuje kolorowanie składni, więcej pomocy i automatyczne uzupełnianie. To lekkie środowisko IDE (Integrated Development Environment), które jest open-source i darmowe do użytku.
Jak sprawdzić, czy SMS został zaakceptowany przez użytkownika HTTP
Po przesłaniu SMS, warto sprawdzić w bramie SMS, co zostało odebrane. Możesz sprawdzić log, otwierając szczegóły użytkownika HTTP w konsoli zarządzania Ozeki SMS Gateway. Poniższy film pokazuje, na co zwrócić uwagę.
Jak sprawdzić, czy SMS został wysłany do sieci komórkowej
Ostatnim krokiem weryfikacji procedury jest spojrzenie na logi połączenia z siecią komórkową. Może być konieczne włączenie logowania w konfiguracji połączenia przed wysłaniem wiadomości, aby zobaczyć logi. Jeśli logowanie jest włączone, zobaczysz numer telefonu i tekst wysłanej wiadomości.
Aby włączyć logowanie w http_user, należy postępować zgodnie z takimi samymi instrukcjami.
Podsumowanie
Ten przewodnik zawiera wszystkie niezbędne informacje na temat wysyłania wiadomości SMS z Node.js przy użyciu użytkownika HTTP w Ozeki SMS Gateway. Musisz skonfigurować połączenie użytkownika HTTP w Ozeki SMS Gateway i użyć podanego programu dla swojej aplikacji Node.js, dzięki czemu to rozwiązanie zapewnia bardzo niezawodne połączenie i szybkie przesyłanie wiadomości. Korzystanie z tej usługi pomaga usprawnić pracę, ponieważ daje możliwość dostosowania środowiska pracy do potrzeb Twoich pracowników i Twoich własnych.
Na stronie Ozeki znajdziesz więcej artykułów, które mogą Ci pomóc, więc koniecznie kontynuuj czytanie. Następnie dowiedz się, jak wysyłać wiele SMS-ów z Node.js.
Pobierz Ozeki SMS Gateway! Konfiguracja jest prosta, zrób to teraz!
More information
- Node js wyślij SMS za pomocą interfejsu HTTP REST API (przykładowy kod)
- Node js wyślij wiele SMS za pomocą interfejsu HTTP REST API (przykładowy kod)
- Node js zaplanuj SMS za pomocą interfejsu HTTP REST API (przykładowy kod)
- Node js odbierz SMS za pomocą interfejsu HTTP REST API (przykładowy kod)
- Node js usuń SMS za pomocą interfejsu HTTP REST API (przykładowy kod)
- Github Node js SMS API
- Samouczek Node js Hello world