МожливостіСутності
Документація
    Ring Platform

    Децентралізоване самобудівне майбутнє

    Увійти
    Сутності
    Можливості
    Магазин
    Документація
    Концепції
    RING ЕкономікаSonoratek LLCГлобальний впливAI зустрічає Web3
    Розпочати
    Швидкий стартКалькуляторДорожня карта
    Конфіденційність|Контакти
    v1.104.26|Sonoratek LLC

    Documentation

    Концепції, цінність і типові сценарії

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Сутності
    Можливості
    AI Matcher
    Повідомлення
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Розгортання на власному сервері
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Архітектура News Kingdom
    Бекенд Сервіси
    Інтеграція Firebase
    Розробка
    Ring MCP Server
    OSS і enterprise

    Швидкий вхід (CTO · аудитори · агенти)

    Вітаємо — місія та аудиторії
    Швидкий довідник
    Початок роботи
    Архітектура та Auth.js
    Режими бекенду та БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безпека та відповідність
    ringdom.org — база LegioX
    Код — ліцензія MIT (GitHub)

    Documentation

    Концепції, цінність і типові сценарії

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Сутності
    Можливості
    AI Matcher
    Повідомлення
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Розгортання на власному сервері
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Архітектура News Kingdom
    Бекенд Сервіси
    Інтеграція Firebase
    Розробка
    Ring MCP Server
    OSS і enterprise

    Швидкий вхід (CTO · аудитори · агенти)

    Вітаємо — місія та аудиторії
    Швидкий довідник
    Початок роботи
    Архітектура та Auth.js
    Режими бекенду та БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безпека та відповідність
    ringdom.org — база LegioX
    Код — ліцензія MIT (GitHub)

    Documentation

    Концепції, цінність і типові сценарії

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Сутності
    Можливості
    AI Matcher
    Повідомлення
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Розгортання на власному сервері
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Архітектура News Kingdom
    Бекенд Сервіси
    Інтеграція Firebase
    Розробка
    Ring MCP Server
    OSS і enterprise

    Швидкий вхід (CTO · аудитори · агенти)

    Вітаємо — місія та аудиторії
    Швидкий довідник
    Початок роботи
    Архітектура та Auth.js
    Режими бекенду та БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безпека та відповідність
    ringdom.org — база LegioX
    Код — ліцензія MIT (GitHub)
    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Керування через Telegram

    Використовуйте вкладки Founder / Developer на бічній панелі документації. Це бот адміністратора для операторів — не Login via Telegram учасника (OIDC) і не автентифікація через initData Mini App. Автентифікація учасника: Authentication. Членство Stars: SubscriptionConductor.

    Ring постачає Telegram Admin Bot, щоб адміністратори платформи могли модерувати новини, виконувати вибрані адміністративні операції та отримувати callback-и затвердження без відкриття веб-інтерфейсу адміністратора — і водночас дотримуватися того самого RBAC SSOT, що й /admin.

    || Зона | Факт | ||---------|--------| || Webhook | POST /api/telegram/admin-bot/webhook | || Код | lib/telegram/admin-bot/ | || RBAC | features/auth/user-role.ts — isPlatformAdmin / isSuperadmin | || Затвердження новин | Callback-и бота + News / News Kingdom |

    Не плутайте ці поверхні Telegram

    || Поверхня | Аудиторія | Секрет / криптографія | ||---------|----------|-----------------| || Login via Telegram | Учасники (браузер) | AUTH_TELEGRAM_ID / SECRET — OIDC на oauth.telegram.org | || Mini App initData | Учасники (клієнт WebApp) | HMAC WebAppData — TELEGRAM_MINI_APP_BOT_TOKEN (fallback-и описані в Authentication) | || Link Telegram (профіль) | Учасники, які ввійшли | HMAC Login Widget з ADMIN_BOT_TOKEN / TELEGRAM_LOGIN_BOT_TOKEN | || Членство telegram_stars | Учасники, які платять | Той самий токен Mini App бота + Bot API createInvoiceLink — SubscriptionConductor | || Admin bot (ця сторінка) | Адміністратори платформи | ADMIN_BOT_TOKEN + ADMIN_BOT_WEBHOOK_SECRET + білий список |

    Навіщо операторам Telegram

    Операції під час термінових годин і модерація в дорозі: затверджуйте чернетки редакції, перевіряйте критичні черги та зберігайте аудиторський слід — без VPN до настільної сесії адміністратора.

    Відповідність довірі та бренду

    Керування через authentication, security і verification:

    • Розмовляти з ботом можуть лише додані до білого списку ідентифікатори Telegram, зіставлені з користувачами Ring admin / superadmin.
    • Деструктивні дії (видалення користувача, налаштування платформи) залишаються доступними лише superadmin.
    • Адміністратори спочатку мають підключити Telegram у профілі Ring (або увійти через Telegram OIDC, щоб було встановлено communication.telegramId), перш ніж білий список зможе їх побачити.

    Безпека

    Рівні захисту та адміністративна позиція.

    Новини

    Затвердження через Telegram у редакційному конвеєрі.

    Реалізація

    Модулі

    || Шлях | Роль | ||------|------| || app/api/telegram/admin-bot/webhook/route.ts | Вхід для оновлень Telegram | || lib/telegram/admin-bot/bot-config.ts | Токен, секрет webhook, setWebhook | || lib/telegram/admin-bot/whitelist.ts | Відображення чату Telegram → користувач адміністратора Ring через communication.telegramId | || lib/telegram/admin-bot/ring-api-executor.ts | RBAC на рівні операції перед Ring HTTP | || lib/telegram/admin-bot/news-callback-handler.ts | Inline approve/reject новин | || lib/telegram/admin-bot/anthropic-router.ts | Необов’язкова маршрутизація NL → tool | || lib/telegram/admin-bot/audit-logger.ts | Аудит взаємодій | || lib/telegram/admin-bot/TELEGRAM_BOT_RBAC.md | SSOT політики RBAC (у репозиторії) |

    Env (перевірені назви)

    Форма URL webhook: https://<your-domain>/api/telegram/admin-bot/webhook (у production — HTTPS). Перевіряйте secret_token через validateWebhookSecret.

    OIDC учасника Login використовує інші env: AUTH_TELEGRAM_ID / AUTH_TELEGRAM_SECRET — див. Authentication.

    Рівні RBAC

    1. Білий список — Telegram ID відправника має бути зіставлений із користувачем Ring у PLATFORM_ADMIN_ROLES.
    2. Виконавець — перевірки для кожної операції в ring-api-executor.ts.
    3. HTTP API Ring — автентифікація сесії/MCP перевіряє повторно; бот не повинен обходити SSOT.

    Приклади, суворо доступні superadmin: видалення користувача, зміни бренду платформи / налаштувань AI. Адміністратори платформи: модерація новин, вибрані шляхи замовлень/гаманця/верифікації — див. TELEGRAM_BOT_RBAC.md.

    Пов’язаний Telegram учасника (не цей бот)

    Пов’язана документація

    Related documentation

    Authentication

    Передумова: Login via Telegram OIDC учасника + initData Mini App у порівнянні з цим ботом адміністратора.

    SubscriptionConductor

    Див. також: рахунки telegram_stars використовують спільний хелпер токена Mini App — не цей webhook адміністратора.

    News Kingdom architecture

    Той самий процес: оцінювання, просування та callback-и затвердження в Telegram.

    Autonomous Newsroom (Grok)

    Наступний крок: конвеєр чернетка → зображення → затвердження в Telegram.

    1. Документація
    2. /Функції
    3. /Керування через Telegram
    Оновлено 6 вер. 2026 р.4 хв прослуховування

    Керування через Telegram

    Використовуйте вкладки Founder / Developer на бічній панелі документації. Це бот адміністратора для операторів — не Login via Telegram учасника (OIDC) і не автентифікація через initData Mini App. Автентифікація учасника: Authentication. Членство Stars: SubscriptionConductor.

    Ring постачає Telegram Admin Bot, щоб адміністратори платформи могли модерувати новини, виконувати вибрані адміністративні операції та отримувати callback-и затвердження без відкриття веб-інтерфейсу адміністратора — і водночас дотримуватися того самого RBAC SSOT, що й /admin.

    || Зона | Факт | ||---------|--------| || Webhook | POST /api/telegram/admin-bot/webhook | || Код | lib/telegram/admin-bot/ | || RBAC | features/auth/user-role.ts — isPlatformAdmin / isSuperadmin | || Затвердження новин | Callback-и бота + News / News Kingdom |

    Не плутайте ці поверхні Telegram

    || Поверхня | Аудиторія | Секрет / криптографія | ||---------|----------|-----------------| || Login via Telegram | Учасники (браузер) | AUTH_TELEGRAM_ID / SECRET — OIDC на oauth.telegram.org | || Mini App initData | Учасники (клієнт WebApp) | HMAC WebAppData — TELEGRAM_MINI_APP_BOT_TOKEN (fallback-и описані в Authentication) | || Link Telegram (профіль) | Учасники, які ввійшли | HMAC Login Widget з ADMIN_BOT_TOKEN / TELEGRAM_LOGIN_BOT_TOKEN | || Членство telegram_stars | Учасники, які платять | Той самий токен Mini App бота + Bot API createInvoiceLink — SubscriptionConductor | || Admin bot (ця сторінка) | Адміністратори платформи | ADMIN_BOT_TOKEN + ADMIN_BOT_WEBHOOK_SECRET + білий список |

    Навіщо операторам Telegram

    Операції під час термінових годин і модерація в дорозі: затверджуйте чернетки редакції, перевіряйте критичні черги та зберігайте аудиторський слід — без VPN до настільної сесії адміністратора.

    Відповідність довірі та бренду

    Керування через authentication, security і verification:

    • Розмовляти з ботом можуть лише додані до білого списку ідентифікатори Telegram, зіставлені з користувачами Ring admin / superadmin.
    • Деструктивні дії (видалення користувача, налаштування платформи) залишаються доступними лише superadmin.
    • Адміністратори спочатку мають підключити Telegram у профілі Ring (або увійти через Telegram OIDC, щоб було встановлено communication.telegramId), перш ніж білий список зможе їх побачити.

    Безпека

    Рівні захисту та адміністративна позиція.

    Новини

    Затвердження через Telegram у редакційному конвеєрі.

    Реалізація

    Модулі

    || Шлях | Роль | ||------|------| || app/api/telegram/admin-bot/webhook/route.ts | Вхід для оновлень Telegram | || lib/telegram/admin-bot/bot-config.ts | Токен, секрет webhook, setWebhook | || lib/telegram/admin-bot/whitelist.ts | Відображення чату Telegram → користувач адміністратора Ring через communication.telegramId | || lib/telegram/admin-bot/ring-api-executor.ts | RBAC на рівні операції перед Ring HTTP | || lib/telegram/admin-bot/news-callback-handler.ts | Inline approve/reject новин | || lib/telegram/admin-bot/anthropic-router.ts | Необов’язкова маршрутизація NL → tool | || lib/telegram/admin-bot/audit-logger.ts | Аудит взаємодій | || lib/telegram/admin-bot/TELEGRAM_BOT_RBAC.md | SSOT політики RBAC (у репозиторії) |

    Env (перевірені назви)

    Форма URL webhook: https://<your-domain>/api/telegram/admin-bot/webhook (у production — HTTPS). Перевіряйте secret_token через validateWebhookSecret.

    OIDC учасника Login використовує інші env: AUTH_TELEGRAM_ID / AUTH_TELEGRAM_SECRET — див. Authentication.

    Рівні RBAC

    1. Білий список — Telegram ID відправника має бути зіставлений із користувачем Ring у PLATFORM_ADMIN_ROLES.
    2. Виконавець — перевірки для кожної операції в ring-api-executor.ts.
    3. HTTP API Ring — автентифікація сесії/MCP перевіряє повторно; бот не повинен обходити SSOT.

    Приклади, суворо доступні superadmin: видалення користувача, зміни бренду платформи / налаштувань AI. Адміністратори платформи: модерація новин, вибрані шляхи замовлень/гаманця/верифікації — див. TELEGRAM_BOT_RBAC.md.

    Пов’язаний Telegram учасника (не цей бот)

    Пов’язана документація

    Related documentation

    Authentication

    Передумова: Login via Telegram OIDC учасника + initData Mini App у порівнянні з цим ботом адміністратора.

    SubscriptionConductor

    Див. також: рахунки telegram_stars використовують спільний хелпер токена Mini App — не цей webhook адміністратора.

    News Kingdom architecture

    Той самий процес: оцінювання, просування та callback-и затвердження в Telegram.

    Autonomous Newsroom (Grok)

    Наступний крок: конвеєр чернетка → зображення → затвердження в Telegram.

    1. Документація
    2. /Функції
    3. /Керування через Telegram
    Оновлено 6 вер. 2026 р.4 хв прослуховування

    Керування через Telegram

    Використовуйте вкладки Founder / Developer на бічній панелі документації. Це бот адміністратора для операторів — не Login via Telegram учасника (OIDC) і не автентифікація через initData Mini App. Автентифікація учасника: Authentication. Членство Stars: SubscriptionConductor.

    Ring постачає Telegram Admin Bot, щоб адміністратори платформи могли модерувати новини, виконувати вибрані адміністративні операції та отримувати callback-и затвердження без відкриття веб-інтерфейсу адміністратора — і водночас дотримуватися того самого RBAC SSOT, що й /admin.

    || Зона | Факт | ||---------|--------| || Webhook | POST /api/telegram/admin-bot/webhook | || Код | lib/telegram/admin-bot/ | || RBAC | features/auth/user-role.ts — isPlatformAdmin / isSuperadmin | || Затвердження новин | Callback-и бота + News / News Kingdom |

    Не плутайте ці поверхні Telegram

    || Поверхня | Аудиторія | Секрет / криптографія | ||---------|----------|-----------------| || Login via Telegram | Учасники (браузер) | AUTH_TELEGRAM_ID / SECRET — OIDC на oauth.telegram.org | || Mini App initData | Учасники (клієнт WebApp) | HMAC WebAppData — TELEGRAM_MINI_APP_BOT_TOKEN (fallback-и описані в Authentication) | || Link Telegram (профіль) | Учасники, які ввійшли | HMAC Login Widget з ADMIN_BOT_TOKEN / TELEGRAM_LOGIN_BOT_TOKEN | || Членство telegram_stars | Учасники, які платять | Той самий токен Mini App бота + Bot API createInvoiceLink — SubscriptionConductor | || Admin bot (ця сторінка) | Адміністратори платформи | ADMIN_BOT_TOKEN + ADMIN_BOT_WEBHOOK_SECRET + білий список |

    Навіщо операторам Telegram

    Операції під час термінових годин і модерація в дорозі: затверджуйте чернетки редакції, перевіряйте критичні черги та зберігайте аудиторський слід — без VPN до настільної сесії адміністратора.

    Відповідність довірі та бренду

    Керування через authentication, security і verification:

    • Розмовляти з ботом можуть лише додані до білого списку ідентифікатори Telegram, зіставлені з користувачами Ring admin / superadmin.
    • Деструктивні дії (видалення користувача, налаштування платформи) залишаються доступними лише superadmin.
    • Адміністратори спочатку мають підключити Telegram у профілі Ring (або увійти через Telegram OIDC, щоб було встановлено communication.telegramId), перш ніж білий список зможе їх побачити.

    Безпека

    Рівні захисту та адміністративна позиція.

    Новини

    Затвердження через Telegram у редакційному конвеєрі.

    Реалізація

    Модулі

    || Шлях | Роль | ||------|------| || app/api/telegram/admin-bot/webhook/route.ts | Вхід для оновлень Telegram | || lib/telegram/admin-bot/bot-config.ts | Токен, секрет webhook, setWebhook | || lib/telegram/admin-bot/whitelist.ts | Відображення чату Telegram → користувач адміністратора Ring через communication.telegramId | || lib/telegram/admin-bot/ring-api-executor.ts | RBAC на рівні операції перед Ring HTTP | || lib/telegram/admin-bot/news-callback-handler.ts | Inline approve/reject новин | || lib/telegram/admin-bot/anthropic-router.ts | Необов’язкова маршрутизація NL → tool | || lib/telegram/admin-bot/audit-logger.ts | Аудит взаємодій | || lib/telegram/admin-bot/TELEGRAM_BOT_RBAC.md | SSOT політики RBAC (у репозиторії) |

    Env (перевірені назви)

    Форма URL webhook: https://<your-domain>/api/telegram/admin-bot/webhook (у production — HTTPS). Перевіряйте secret_token через validateWebhookSecret.

    OIDC учасника Login використовує інші env: AUTH_TELEGRAM_ID / AUTH_TELEGRAM_SECRET — див. Authentication.

    Рівні RBAC

    1. Білий список — Telegram ID відправника має бути зіставлений із користувачем Ring у PLATFORM_ADMIN_ROLES.
    2. Виконавець — перевірки для кожної операції в ring-api-executor.ts.
    3. HTTP API Ring — автентифікація сесії/MCP перевіряє повторно; бот не повинен обходити SSOT.

    Приклади, суворо доступні superadmin: видалення користувача, зміни бренду платформи / налаштувань AI. Адміністратори платформи: модерація новин, вибрані шляхи замовлень/гаманця/верифікації — див. TELEGRAM_BOT_RBAC.md.

    Пов’язаний Telegram учасника (не цей бот)

    Пов’язана документація

    Related documentation

    Authentication

    Передумова: Login via Telegram OIDC учасника + initData Mini App у порівнянні з цим ботом адміністратора.

    SubscriptionConductor

    Див. також: рахунки telegram_stars використовують спільний хелпер токена Mini App — не цей webhook адміністратора.

    News Kingdom architecture

    Той самий процес: оцінювання, просування та callback-и затвердження в Telegram.

    Autonomous Newsroom (Grok)

    Наступний крок: конвеєр чернетка → зображення → затвердження в Telegram.

    1. Документація
    2. /Функції
    3. /Керування через Telegram
    Оновлено 6 вер. 2026 р.4 хв прослуховування

    Автентифікація

    OIDC учасника Login via Telegram + ролі, яких має дотримуватися бот.

    Типові сценарії

    • Надходить чернетка автономної редакції → адміністратор натискає Approve у Telegram → розподіл за локалями.
    • Адміністратор on-call перевіряє статус верифікації / замовлення через команди бота (шляхи адміністратора платформи).
    • Невдалі або неавторизовані спроби записуються до аудиту.

    || Шлях | Роль | ||------|------| || features/auth/components/telegram-signin-button.tsx | Login via Telegram OIDC | || lib/auth/telegram-oidc.ts | Провайдер OIDC для Auth.js | || lib/auth/telegram-miniapp-initdata.ts | HMAC WebAppData Mini App + хелпер токена бота | || features/auth/components/telegram-linking-modal.tsx | Застаріле підключення Login Widget | || app/api/auth/telegram/callback/route.ts | Callback віджета (потрібна сесія) | || lib/auth/telegram-login-widget-hash.ts | Спільний HMAC віджета | || lib/payments/subscription/providers/telegram-stars-subscription.ts | Рахунки Stars XTR |

    Ring MCP Server

    Див. також: IDE MCP-двійник для адміністративних операцій того самого клону.

    Admin API

    Залежність: HTTP-поверхні вебадміністратора, які бот обережно віддзеркалює.

    bash
    
