> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taimly.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Категории Gmail

> Справочник категорий, которые возвращает Taimly API, и что они означают для доставляемости

## Что считается Inbox?

В контексте email-маркетинга **Inbox** — это категории, в которых пользователь реально видит и читает письма:

| Категория    | Входит в Inbox? | Пояснение                                                           |
| ------------ | :-------------: | ------------------------------------------------------------------- |
| `primary`    |        ✅        | Основная папка входящих — лучший результат                          |
| `updates`    |        ✅        | Вкладка «Рассылки/Оповещения» — пользователь проверяет её регулярно |
| `promotions` |        ❌        | Промоакции — открываемость значительно ниже                         |
| `social`     |        ❌        | Соцсети — редко проверяется                                         |
| `forums`     |        ❌        | Форумы — редко проверяется                                          |
| `spam`       |        ❌        | Спам — пользователь не увидит письмо                                |
| `trash`      |        ❌        | Корзина — письмо удалено                                            |

<Info>
  При расчёте **Inbox Rate** учитывайте `primary` + `updates`. Остальные категории означают, что письмо фактически не дошло до пользователя.
</Info>

## Все категории

<ResponseField name="primary" type="string">
  **Входящие** — письмо в основной папке. Пользователь увидит его сразу. Лучший результат для любого типа рассылки.
</ResponseField>

<ResponseField name="updates" type="string">
  **Оповещения** — транзакционные письма, уведомления, подтверждения. Считается частью Inbox — пользователи регулярно проверяют эту вкладку.
</ResponseField>

<ResponseField name="promotions" type="string">
  **Промоакции** — Gmail определил письмо как рекламное. Открываемость в этой категории значительно ниже. Требуется доработка контента и репутации отправителя.
</ResponseField>

<ResponseField name="social" type="string">
  **Соцсети** — уведомления от социальных сетей и похожих сервисов. Не считается Inbox.
</ResponseField>

<ResponseField name="forums" type="string">
  **Форумы** — письма от форумов, групп рассылки, мейлинг-листов.
</ResponseField>

<ResponseField name="spam" type="string">
  **Спам** — письмо в папке «Спам». Критическая проблема — проверьте SPF, DKIM, DMARC и репутацию домена.
</ResponseField>

<ResponseField name="trash" type="string">
  **Корзина** — письмо удалено автоматически. Возможна проблема с фильтрами на стороне получателя.
</ResponseField>

<ResponseField name="unknown" type="string">
  **Неизвестно** — Gmail не присвоил распознаваемую категорию. Встречается редко.
</ResponseField>

<ResponseField name="pending" type="string">
  **Ожидание** — письмо ещё не получено этим аккаунтом. Появляется только при опросе результатов, пока проверка не завершена.
</ResponseField>

## Приоритет определения

Если письмо имеет несколько лейблов Gmail, используется следующий приоритет:

```
spam → trash → primary → updates → promotions → social → forums → unknown
```

<Info>
  Наиболее критичный лейбл всегда приоритетнее. Если письмо помечено и как `SPAM`, и как `CATEGORY_PROMOTIONS` — результат будет `spam`.
</Info>

## Расчёт Inbox Rate

Формула для определения процента доставляемости во Входящие:

```
Inbox Rate = (primary + updates) / total × 100%
```

**Пример:**

| Результат                             | Расчёт                      |
| ------------------------------------- | --------------------------- |
| 3× primary, 1× updates, 1× promotions | Inbox Rate = 4/5 = **80%**  |
| 5× primary                            | Inbox Rate = 5/5 = **100%** |
| 2× primary, 2× spam, 1× promotions    | Inbox Rate = 2/5 = **40%**  |