dreamSms

SMS activation service with Telegram bot and REST API.

Buy virtual phone numbers and receive SMS activation codes directly in Telegram. Useful if you don't want to pay for real SIM cards for service activations. Integrates with dreamID SSO.

Features

• Virtual number purchasing
• SMS code receiving via Telegram bot
• REST API for third-party integrations
• DreamID SSO authentication
• Admin dashboard (/admin) with SSO login, service & activation management
• QR code login: scan a dreamID QR code with a photo in the bot to authorize a web session
• Web landing page (/) and public API docs page (/activate)

Stack

• Python / Flask
• JavaScript (frontend)
• SQLite

Setup

pip install -r requirements.txt

Set environment variables:

BOT_TOKEN=your_bot_token
DREAMID_CLIENT_SECRET=your_sso_secret
SECRET_KEY=your_flask_session_secret
TELEGRAM_API_BASE=https://api.telegram.org

Optional:

ADMIN_ID=your_telegram_id
DREAMID_AUTH_URL=https://auth.dreampartners.online
AUTH_BASE_URL=https://auth.dreampartners.online

python bot.py

QR login

The bot accepts photos: send a screenshot of a dreamID QR code and the bot verifies it via the auth service, logging the web session in without entering credentials. Requires Pillow + pyzbar (see requirements.txt).

Admin panel

The admin dashboard lives at /admin inside the main Flask app (no separate service). Access is restricted to ADMIN_ID via DreamID SSO: services, activations and API keys are managed from the web UI, while everyday operations also work through the Telegram bot.

Helper scripts for registering the sms_admin dreamID OAuth client are included (register_dreamid_client.py, quick_register_client.sh).

API

Full endpoint reference with code examples: docs/API.md, interactive docs served at /activate.

Contact

Telegram: @dreamcatch_r

---

Русская версия

dreamSms

Сервис SMS-активации с Telegram-ботом и REST API.

Покупайте виртуальные номера телефонов и получайте коды активации из SMS прямо в Telegram. Удобно, если не хочется покупать реальные SIM-карты для регистраций в сервисах. Интегрируется с dreamID SSO.

Возможности

• Покупка виртуальных номеров
• Получение SMS-кодов через Telegram-бота
• REST API для сторонних интеграций
• Аутентификация через DreamID SSO
• Админ-панель (/admin) со входом через SSO, управлением сервисами и активациями
• Вход по QR-коду: отправьте боту фото QR-кода dreamID — веб-сессия авторизуется без ввода пароля
• Веб-лендинг (/) и страница публичной документации API (/activate)

Стек

• Python / Flask
• JavaScript (фронтенд)
• SQLite

Установка

pip install -r requirements.txt

Задайте переменные окружения:

BOT_TOKEN=токен_бота
DREAMID_CLIENT_SECRET=секрет_sso
SECRET_KEY=секрет_flask_сессий
TELEGRAM_API_BASE=https://api.telegram.org

Опционально:

ADMIN_ID=ваш_telegram_id
DREAMID_AUTH_URL=https://auth.dreampartners.online
AUTH_BASE_URL=https://auth.dreampartners.online

python bot.py

QR-вход

Бот принимает фотографии: отправьте скриншот QR-кода dreamID — бот проверит его через сервис авторизации и войдёт в веб-сессию без ввода логина и пароля. Требуются Pillow + pyzbar (см. requirements.txt).

Админ-панель

Админ-панель работает по адресу /admin внутри основного Flask-приложения (без отдельного сервиса). Доступ ограничен ADMIN_ID через DreamID SSO: управление сервисами, активациями и API-ключами — из веб-интерфейса, при этом повседневные операции доступны и через Telegram-бота.

Вспомогательные скрипты для регистрации OAuth-клиента sms_admin в dreamID включены в репозиторий (register_dreamid_client.py, quick_register_client.sh).

API

Полный справочник эндпоинтов с примерами кода: docs/API.md, интерактивная документация — на /activate.

Контакты

Telegram: @dreamcatch_r