Jak stworzyć serwer SMS OTP bez Twilio

Budowanie bezpiecznego procesu weryfikacji użytkowników nie powinno wymagać przechodzenia przez nieskończone zatwierdzenia operatorów ani płacenia wygórowanych stawek za każdą wiadomość. W tym poradniku pokażemy Ci, jak stworzyć serwer SMS OTP przy użyciu własnego sprzętu z systemem Android i lokalnego backendu, omijając wysokie koszty i biurokrację tradycyjnych dostawców SMS A2P.

Dlaczego warto zbudować własny serwer SMS OTP?

Kiedy programiści szukają najlepszych API do połączeń wychodzących i SMS-ów z systemów backendowych, często są kierowani do tradycyjnych gigantów telekomunikacyjnych, takich jak Twilio, Vonage czy MessageBird. Jednak dla niezależnych twórców, startupów i właścicieli małych firm spoza USA platformy te stają się coraz mniej praktyczne. Przez obowiązkową rejestrację 10DLC, opłaty weryfikacyjne operatorów i skomplikowane procesy konfiguracji, sama próba wysłania jednorazowego hasła (OTP) może zająć tygodnie pracy administracyjnej.

Co więcej, tradycyjne bramki rozliczają użytkowników za każdy segment o długości 160 znaków i pobierają wysokie opłaty bazowe. Jeśli budujesz usługę lokalną — taką jak system rezerwacji w przychodni, portal szkoły jazdy czy system śledzenia obecności — potrzebujesz taniego API SMS, które po prostu działa. Ucząc się, jak stworzyć własną bramkę SMS za pomocą telefonu z systemem Android, całkowicie omijasz rejestrację u operatorów i wysyłasz wiadomości bezpośrednio z numeru, który Twoi klienci już znają.

Porównanie tradycyjnych API SMS i bramki Android MySMSGate

Poniżej znajduje się bezpośrednie porównanie wymagań związanych z wysyłaniem transakcyjnych SMS-ów i kodów OTP za pośrednictwem tradycyjnych API w porównaniu z bramką opartą na systemie Android, taką jak MySMSGate.

Krok 1: Utwórz konto i zaloguj się do aplikacji MySMSGate

Aby zmienić urządzenie z systemem Android w programowalną bramkę SMS, potrzebujesz usługi pośredniczącej, która połączy Twój kod backendowy z systemem operacyjnym Android. W tym miejscu z pomocą przychodzi MySMSGate.

Najpierw przejdź do strony rejestracji MySMSGate, aby utworzyć darmowe konto. Po zalogowaniu na pulpicie nawigacyjnym zobaczysz swój klucz API oraz unikalny kod QR. Ten kod QR eliminuje potrzebę ręcznego kopiowania i wklejania długich danych uwierzytelniających API na urządzenie mobilne.

Następnie pobierz na swój telefon powiązaną aplikację na system Android. Otwórz aplikację, wybierz opcję skanowania kodu QR konfiguracji i skieruj aparat na ekran komputera. Aplikacja automatycznie się skonfiguruje, ustanowi bezpieczne połączenie za pomocą powiadomień push (aby pozostać aktywną w trybie uśpienia) i połączy fizyczne gniazda kart SIM z panelem programisty. Teraz możesz już przesyłać programistyczne wiadomości przez swój telefon.

Krok 2: Skonfiguruj sprzęt (telefon i mini PC)

Wielu programistów pyta: jak mogę stworzyć własne API SMS lokalnie za pomocą telefonu i mini PC? Architektura sprzętowa dla lokalnego, samodzielnie hostowanego serwera OTP jest niezwykle prosta i niezawodna. Nie potrzebujesz drogich szaf serwerowych; podstawowy mini PC (taki jak Intel NUC lub Raspberry Pi) z systemem Linux, połączony z zapasowym telefonem z Androidem, w zupełności wystarczy.

Podłącz swój mini PC do sieci lokalnej. Ten mini PC będzie hostować główną bazę danych aplikacji i logikę backendu (np. Node.js, Python lub Go). Twój telefon z Androidem nie musi być fizycznie podłączony do mini PC przez USB. Ponieważ MySMSGate obsługuje komunikację za pomocą bezpiecznych webhooków w chmurze i punktów końcowych API, Twój telefon potrzebuje jedynie stabilnego połączenia Wi-Fi lub komórkowej transmisji danych. Pozwala to na umieszczenie telefonu w miejscu o optymalnym zasięgu sieci komórkowej, nawet jeśli Twój mini PC jest schowany w szafie serwerowej.

