Як створити SMS OTP сервер без Twilio

Створення безпечного процесу верифікації користувачів не повинно вимагати нескінченних погоджень з операторами зв'язку або сплати непомірних тарифів за кожне повідомлення. У цьому посібнику ми покажемо вам, як створити SMS OTP сервер, використовуючи власне Android-обладнання та локальний бекенд, обходячи високі витрати та бюрократію традиційних постачальників A2P SMS.

Навіщо створювати власний SMS OTP сервер?

Коли розробники шукають найкращі API для вихідних дзвінків та SMS із бекенд-систем, їх часто спрямовують до застарілих телекомунікаційних гігантів, таких як Twilio, Vonage або MessageBird. Однак для незалежних розробників, стартапів та власників малого бізнесу за межами США ці платформи стають дедалі менш практичними. Через обов'язкову реєстрацію 10DLC, збори за перевірку операторами та складні процеси налаштування, звичайна спроба надіслати одноразовий пароль (OTP) може вимагати тижнів адміністративної роботи.

Крім того, традиційні шлюзи тарифікують кожну частину повідомлення по 160 символів і стягують високу базову плату. Якщо ви створюєте локальний сервіс — наприклад, систему запису до клініки, портал автошколи чи трекер відвідуваності — вам потрібен дешевий SMS API, який просто працює. Дізнавшись, як створити власний SMS-шлюз за допомогою телефону Android, ви повністю обійдете реєстрацію у операторів і зможете надсилати повідомлення безпосередньо з номера, який ваші клієнти вже знають.

Порівняння традиційних SMS API та Android-шлюзу MySMSGate

Нижче наведено пряме порівняння того, що потрібно для надсилання транзакційних SMS та OTP через традиційні API порівняно з використанням шлюзу на базі Android, такого як MySMSGate.

Крок 1: Створіть обліковий запис та увійдіть у додаток MySMSGateway

Щоб перетворити пристрій Android на програмований SMS-шлюз, вам потрібен посередницький сервіс, який пов'яже ваш бекенд-код з операційною системою Android. Саме тут на допомогу приходить MySMSGate.

Спочатку перейдіть на сторінку реєстрації MySMSGate, щоб створити безкоштовний обліковий запис. Після входу в систему на вашій веб-панелі з'являться API-ключ та унікальний QR-код. Цей QR-код позбавляє необхідності вручну копіювати та вставляти довгі облікові дані API на свій мобільний пристрій.

Далі завантажте супутній додаток Android на свій телефон. Відкрийте додаток, виберіть опцію сканування QR-коду налаштування та наведіть камеру на екран комп'ютера. Додаток автоматично налаштується, встановить безпечне з'єднання за допомогою push-сповіщень (щоб залишатися активним у режимі сну) та зв'яже слоти вашої фізичної SIM-карти з панеллю розробника. Тепер ви готові до маршрутизації програмних повідомлень через свій телефон.

Крок 2: Налаштуйте обладнання (телефон та міні-ПК)

Багато розробників запитують: як я можу створити власний SMS API локально за допомогою телефону та міні-ПК? Апаратна архітектура для локального OTP-сервера з власним хостингом є надзвичайно простою та стійкою. Вам не потрібні дорогі серверні стійки; базового міні-ПК (наприклад, Intel NUC або Raspberry Pi) під керуванням Linux у поєднанні з резервним Android-телефоном буде більш ніж достатньо.

Підключіть свій міні-ПК до локальної мережі. На цьому міні-ПК буде розміщено основну базу даних вашої програми та логіку бекенду (наприклад, Node.js, Python або Go). Ваш телефон Android не обов'язково підключати до міні-ПК фізично через USB. Оскільки MySMSGate здійснює зв'язок через безпечні хмарні вебхуки та кінцеві точки API, вашому телефону потрібне лише стабільне підключення до Wi-Fi або мобільного інтернету. Це дозволяє розмістити телефон у зоні з найкращим прийомом стільникового зв'язку, навіть якщо ваш міні-ПК захований у серверній шафі.

Використання переваг Dual SIM та підтримки кількох пристроїв

Якщо ви ведете бізнес із кількома філіями або хочете відокремити транзакційний трафік OTP від маркетингових розсилок, ви можете підключити необмежену кількість телефонів Android до одного облікового запису MySMSGate. Якщо ваш телефон підтримує дві SIM-карти (Dual SIM), платформа дозволяє програмно вибирати, з якого слоту SIM-карти надсилати кожне вихідне повідомлення через API, що дає вам повний контроль над маршрутизацією та тарифами місцевих операторів.

Крок 3: Напишіть код для OTP-сервера

