Platform Apps: обзор

Platform Apps — способ встроить своё мини-приложение в кабинет AIChat24: карточки в чате и CRM, пункт меню, песочный iframe и доступ к данным через External API / MCP.

Быстрый старт

1. В кабинете откройте Интеграции → Своё приложение.
2. Создайте приложение, укажите cardEndpoint (Declarative) и/или embedUrl (iframe).
3. Выдайте API-ключ в Настройки → API со scopes вроде contacts:read, context:read.
4. Поднимите Partner Worker (см. репозиторий examples/platform-apps-partner-worker) и зарегистрируйте HTTPS URL.

Слоты V1 / V1.5

• chat.contact.panel — панель контакта в чате
• crm.contact.aside / crm.deal.aside — drawer CRM
• integrations.apps — витрина онбординга
• nav.app — пункт меню → /apps/:installationId

Режимы UI

• Declarative — Host рисует Card Document (Kit A), без своего JS в кабинете
• iframe — sandboxed iframe партнёра; launch ticket через postMessage → session JWT
• hybrid — карточка + кнопка открытия полного UI

External API

Базовый хост: https://api-external-a24.aichat24.ru. Auth: X-Api-Key или short-lived Authorization: Bearer (session JWT после exchange ticket).

Сессия iframe: POST /v1/session/exchange, POST /v1/session/refresh.

Подробнее: Внешний API: основы.

Безопасность

• SSRF-фильтр на card/webhook/embed URL
• Long-lived API key только на partner backend
• Revoke установки bump tokenVersion и гасит Redis tickets/refresh
• iframe: sandbox без allow-same-origin, referrerpolicy=no-referrer

См. также

MCP: подключение — tools для ИИ-клиентов.

Онбординг в кабинете: /integrations/platform-apps.