Wykorzystanie obsługi Dual SIM i wielu urządzeń

Jeśli prowadzisz firmę z wieloma oddziałami lub chcesz oddzielić transakcyjny ruch OTP od powiadomień marketingowych, możesz podłączyć nieograniczoną liczbę telefonów z Androidem do jednego konta MySMSGate. Jeśli Twój telefon obsługuje dwie karty SIM (Dual SIM), platforma pozwala na programowe wybieranie gniazda SIM, z którego ma zostać wysłane każde wychodzące połączenie API, dając Ci pełną kontrolę nad trasowaniem i lokalnymi stawkami operatorów.

Krok 3: Napisz kod serwera OTP

Teraz, gdy Twój sprzęt jest połączony, możesz napisać logikę backendu do generowania, przechowywania i wysyłania jednorazowych haseł. Poniżej znajduje się kompletny, lekki przykład w Node.js, pokazujący jak wygenerować bezpieczny 6-cyfrowy kod OTP, zapisać go w pamięci wraz z czasem wygaśnięcia i wysłać za pośrednictwem REST API MySMSGate.

const axios = require('axios');

// In-memory store for demonstration (use Redis in production)
const otpCache = new Map();

const MYSMSGATE_API_URL = 'https://mysmsgate.net/api/v1/send';
const API_KEY = 'YOUR_MYSMSGATE_API_KEY';

async function generateAndSendOTP(phoneNumber) {
  // Generate a cryptographically secure 6-digit code
  const otp = Math.floor(100000 + Math.random() * 900000).toString();
  const expiresAt = Date.now() + 5 * 60 * 1000; // 5 minutes expiry

  // Store OTP details
  otpCache.set(phoneNumber, { otp, expiresAt });

  // Prepare payload for MySMSGate API
  const payload = {
    to: phoneNumber,
    message: `Your verification code is ${otp}. It will expire in 5 minutes.`
  };

  try {
    const response = await axios.post(MYSMSGATE_API_URL, payload, {
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      }
    });
    console.log('OTP dispatched successfully:', response.data);
    return { success: true };
  } catch (error) {
    console.error('Failed to dispatch OTP via MySMSGate:', error.response ? error.response.data : error.message);
    return { success: false, error: 'SMS gateway communication failure' };
  }
}

Ta czysta integracja z REST API wymaga tylko jednego żądania POST do wysłania wiadomości. Nie ma potrzeby utrzymywania skomplikowanych bibliotek SDK, co ułatwia przeniesienie tej logiki do języków Python, Go, PHP lub Ruby przy użyciu naszej standardowej dokumentacji integracji.

Krok 4: Dodaj weryfikację i śledzenie za pomocą webhooków

Wysłanie kodu OTP to tylko połowa sukcesu; Twój serwer musi również zweryfikować wpisany przez użytkownika kod i sprawdzić, czy SMS rzeczywiście dotarł na jego telefon. Aby zweryfikować kod po przesłaniu go przez użytkownika, zaimplementuj prosty punkt końcowy weryfikacji na backendzie swojego mini PC:

function verifyOTP(phoneNumber, userSubmittedCode) {
  const record = otpCache.get(phoneNumber);
  if (!record) {
    return { verified: false, reason: 'No OTP requested or code expired' };
  }

  if (Date.now() > record.expiresAt) {
    otpCache.delete(phoneNumber);
    return { verified: false, reason: 'OTP has expired' };
  }

  if (record.otp === userSubmittedCode) {
    otpCache.delete(phoneNumber); // Clear code after successful use
    return { verified: true };
  } 

  return { verified: false, reason: 'Incorrect code' };
}

Aby monitorować status dostarczenia w czasie rzeczywistym, skonfiguruj adres URL webhooka w panelu MySMSGate. Za każdym doomed, gdy Twój telefon z Androidem wyśle wiadomość i otrzyma raport doręczenia od operatora, MySMSGate prześle aktualizację statusu z powrotem do Twojego lokalnego serwera. Jeśli wiadomość nie zostanie dostarczona z powodu nieprawidłowego numeru lub błędu operatora, saldo Twojego konta zostanie automatycznie zwrócone, dzięki czemu nigdy nie zapłacisz za niedostarczone próby weryfikacji.