Тепер, коли ваше обладнання підключено, ви можете написати логіку бекенду для генерації, збереження та відправки одноразових паролів. Нижче наведено повний, легкий приклад на Node.js, який демонструє, як згенерувати безпечний 6-значний OTP, зберегти його в пам'яті з позначкою часу закінчення терміну дії та надіслати через 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' };
  }
}

Ця чиста інтеграція з REST API вимагає лише одного POST-запиту для відправки повідомлення. Не потрібно підтримувати складні SDK, що дозволяє легко перенести цю логіку на Python, Go, PHP або Ruby, використовуючи нашу стандартну документацію з інтеграції.

Крок 4: Додайте верифікацію та відстеження через вебхуки

Надіслати OTP — це лише половина справи; ваш сервер також повинен перевірити введені користувачем дані та відстежити, чи дійсно SMS дійшло до його телефону. Щоб перевірити код, коли користувач його надсилає, реалізуйте просту кінцеву точку верифікації на бекенді вашого міні-ПК:

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' };
}

Щоб контролювати статус доставки в режимі реального часу, налаштуйте URL-адресу вебхука (webhook URL) на панелі керування MySMSGate. Щоразу, коли ваш телефон Android надсилає повідомлення та отримує звіт про доставку від оператора, MySMSGate надсилатиме оновлення статусу на ваш локальний сервер. Якщо повідомлення не вдалося доставити через недійсний номер або помилку оператора, баланс вашого рахунку автоматично повертається, гарантуючи, що ви ніколи не платите за недоставлені спроби верифікації.

Розширення можливостей сервера: відстеження відвідуваності та сповіщення

Щойно ви зрозумієте, як налаштувати SMS OTP сервер, ви зможете легко пристосувати ту саму інфраструктуру бекенду для інших бізнес-процесів. Наприклад, місцеві навчальні центри, школи репетиторства та спортивні клуби часто запитують, як створити відстеження відвідуваності з авто-SMS батькам.

Підключивши свій електронний журнал відвідуваності або кіоск реєстрації до бекенду на міні-ПК, ви можете налаштувати автоматичні вихідні сповіщення. Коли учень сканує свій бейдж або реєструється, ваша система може миттєво викликати API MySMSGate для надсилання персоналізованого повідомлення: «Вітаємо, ваша дитина успішно прибула до репетиторського центру о 15:15.»

Подібним чином місцеві сервісні підприємства, такі як автосервіси, стоматологічні клініки та салони краси, можуть використовувати це налаштування, щоб створювати шаблони SMS-сповіщень для підтвердження бронювань, нагадувань про візити та повідомлень про готовність замовлення. Оскільки ви надсилаєте ці сповіщення з власної SIM-карти, клієнти можуть відповідати безпосередньо на SMS. Ці відповіді пересилаються на вашу веб-панель MySMSGate у режимі реального часу, дозволяючи вам вести двосторонній діалог прямо з браузера, не беручи до рук телефон.

Часті запитання (FAQ)

Знайдіть відповіді на найпоширеніші запитання про створення власного локального SMS-шлюзу та OTP-сервера.

Як я можу створити власний SMS API локально за допомогою телефону та міні-ПК?

Щоб створити локальний SMS API, налаштуйте міні-ПК (наприклад, Raspberry Pi або Intel NUC) з бекендом вашої програми та підключіть його до телефону Android із встановленим додатком MySMSGate. Міні-ПК генерує вміст SMS і надсилає його на кінцеву точку REST API MySMSGate. Хмарний шлюз перенаправляє запит на ваш підключений телефон Android за допомогою безпечних push-сповіщень, а фізична SIM-карта телефону надсилає SMS локально.

Чи потрібне мені схвалення оператора або реєстрація 10DLC для надсилання OTP?

Ні. Оскільки MySMSGate маршрутизує повідомлення через ваш власний особистий або робочий телефон Android та SIM-карту, вам не потрібно реєструватися в A2P 10DLC, проходити верифікацію бренду або чекати на схвалення операторів. Ви можете почати надсилати транзакційні сповіщення та коди підтвердження одразу після налаштування додатка.

Як MySMSGate обробляє помилки доставки SMS?

Якщо SMS не вдалося доставити через проблеми з мережею, недійсний номер телефону або відсутність коштів на рахунку SIM-карти, MySMSGate відстежує статус помилки за допомогою вебхуків і автоматично повертає комісію API у розмірі $0.02 на баланс вашого рахунку. Ви платите лише за повідомлення, які були успішно відправлені з вашого пристрою.

Чи можу я використовувати дві SIM-карти для маршрутизації OTP-повідомлень?

Так. Додаток MySMSGate для Android повністю підтримує пристрої з двома SIM-картами. При виконанні POST-запиту до нашого API ви можете програмно вказати, який слот SIM-карти (SIM 1 or SIM 2) слід використовувати для надсилання повідомлення, що дозволяє оптимізувати маршрутизацію відповідно до тарифів місцевих операторів.