# Пресеты иконок

Иконки, которые отображаются рядом с ссылками **Бот / Канал / Поддержка** в карточке подписки (режим `liteMode`). Провайдер выбирает иконку по ключу из пресет-набора — каждая платформа (Android, iOS, Desktop) маппит этот ключ на свою нативную иконку.

Зачем так, а не URL картинки:

* **Единый внешний вид на всех платформах** — иконки из системного набора (Material Icons, SF Symbols) подстраиваются под тему.
* **Ноль сетевых запросов в клиенте** — ключ это просто строка в `settings`.
* **Поддержка в офлайне** — приложение работает даже без связи с сервером.

## Где задаётся

Провайдер выбирает иконку в [веб-панели](https://web.incy-panel.com/) для каждого домена в блоке **Lite Mode**. Значения сохраняются в `SubscriptionSettings`:

| Поле             | Тип       | Описание                     |
| ---------------- | --------- | ---------------------------- |
| `botIconKey`     | `string?` | Ключ иконки для `botUrl`     |
| `channelIconKey` | `string?` | Ключ иконки для `channelUrl` |
| `supportIconKey` | `string?` | Ключ иконки для `supportUrl` |

Возвращаются клиенту через [Premium API](broken://pages/820e06601eb76c161f3066c4002c3997b216e29a) в объекте `settings`.

## Поведение клиента

* **Ключ задан и известен** → клиент рендерит соответствующую нативную иконку.
* **Ключ пустой (`null` / `""`)** → fallback на дефолтную иконку слота:
  * `botUrl` → `send` (бумажный самолётик)
  * `channelUrl` → `megaphone` (рупор)
  * `supportUrl` → `help` (вопросительный знак)
* **Ключ задан, но неизвестен клиенту** (старая версия приложения + новый ключ) → fallback на тот же дефолт.

## Полный список пресетов

Всего 20 ключей. Имя ключа **стабильно** — один раз опубликованный ключ не переименовывается.

### Бот / сообщения

| Ключ      | Превью | Назначение                                     |
| --------- | :----: | ---------------------------------------------- |
| `send`    |   ✈️   | Бумажный самолётик (по умолчанию для `botUrl`) |
| `bot`     |   🤖   | Робот                                          |
| `chat`    |   💬   | Речевое облачко                                |
| `message` |   ✉️   | Конверт (открытое сообщение)                   |
| `mail`    |   📧   | Почта                                          |

### Новости / вещание

| Ключ        | Превью | Назначение                            |
| ----------- | :----: | ------------------------------------- |
| `megaphone` |   📢   | Рупор (по умолчанию для `channelUrl`) |
| `bell`      |   🔔   | Колокольчик                           |
| `newspaper` |   📰   | Газета                                |
| `rss`       |   📡   | RSS                                   |
| `broadcast` |   📻   | Антенна / радио                       |

### Поддержка / справка

| Ключ       | Превью | Назначение                             |
| ---------- | :----: | -------------------------------------- |
| `help`     |    ❓   | Вопрос (по умолчанию для `supportUrl`) |
| `support`  |   🎧   | Агент поддержки                        |
| `lifebuoy` |   🛟   | Спасательный круг                      |
| `info`     |   ℹ️   | Информация                             |
| `book`     |   📖   | Книга / FAQ                            |

### Акцентные

| Ключ     | Превью | Назначение |
| -------- | :----: | ---------- |
| `crown`  |   👑   | Корона     |
| `star`   |    ⭐   | Звезда     |
| `gem`    |   💎   | Алмаз      |
| `rocket` |   🚀   | Ракета     |
| `heart`  |   ❤️   | Сердце     |

## Маппинг на нативные иконки

Для справки — какие нативные иконки рендерятся на каждой платформе. Добавлять / менять маппинг нужно одновременно в трёх клиентах + web-панели.

| Ключ        | Material Icons (Android / Desktop) | SF Symbols (iOS)                    |
| ----------- | ---------------------------------- | ----------------------------------- |
| `send`      | `Send`                             | `paperplane.fill`                   |
| `bot`       | `SmartToy`                         | `apps.iphone`                       |
| `chat`      | `Chat`                             | `bubble.left.fill`                  |
| `message`   | `Message`                          | `message.fill`                      |
| `mail`      | `Email`                            | `envelope.fill`                     |
| `megaphone` | `Campaign`                         | `megaphone.fill`                    |
| `bell`      | `Notifications`                    | `bell.fill`                         |
| `newspaper` | `Newspaper`                        | `newspaper.fill`                    |
| `rss`       | `RssFeed`                          | `dot.radiowaves.left.and.right`     |
| `broadcast` | `Podcasts`                         | `antenna.radiowaves.left.and.right` |
| `help`      | `HelpOutline`                      | `questionmark.circle`               |
| `support`   | `SupportAgent`                     | `person.fill.questionmark`          |
| `lifebuoy`  | `MedicalServices`                  | `lifepreserver`                     |
| `info`      | `Info`                             | `info.circle`                       |
| `book`      | `MenuBook`                         | `book.fill`                         |
| `crown`     | `EmojiEvents`                      | `crown.fill`                        |
| `star`      | `Star`                             | `star.fill`                         |
| `gem`       | `Diamond`                          | `diamond.fill`                      |
| `rocket`    | `RocketLaunch`                     | `paperplane.fill`                   |
| `heart`     | `Favorite`                         | `heart.fill`                        |

## Пример

```json
{
  "settings": {
    "liteMode": true,
    "botUrl": "https://t.me/my_bot",
    "botIconKey": "bot",
    "channelUrl": "https://t.me/my_channel",
    "channelIconKey": "megaphone",
    "supportUrl": "https://t.me/my_support",
    "supportIconKey": "lifebuoy"
  }
}
```

В карточке подписки пользователь увидит три кнопки: робот (бот), рупор (канал), спасательный круг (поддержка).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://incy.gitbook.io/docs/premium-api/presety-ikonok.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.