ADMIN_BOT_TOKEN=...
ADMIN_BOT_WEBHOOK_SECRET=...

    Автентифікація

    OIDC учасника Login via Telegram + ролі, яких має дотримуватися бот.

    Типові сценарії

    • Надходить чернетка автономної редакції → адміністратор натискає Approve у Telegram → розподіл за локалями.
    • Адміністратор on-call перевіряє статус верифікації / замовлення через команди бота (шляхи адміністратора платформи).
    • Невдалі або неавторизовані спроби записуються до аудиту.

    || Шлях | Роль | ||------|------| || features/auth/components/telegram-signin-button.tsx | Login via Telegram OIDC | || lib/auth/telegram-oidc.ts | Провайдер OIDC для Auth.js | || lib/auth/telegram-miniapp-initdata.ts | HMAC WebAppData Mini App + хелпер токена бота | || features/auth/components/telegram-linking-modal.tsx | Застаріле підключення Login Widget | || app/api/auth/telegram/callback/route.ts | Callback віджета (потрібна сесія) | || lib/auth/telegram-login-widget-hash.ts | Спільний HMAC віджета | || lib/payments/subscription/providers/telegram-stars-subscription.ts | Рахунки Stars XTR |

    Ring MCP Server

    Див. також: IDE MCP-двійник для адміністративних операцій того самого клону.

    Admin API

    Залежність: HTTP-поверхні вебадміністратора, які бот обережно віддзеркалює.

    bash
    
