---
манифест: Карманный ВебАпп — механизм
статус: черновик v1
обновлено: 2026-08-31
страница: person-webapp-pocket.html
связано: [[chesuyka]] — поверхности целиком · [[master-app]] — Капюшон · [[ada]] — тот же карман на домашнем экране
---

# Карманный ВебАпп

## Что это

**Приложение, которое разворачивается прямо в переписке мессенджера.** Одна кнопка
в диалоге — и вот целый интерфейс, не покидая чат. Канон зовёт его джинном из лампы:
позвали — развернулся, сделал дело — сложился обратно.

Магия в том, что **лампу человек уже носит в кармане** — это его мессенджер.
Ничего не устанавливается.

## Где живёт

Четыре хоста, одна раскладка:

| Хост | Контейнер | Личность |
|---|---|---|
| **Telegram** | Mini App | `initData` → `/api/webapp/auth` |
| **MAX** | MAX Bridge, `window.WebApp` | `initData` → `/api/webapp/auth` |
| **WhatsApp** | **нет контейнера**, обычная вкладка браузера | только `?t=` → `/api/webapp/exchange` |
| **ADA** | наш PWA на домашнем экране | `?t=` → `/api/webapp/exchange` |

⚠️ Это **другой бэкенд**, чем у Айфрейма. Карман живёт на платформе ботов AI Delivery:
подпись проверяет платформа, роли свои (`owner` / `admin` / `member` / `guest`).
Айфрейм — в ядре ai-cobra, там всё иначе. Путать их — самая дорогая ошибка в теме.

## Правила отображения

1. **Три экрана, не больше** — столько читается на телефоне.
2. **Крупные цели нажатия**, никаких ховеров и плотных таблиц.
3. **Навигация хостовая** — «назад» системной кнопкой, не своей.
4. **Тема от хоста.**
5. **В WhatsApp не больше трёх кнопок** и никаких вызовов SDK — его там нет.
6. **`ready()` сразу после загрузки**, иначе не уйдёт заставка.
7. На закрытие — `stopProject`, на выгрузку — `logout`.

## Чего нельзя ждать

- Токен `?t=` живёт 7 дней и **расходуется неразрушающе** — ссылку из истории чата
  человек откроет ещё десять раз, и это норма.
- В контейнере мессенджера **service worker и PWA не работают** — офлайна и Web Push тут нет.
  Всё это появляется только когда то же приложение открыто по своему адресу (см. [ada.md](manifest-ada.md)).

## Отличие от соседей

| | Карманный | [Доковый](manifest-webapp-dock.md) | [Айфрейм](manifest-iframe.md) |
|---|---|---|---|
| Где | телефон, в переписке | панель рядом с чатом оператора | иконка в правом меню Кобры |
| Кто открывает | клиент, сотрудник, владелец | оператор | оператор |
| Метафора | джинна вызывают | штурман сидит рядом всегда | дверь в стене |

## Источники

- Канон: `person-webapp-pocket.html`
- [chesuyka.md](manifest-chesuyka.md) — поверхности, авторизация, адаптер хостов

---

_Источник: `cobra-components/webapp-pocket.md` в репозитории audio-talks. Эта копия обновляется скриптом `sync-components.mjs` — правки вносить в источник, не здесь._