Rozbudowa serwera: Śledzenie obecności i powiadomienia

Gdy już zrozumiesz, jak skonfigurować serwer SMS OTP, możesz łatwo dostosować tę samą infrastrukturę backendową do obsługi innych procesów biznesowych. Na przykład lokalne centra edukacyjne, szkoły korepetycji i kluby sportowe często pytają, jak stworzyć system śledzenia obecności z automatycznymi SMS-ami do rodziców.

Łącząc cyfrową listę obecności lub kiosk do meldowania się z backendem na mini PC, możesz wyzwalać automatyczne powiadomienia wychodzące. Gdy uczeń zeskanuje swój identyfikator lub się zamelduje, Twój system może natychmiast wywołać API MySMSGate, aby wysłać spersonalizowaną wiadomość: „Dzień dobry, Twoje dziecko dotarło bezpiecznie do centrum korepetycji o godzinie 15:15.”

Podobnie lokalne firmy usługowe, takie jak warsztaty samochodowe, gabinety stomatologiczne czy salony fryzjerskie, mogą użyć tej konfiguracji do tworzenia szablonów powiadomień SMS o potwierdzeniach rezerwacji, przypomnieniach o wizytach czy powiadomieniach o gotowości do odbioru. Ponieważ wysyłasz te powiadomienia z własnej karty SIM, klienci mogą odpowiedzieć bezpośrednio na SMS. Odpowiedzi te są przekazywane z powrotem do Twojego panelu MySMSGate w czasie rzeczywistym, co pozwala na prowadzenie dwustronnej konwersacji z poziomu przeglądarki, bez konieczności sięgania po telefon.

Najczęściej zadawane pytania (FAQ)

Znajdź odpowiedzi na najczęściej zadawane pytania dotyczące budowy własnej lokalnej bramki SMS i serwera OTP.

Jak mogę stworzyć własne API SMS lokalnie za pomocą telefonu i mini PC?

Aby stworzyć lokalne API SMS, skonfiguruj mini PC (taki jak Raspberry Pi lub Intel NUC) z backendem aplikacji i połącz go z telefonem z Androidem, na którym działa aplikacja MySMSGate. Mini PC generuje treść SMS-a i wysyła ją do punktu końcowego REST API MySMSGate. Bramka w chmurze przekazuje żądanie do połączonego telefonu z systemem Android za pomocą bezpiecznych powiadomień push, a fizyczna karta SIM w telefonie wysyła SMS lokalnie.

Czy potrzebuję zgody operatora lub rejestracji 10DLC, aby wysyłać kody OTP?

Nie. Ponieważ MySMSGate kieruje wiadomości przez Twój własny prywatny lub służbowy telefon z Androidem i kartę SIM, nie musisz rejestrować się w A2P 10DLC, przechodzić weryfikacji marki ani czekać na zgody operatorów. Możesz zacząć wysyłać powiadomienia transakcyjne i kody weryfikacyjne natychmiast po skonfigurowaniu aplikacji.

Jak MySMSGate radzi sobie z niedostarczonymi SMS-ami?

Jeśli SMS nie zostanie dostarczony z powodu problemów z siecią, nieprawidłowego numeru telefonu lub braku środków u operatora na karcie SIM, MySMSGate śledzi status niepowodzenia za pomocą webhooków i automatycznie zwraca opłatę API w wysokości 0,02 $ na saldo Twojego konta. Płacisz tylko za wiadomości, które zostały pomyślnie wysłane z Twojego urządzenia.

Czy mogę używać dwóch kart SIM do wysyłania kodów OTP?

Tak. Aplikacja MySMSGate na system Android w pełni obsługuje urządzenia z Dual SIM. Podczas wykonywania żądania POST do naszego API możesz programowo określić, które gniazdo SIM (SIM 1 czy SIM 2) ma zostać użyte do wysłania wiadomości, co pozwala zoptymalizować koszty w oparciu o stawki lokalnych operatorów.