---
title: Поддержка (helpdesk)
description: Заявки из приложений в админку Platform через SDK.
---

# Поддержка (helpdesk)

Мини-хелпдеск Platform: пользователь в приложении создаёт заявку → она появляется в админке **Поддержка**.

## Поток

```text
Приложение (кнопка «Помощь»)
  → SDK.createSupportTicket(+ вложения)
  → Platform API
  → Админка → Поддержка (список / карточка / ответ)
```

## Что отправляет клиент

| Поле | Назначение |
| --- | --- |
| `subject` / `description` | Тема и текст проблемы |
| `category` | `bug` \| `billing` \| `account` \| `feature` \| `other` |
| `platform`, `app_version`, `os_version`, `device_name`, `installation_id`, `locale` | Среда запуска |
| `metadata` | Любой контекст: экран, extra |
| вложения | скрины, видео, логи (отдельным upload) |

Приложение определяется по `application_code` + `X-Public-Key`. Нужен JWT пользователя.

Опциональные поля обратной связи (`contact_*`) — только если продукт сам собирает их у пользователя; в примерах и публичных материалах не указывайте реальные ФИО, email или телефоны.

## Админка

- Список: статус, приложение, тема, дата
- Карточка: описание, metadata, файлы, переписка
- Статусы: new → open → waiting_user / waiting_staff → resolved / closed
- Ответ пользователю или **внутренняя заметка** (не видна клиенту)

## SDK

TypeScript: `createSupportTicket`, `uploadSupportAttachment`, `listMySupportTickets`, `getSupportTicket`, `replyToSupportTicket`.

Flutter: те же методы на `RaidBossPlatformClient`.

Пример (TS):

```ts
const { data: ticket } = await platform.createSupportTicket({
  subject: "Sync issue",
  description: "…",
  category: "bug",
  platform: "windows",
  app_version: "1.2.0",
  installation_id: installationId,
  metadata: { screen: "sync_center" },
});

await platform.uploadSupportAttachment(ticket.id, logBlob, {
  filename: "app.log",
  kind: "log",
});
```

## Что ещё можно добавить позже

- Уведомление админу о новой заявке
- Ответ пользователю вне админки
- Гостевые заявки без JWT
- SLA / время первого ответа
- Автоприкрепление последних N логов из SDK-буфера