Как создать 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-карты, платформа позволяет программно выбирать, с какого слота SIM-карты отправлять каждое исходящее сообщение через API, что дает вам полный контроль над маршрутизацией и тарифами местных операторов.

Шаг 3: Написание кода OTP-сервера

Теперь, когда ваше оборудование подключено, вы можете написать логику бэкенда для генерации, хранения и отправки одноразовых паролей. Ниже приведен готовый легковесный пример на Node.js, демонстрирующий, как сгенерировать безопасный 6-значный OTP, сохранить его в памяти с меткой времени истечения срока действия и отправить через REST API MySMSGate.

const axios = require('axios');

// Временное хранилище в памяти для демонстрации (в продакшене используйте Redis)
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) {
  // Генерация криптографически безопасного 6-значного кода
  const otp = Math.floor(100000 + Math.random() * 900000).toString();
  const expiresAt = Date.now() + 5 * 60 * 1000; // Срок действия 5 минут

  // Сохранение данных OTP
  otpCache.set(phoneNumber, { otp, expiresAt });

  // Подготовка полезной нагрузки для API MySMSGate
  const payload = {
    to: phoneNumber,
    message: `Ваш код подтверждения: ${otp}. Он истечет через 5 минут.`
  };

  try {
    const response = await axios.post(MYSMSGATE_API_URL, payload, {
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      }
    });
    console.log('OTP успешно отправлен:', response.data);
    return { success: true };
  } catch (error) {
    console.error('Не удалось отправить OTP через MySMSGate:', error.response ? error.response.data : error.message);
    return { success: false, error: 'Ошибка связи с SMS-шлюзом' };
  }
}

Эта простая интеграция с 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: 'OTP не запрашивался или срок действия кода истек' };
  }

  if (Date.now() > record.expiresAt) {
    otpCache.delete(phoneNumber);
    return { verified: false, reason: 'Срок действия OTP истек' };
  }

  if (record.otp === userSubmittedCode) {
    otpCache.delete(phoneNumber); // Очистка кода после успешного использования
    return { verified: true };
  } 

  return { verified: false, reason: 'Неверный код' };
}

Чтобы отслеживать статус доставки в реальном времени, настройте 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-сообщений?

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