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

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

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

    Documentation

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

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Store
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Членство та кредити
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    Завіса сторінки
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Організації
    Можливості
    AI Matcher
    Messaging
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    News
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Сповіщення
    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
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Store
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Членство та кредити
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    Завіса сторінки
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Організації
    Можливості
    AI Matcher
    Messaging
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    News
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Сповіщення
    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
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Store
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Членство та кредити
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    Завіса сторінки
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Організації
    Можливості
    AI Matcher
    Messaging
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    News
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Сповіщення
    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


    title: Повідомлення в реальному часі description: REST розмов + Tunnel Protocol: типи каналів, підтипи чатів інструментів і живий чат угод без перезавантаження сторінки last_modified: "2026-10-26" audience: both

    Повідомлення в реальному часі

    Використовуйте вкладки Founder / Developer у бічній панелі документації, щоб фільтрувати цю сторінку. Ця стаття є SSOT для Conversation.type (канал) проти metadata.kind (підтип) і гігієни скриньки для чатів інструментів.

    Повідомлення Ring поєднують REST-розмови з розсилкою через Tunnel Protocol, тож учасники спілкуються в контексті можливостей, організацій і угод магазину без оновлення сторінки.

    РівеньДе
    RESTapp/api/conversations/**
    Реальний часКанали Tunnel conversation:{id}, див. Tunnel Protocol
    UIfeatures/chat, features/messages; глибокі посилання /messages?c=<conversationId> (аліас ?conversation=) і /messages?user=<userId> (messages-shell.tsx)
    Типиfeatures/chat/types/index.ts
    Довідник APIMessaging API

    Канал і підтип (спільне)

    Ring не вигадує новий тип розмови верхнього рівня для кожної функції. Два рівні лишаються окремими:

    ПолеЗначенняПриклад
    Conversation.typeКанал / маршрутизація домену: де гілка живе в системі повідомленьdirect, entity, opportunity, product, group
    metadata.kindНеобов'язковий підтип у цьому каналіgenerative_gallery
    metadata.hiddenFromInboxКонтракт скриньки: приховати зі списку Messagestrue для редакторів-інструментів

    Перевірений enum каналів (TypeScript + zod створення в app/api/conversations/route.ts):

    direct | entity | opportunity | product | group

    Не додавайте type: 'generative'. Generative Gallery повторно використовує type: 'product' плюс kind: 'generative_gallery' і hiddenFromInbox: true. Розширення enum каналів заради однієї функції ламає помічники пошуку товарів і створює паралельну інфраструктуру.

    Той самий канал product, різна видимість:

    ВикористанняtypeКлючові метаданіСкринька Messages
    Агент товару магазину (DAGI)productсправжній productId, без kind інструментаВидимий
    Чат інструмента Generative Galleryproductkind: 'generative_gallery', hiddenFromInbox: true, productId/subject = genmedia:…Прихований

    metadata.kind розмови це не той самий простір імен, що metadata.kind повідомлення (напр. payment_request, env_request, task, poll, rsvp, dao_jar, share_card, gallery_upload, ghost_write_result, game_request).

    Інтерактивні типи мають спільний набір життєвого циклу (features/chat/lib/interactive-kind.ts + реєстр бульбашок + помічник сповіщень): створення через server action → віджет із подвійною перевіркою (type АБО metadata.kind) → updateMessage / тунель message:update → типізоване сповіщення. Домен відповідає за гроші для dao_jar через public-pools: внесок нативним токеном скарбниці (contributeToPool) і карткою/PayPal (public_pool_contribution → курс desk-oracle). Чат відповідає за знімок: завжди викликайте refreshOpenDaoJarMessages після зміни сум. share_card повторно використовує MESSAGE_RECEIVED + data.kind. Інтерактивний UX рівня A виправлено (2026-07-21); див. Public Pools & DAO Jars.

    Peer games додають game_request (у allowlist в interactive-kind.ts): SSOT сесії в PeerGameService.createInvite, Tunnel game:invite / games:incoming (включно з фінальним очищенням) і IncomingGameBanner у Messages + /games. Ігри: хрестики-нулики · шахи · шашки. Лише прямі розмови. Див. Peer Games.

    Структурована робота всередині гілки: Ring Tasks (type: 'task' + дерево /tasks).

    Чому повідомлення важливі для вашого клону

    Миттєва розмова скорочує шлях від збігу → довіри → угоди. Учасники лишаються у вашому Ring, а не йдуть в email чи сторонні чати. Редактори-інструменти (історія генерації зображень) не потрапляють у головну скриньку, тож операторів не засипає системними гілками.

    Tunnel Protocol

    Як живі оновлення доходять до браузера (WSS / SSE / poll).

    Generative Gallery

    Медіа Upload | Generate: історія в прихованому чаті інструмента товару.

    Дзвінки WebRTC і STUNner

    Аудіо/відео 1:1 у прямих чатах: ICE + TURN.

    Messaging API

    Реалізація

    Перевірені маршрути

    МетодШляхРоль
    GET, POST/api/conversationsСписок / створення розмов
    GET/api/conversations/[id]Деталі розмови
    POST/api/conversations/[id]/typingСигнал набору
    POST/api/conversations/[id]/readПозначити прочитаним
    POST/api/conversations/uploadЗавантаження вкладень
    MCP

    Пов'язане

    Related documentation

    Opportunities

    Той самий процес: Contact відкриває /messages?user=<createdBy>; From chat власника використовує /messages?c=.

    Tunnel Protocol

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

    Public Pools & DAO Jars

    Той самий процес: гроші dao_jar, внески у двох валютах і оновлення банки після внеску.

    Generative Gallery

    Дивіться також: чати інструментів у каналі product приховані зі скриньки Messages.

    1. Документація
    2. /Функції
    3. /Messaging

    5 хв прослуховування


    title: Повідомлення в реальному часі description: REST розмов + Tunnel Protocol: типи каналів, підтипи чатів інструментів і живий чат угод без перезавантаження сторінки last_modified: "2026-10-26" audience: both

    Повідомлення в реальному часі

    Використовуйте вкладки Founder / Developer у бічній панелі документації, щоб фільтрувати цю сторінку. Ця стаття є SSOT для Conversation.type (канал) проти metadata.kind (підтип) і гігієни скриньки для чатів інструментів.

    Повідомлення Ring поєднують REST-розмови з розсилкою через Tunnel Protocol, тож учасники спілкуються в контексті можливостей, організацій і угод магазину без оновлення сторінки.

    РівеньДе
    RESTapp/api/conversations/**
    Реальний часКанали Tunnel conversation:{id}, див. Tunnel Protocol
    UIfeatures/chat, features/messages; глибокі посилання /messages?c=<conversationId> (аліас ?conversation=) і /messages?user=<userId> (messages-shell.tsx)
    Типиfeatures/chat/types/index.ts
    Довідник APIMessaging API

    Канал і підтип (спільне)

    Ring не вигадує новий тип розмови верхнього рівня для кожної функції. Два рівні лишаються окремими:

    ПолеЗначенняПриклад
    Conversation.typeКанал / маршрутизація домену: де гілка живе в системі повідомленьdirect, entity, opportunity, product, group
    metadata.kindНеобов'язковий підтип у цьому каналіgenerative_gallery
    metadata.hiddenFromInboxКонтракт скриньки: приховати зі списку Messagestrue для редакторів-інструментів

    Перевірений enum каналів (TypeScript + zod створення в app/api/conversations/route.ts):

    direct | entity | opportunity | product | group

    Не додавайте type: 'generative'. Generative Gallery повторно використовує type: 'product' плюс kind: 'generative_gallery' і hiddenFromInbox: true. Розширення enum каналів заради однієї функції ламає помічники пошуку товарів і створює паралельну інфраструктуру.

    Той самий канал product, різна видимість:

    ВикористанняtypeКлючові метаданіСкринька Messages
    Агент товару магазину (DAGI)productсправжній productId, без kind інструментаВидимий
    Чат інструмента Generative Galleryproductkind: 'generative_gallery', hiddenFromInbox: true, productId/subject = genmedia:…Прихований

    metadata.kind розмови це не той самий простір імен, що metadata.kind повідомлення (напр. payment_request, env_request, task, poll, rsvp, dao_jar, share_card, gallery_upload, ghost_write_result, game_request).

    Інтерактивні типи мають спільний набір життєвого циклу (features/chat/lib/interactive-kind.ts + реєстр бульбашок + помічник сповіщень): створення через server action → віджет із подвійною перевіркою (type АБО metadata.kind) → updateMessage / тунель message:update → типізоване сповіщення. Домен відповідає за гроші для dao_jar через public-pools: внесок нативним токеном скарбниці (contributeToPool) і карткою/PayPal (public_pool_contribution → курс desk-oracle). Чат відповідає за знімок: завжди викликайте refreshOpenDaoJarMessages після зміни сум. share_card повторно використовує MESSAGE_RECEIVED + data.kind. Інтерактивний UX рівня A виправлено (2026-07-21); див. Public Pools & DAO Jars.

    Peer games додають game_request (у allowlist в interactive-kind.ts): SSOT сесії в PeerGameService.createInvite, Tunnel game:invite / games:incoming (включно з фінальним очищенням) і IncomingGameBanner у Messages + /games. Ігри: хрестики-нулики · шахи · шашки. Лише прямі розмови. Див. Peer Games.

    Структурована робота всередині гілки: Ring Tasks (type: 'task' + дерево /tasks).

    Чому повідомлення важливі для вашого клону

    Миттєва розмова скорочує шлях від збігу → довіри → угоди. Учасники лишаються у вашому Ring, а не йдуть в email чи сторонні чати. Редактори-інструменти (історія генерації зображень) не потрапляють у головну скриньку, тож операторів не засипає системними гілками.

    Tunnel Protocol

    Як живі оновлення доходять до браузера (WSS / SSE / poll).

    Generative Gallery

    Медіа Upload | Generate: історія в прихованому чаті інструмента товару.

    Дзвінки WebRTC і STUNner

    Аудіо/відео 1:1 у прямих чатах: ICE + TURN.

    Messaging API

    Реалізація

    Перевірені маршрути

    МетодШляхРоль
    GET, POST/api/conversationsСписок / створення розмов
    GET/api/conversations/[id]Деталі розмови
    POST/api/conversations/[id]/typingСигнал набору
    POST/api/conversations/[id]/readПозначити прочитаним
    POST/api/conversations/uploadЗавантаження вкладень
    MCP

    Пов'язане

    Related documentation

    Opportunities

    Той самий процес: Contact відкриває /messages?user=<createdBy>; From chat власника використовує /messages?c=.

    Tunnel Protocol

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

    Public Pools & DAO Jars

    Той самий процес: гроші dao_jar, внески у двох валютах і оновлення банки після внеску.

    Generative Gallery

    Дивіться також: чати інструментів у каналі product приховані зі скриньки Messages.

    1. Документація
    2. /Функції
    3. /Messaging

    5 хв прослуховування


    title: Повідомлення в реальному часі description: REST розмов + Tunnel Protocol: типи каналів, підтипи чатів інструментів і живий чат угод без перезавантаження сторінки last_modified: "2026-10-26" audience: both

    Повідомлення в реальному часі

    Використовуйте вкладки Founder / Developer у бічній панелі документації, щоб фільтрувати цю сторінку. Ця стаття є SSOT для Conversation.type (канал) проти metadata.kind (підтип) і гігієни скриньки для чатів інструментів.

    Повідомлення Ring поєднують REST-розмови з розсилкою через Tunnel Protocol, тож учасники спілкуються в контексті можливостей, організацій і угод магазину без оновлення сторінки.

    РівеньДе
    RESTapp/api/conversations/**
    Реальний часКанали Tunnel conversation:{id}, див. Tunnel Protocol
    UIfeatures/chat, features/messages; глибокі посилання /messages?c=<conversationId> (аліас ?conversation=) і /messages?user=<userId> (messages-shell.tsx)
    Типиfeatures/chat/types/index.ts
    Довідник APIMessaging API

    Канал і підтип (спільне)

    Ring не вигадує новий тип розмови верхнього рівня для кожної функції. Два рівні лишаються окремими:

    ПолеЗначенняПриклад
    Conversation.typeКанал / маршрутизація домену: де гілка живе в системі повідомленьdirect, entity, opportunity, product, group
    metadata.kindНеобов'язковий підтип у цьому каналіgenerative_gallery
    metadata.hiddenFromInboxКонтракт скриньки: приховати зі списку Messagestrue для редакторів-інструментів

    Перевірений enum каналів (TypeScript + zod створення в app/api/conversations/route.ts):

    direct | entity | opportunity | product | group

    Не додавайте type: 'generative'. Generative Gallery повторно використовує type: 'product' плюс kind: 'generative_gallery' і hiddenFromInbox: true. Розширення enum каналів заради однієї функції ламає помічники пошуку товарів і створює паралельну інфраструктуру.

    Той самий канал product, різна видимість:

    ВикористанняtypeКлючові метаданіСкринька Messages
    Агент товару магазину (DAGI)productсправжній productId, без kind інструментаВидимий
    Чат інструмента Generative Galleryproductkind: 'generative_gallery', hiddenFromInbox: true, productId/subject = genmedia:…Прихований

    metadata.kind розмови це не той самий простір імен, що metadata.kind повідомлення (напр. payment_request, env_request, task, poll, rsvp, dao_jar, share_card, gallery_upload, ghost_write_result, game_request).

    Інтерактивні типи мають спільний набір життєвого циклу (features/chat/lib/interactive-kind.ts + реєстр бульбашок + помічник сповіщень): створення через server action → віджет із подвійною перевіркою (type АБО metadata.kind) → updateMessage / тунель message:update → типізоване сповіщення. Домен відповідає за гроші для dao_jar через public-pools: внесок нативним токеном скарбниці (contributeToPool) і карткою/PayPal (public_pool_contribution → курс desk-oracle). Чат відповідає за знімок: завжди викликайте refreshOpenDaoJarMessages після зміни сум. share_card повторно використовує MESSAGE_RECEIVED + data.kind. Інтерактивний UX рівня A виправлено (2026-07-21); див. Public Pools & DAO Jars.

    Peer games додають game_request (у allowlist в interactive-kind.ts): SSOT сесії в PeerGameService.createInvite, Tunnel game:invite / games:incoming (включно з фінальним очищенням) і IncomingGameBanner у Messages + /games. Ігри: хрестики-нулики · шахи · шашки. Лише прямі розмови. Див. Peer Games.

    Структурована робота всередині гілки: Ring Tasks (type: 'task' + дерево /tasks).

    Чому повідомлення важливі для вашого клону

    Миттєва розмова скорочує шлях від збігу → довіри → угоди. Учасники лишаються у вашому Ring, а не йдуть в email чи сторонні чати. Редактори-інструменти (історія генерації зображень) не потрапляють у головну скриньку, тож операторів не засипає системними гілками.

    Tunnel Protocol

    Як живі оновлення доходять до браузера (WSS / SSE / poll).

    Generative Gallery

    Медіа Upload | Generate: історія в прихованому чаті інструмента товару.

    Дзвінки WebRTC і STUNner

    Аудіо/відео 1:1 у прямих чатах: ICE + TURN.

    Messaging API

    Реалізація

    Перевірені маршрути

    МетодШляхРоль
    GET, POST/api/conversationsСписок / створення розмов
    GET/api/conversations/[id]Деталі розмови
    POST/api/conversations/[id]/typingСигнал набору
    POST/api/conversations/[id]/readПозначити прочитаним
    POST/api/conversations/uploadЗавантаження вкладень
    MCP

    Пов'язане

    Related documentation

    Opportunities

    Той самий процес: Contact відкриває /messages?user=<createdBy>; From chat власника використовує /messages?c=.

    Tunnel Protocol

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

    Public Pools & DAO Jars

    Той самий процес: гроші dao_jar, внески у двох валютах і оновлення банки після внеску.

    Generative Gallery

    Дивіться також: чати інструментів у каналі product приховані зі скриньки Messages.

    1. Документація
    2. /Функції
    3. /Messaging

    5 хв прослуховування

    Контракти для інтеграторів щодо розмов і індикатора набору.

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

    • Два фахівці зі збігом відкривають пряму розмову з можливості; вона з'являється в Messages.
    • Покупець ставить запитання агенту товару магазину; цей чат товару лишається видимим у Messages.
    • Продавець або учасник генерує NFT чи зображення товару в Generative Gallery; історія живе в прихованому чаті інструмента, а не в скриньці.
    • Індикатори набору й стан прочитання підтримують перемовини в мобільному PWA.
    /api/mcp/v1/messaging/conversations
    Інструменти агентів

    Після записів публікуйте в канал Tunnel conversation:{id} через publishToChannel; клієнти підписуються через useTunnelChannel (а не сирий useTunnel().subscribe() в ефектах).

    type у тілі створення має бути одним із: direct | entity | opportunity | product | group (z.enum в app/api/conversations/route.ts). Необов'язкові метадані включають productId, groupName, kind, hiddenFromInbox і id доменів (entityId, opportunityId, …).

    Контракт приховування в скриньці

    ConversationService.getConversations пропускає рядки, де isHiddenToolConversation дорівнює true (features/chat/services/conversation-service.ts):

    1. metadata.hiddenFromInbox === true (бажане довгострокове обмеження)
    2. metadata.kind === 'generative_gallery'
    3. Застаріле: productId або subject починається з genmedia: чи imggen:

    Окремо гілки product пропускаються, якщо не виконано metadata.buyerEngaged === true і глядач не надіслав у них жодного повідомлення. Сторінки товарів створюють гілку лише коли покупець пише (див. Store).

    Модулі

    ШляхВідповідальність
    features/chat/types/index.tsConversation, CreateConversationRequest, фільтри
    features/chat/services/conversation-service.tsCRUD + isHiddenToolConversation
    features/chat/, features/messages/UI чату
    features/generative-media/service.tsСтворює приховані чати product + generative_gallery
    features/store/services/product-agent-service.tsСтворює агентські чати product при першому повідомленні покупця; findExistingConversation лише шукає
    lib/tunnel/Хаб, публікатор, транспорти
    hooks/use-tunnel-channel.tsСтабільна підписка на канал

    Транспорти

    • k8s / self-hosted: основний нативний WSS /api/tunnel/ws
    • Vercel: SSE + long-poll (/api/tunnel/poll)
    • За бажанням Supabase Realtime, якщо налаштовано

    Повні приклади ендпоінтів: Messaging API. Архітектура: Real-time.

    Multi-Vendor Store

    Дивіться також: агентські чати товарів мають тип product, але видимі в скриньці.

    WebRTC Calls & STUNner TURN

    Наступний крок: аудіо/відео 1:1 у прямих чатах.

    Peer Games

    Той самий процес: інтерактивний тип game_request, IncomingGameBanner і взаємовиключення дзвінка й гри.

    Messaging API

    Детально: контракти REST + тунелю для розмов.

    Push Notifications with FCM (Ring-Powered)

    Наступний крок: досягайте учасників, коли вкладку закрито.

    Контракти для інтеграторів щодо розмов і індикатора набору.

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

    • Два фахівці зі збігом відкривають пряму розмову з можливості; вона з'являється в Messages.
    • Покупець ставить запитання агенту товару магазину; цей чат товару лишається видимим у Messages.
    • Продавець або учасник генерує NFT чи зображення товару в Generative Gallery; історія живе в прихованому чаті інструмента, а не в скриньці.
    • Індикатори набору й стан прочитання підтримують перемовини в мобільному PWA.
    /api/mcp/v1/messaging/conversations
    Інструменти агентів

    Після записів публікуйте в канал Tunnel conversation:{id} через publishToChannel; клієнти підписуються через useTunnelChannel (а не сирий useTunnel().subscribe() в ефектах).

    type у тілі створення має бути одним із: direct | entity | opportunity | product | group (z.enum в app/api/conversations/route.ts). Необов'язкові метадані включають productId, groupName, kind, hiddenFromInbox і id доменів (entityId, opportunityId, …).

    Контракт приховування в скриньці

    ConversationService.getConversations пропускає рядки, де isHiddenToolConversation дорівнює true (features/chat/services/conversation-service.ts):

    1. metadata.hiddenFromInbox === true (бажане довгострокове обмеження)
    2. metadata.kind === 'generative_gallery'
    3. Застаріле: productId або subject починається з genmedia: чи imggen:

    Окремо гілки product пропускаються, якщо не виконано metadata.buyerEngaged === true і глядач не надіслав у них жодного повідомлення. Сторінки товарів створюють гілку лише коли покупець пише (див. Store).

    Модулі

    ШляхВідповідальність
    features/chat/types/index.tsConversation, CreateConversationRequest, фільтри
    features/chat/services/conversation-service.tsCRUD + isHiddenToolConversation
    features/chat/, features/messages/UI чату
    features/generative-media/service.tsСтворює приховані чати product + generative_gallery
    features/store/services/product-agent-service.tsСтворює агентські чати product при першому повідомленні покупця; findExistingConversation лише шукає
    lib/tunnel/Хаб, публікатор, транспорти
    hooks/use-tunnel-channel.tsСтабільна підписка на канал

    Транспорти

    • k8s / self-hosted: основний нативний WSS /api/tunnel/ws
    • Vercel: SSE + long-poll (/api/tunnel/poll)
    • За бажанням Supabase Realtime, якщо налаштовано

    Повні приклади ендпоінтів: Messaging API. Архітектура: Real-time.

    Multi-Vendor Store

    Дивіться також: агентські чати товарів мають тип product, але видимі в скриньці.

    WebRTC Calls & STUNner TURN

    Наступний крок: аудіо/відео 1:1 у прямих чатах.

    Peer Games

    Той самий процес: інтерактивний тип game_request, IncomingGameBanner і взаємовиключення дзвінка й гри.

    Messaging API

    Детально: контракти REST + тунелю для розмов.

    Push Notifications with FCM (Ring-Powered)

    Наступний крок: досягайте учасників, коли вкладку закрито.

    Контракти для інтеграторів щодо розмов і індикатора набору.

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

    • Два фахівці зі збігом відкривають пряму розмову з можливості; вона з'являється в Messages.
    • Покупець ставить запитання агенту товару магазину; цей чат товару лишається видимим у Messages.
    • Продавець або учасник генерує NFT чи зображення товару в Generative Gallery; історія живе в прихованому чаті інструмента, а не в скриньці.
    • Індикатори набору й стан прочитання підтримують перемовини в мобільному PWA.
    /api/mcp/v1/messaging/conversations
    Інструменти агентів

    Після записів публікуйте в канал Tunnel conversation:{id} через publishToChannel; клієнти підписуються через useTunnelChannel (а не сирий useTunnel().subscribe() в ефектах).

    type у тілі створення має бути одним із: direct | entity | opportunity | product | group (z.enum в app/api/conversations/route.ts). Необов'язкові метадані включають productId, groupName, kind, hiddenFromInbox і id доменів (entityId, opportunityId, …).

    Контракт приховування в скриньці

    ConversationService.getConversations пропускає рядки, де isHiddenToolConversation дорівнює true (features/chat/services/conversation-service.ts):

    1. metadata.hiddenFromInbox === true (бажане довгострокове обмеження)
    2. metadata.kind === 'generative_gallery'
    3. Застаріле: productId або subject починається з genmedia: чи imggen:

    Окремо гілки product пропускаються, якщо не виконано metadata.buyerEngaged === true і глядач не надіслав у них жодного повідомлення. Сторінки товарів створюють гілку лише коли покупець пише (див. Store).

    Модулі

    ШляхВідповідальність
    features/chat/types/index.tsConversation, CreateConversationRequest, фільтри
    features/chat/services/conversation-service.tsCRUD + isHiddenToolConversation
    features/chat/, features/messages/UI чату
    features/generative-media/service.tsСтворює приховані чати product + generative_gallery
    features/store/services/product-agent-service.tsСтворює агентські чати product при першому повідомленні покупця; findExistingConversation лише шукає
    lib/tunnel/Хаб, публікатор, транспорти
    hooks/use-tunnel-channel.tsСтабільна підписка на канал

    Транспорти

    • k8s / self-hosted: основний нативний WSS /api/tunnel/ws
    • Vercel: SSE + long-poll (/api/tunnel/poll)
    • За бажанням Supabase Realtime, якщо налаштовано

    Повні приклади ендпоінтів: Messaging API. Архітектура: Real-time.

    Multi-Vendor Store

    Дивіться також: агентські чати товарів мають тип product, але видимі в скриньці.

    WebRTC Calls & STUNner TURN

    Наступний крок: аудіо/відео 1:1 у прямих чатах.

    Peer Games

    Той самий процес: інтерактивний тип game_request, IncomingGameBanner і взаємовиключення дзвінка й гри.

    Messaging API

    Детально: контракти REST + тунелю для розмов.

    Push Notifications with FCM (Ring-Powered)

    Наступний крок: досягайте учасників, коли вкладку закрито.