ADMIN_BOT_TOKEN=...
ADMIN_BOT_WEBHOOK_SECRET=...

    Автентифікація

    OIDC учасника Login via Telegram + ролі, яких має дотримуватися бот.

    Типові сценарії

    • Надходить чернетка автономної редакції → адміністратор натискає Approve у Telegram → розподіл за локалями.
    • Адміністратор on-call перевіряє статус верифікації / замовлення через команди бота (шляхи адміністратора платформи).
    • Невдалі або неавторизовані спроби записуються до аудиту.

    || Шлях | Роль | ||------|------| || features/auth/components/telegram-signin-button.tsx | Login via Telegram OIDC | || lib/auth/telegram-oidc.ts | Провайдер OIDC для Auth.js | || lib/auth/telegram-miniapp-initdata.ts | HMAC WebAppData Mini App + хелпер токена бота | || features/auth/components/telegram-linking-modal.tsx | Застаріле підключення Login Widget | || app/api/auth/telegram/callback/route.ts | Callback віджета (потрібна сесія) | || lib/auth/telegram-login-widget-hash.ts | Спільний HMAC віджета | || lib/payments/subscription/providers/telegram-stars-subscription.ts | Рахунки Stars XTR |

    Ring MCP Server

    Див. також: IDE MCP-двійник для адміністративних операцій того самого клону.

    Admin API

    Залежність: HTTP-поверхні вебадміністратора, які бот обережно віддзеркалює.

    bash
    
ADMIN_BOT_TOKEN=...
ADMIN_BOT_WEBHOOK_SECRET=...