# Расширение для браузера

Расширение Pocket Alert выводит вашу ленту уведомлений на панель инструментов браузера: счётчик непрочитанных, системные уведомления на рабочем столе и форма для отправки push-уведомлений, не покидая текущую вкладку.

[Установить из Chrome Web Store](https://chromewebstore.google.com/detail/pocket-alert/hnknmapadalodjkmikfhjnmbbhpbhbdk) — работает в Chrome и Edge.

## Что умеет

**Лента.** Ваши последние сообщения карточками, непрочитанные отмечены. Нажмите на карточку, чтобы раскрыть текст и отметить сообщение прочитанным. Фильтруйте по приложению с помощью чипов вверху и подгружайте старые сообщения при прокрутке.

**Отправка.** Заголовок, текст, целевое устройство — или рассылка на все устройства — и приложение, которое укажет источник.

**Счётчик непрочитанных и системные уведомления.** Фоновый процесс опрашивает сервер с интервалом, который вы выбираете, и показывает системное уведомление о каждом новом сообщении.

**Отметить всё прочитанным.** Появляется, только когда есть непрочитанные сообщения.

**Темы.** Светлая, тёмная или как в системе — с теми же токенами, что и в веб-приложении.

**Сохранённые черновики.** Недописанное сообщение сохраняется, даже если вы закрыли всплывающее окно.

## Настройка

1. Установите расширение.
2. Создайте API-ключ на странице [API-ключи](https://pocketalert.app/account/apikeys).
3. Откройте настройки расширения, вставьте ключ и нажмите **Проверить соединение**.
4. Сразу же задайте интервал опроса и размер страницы.

Ключ хранится в хранилище браузера и используется только для обращений к `api.pocketalert.app`. Никуда больше он не передаётся.

> **Tip: Используйте отдельный ключ**
>
> Выдайте расширению собственный API-ключ, а не тот, что используют ваши серверы. Если вы когда-нибудь передадите ноутбук другому человеку или синхронизируете профили между машинами, можно будет отозвать только этот ключ.

## Разрешения и зачем они нужны

| Разрешение | Для чего используется |
|------------|----------|
| `storage` | Локальное хранение API-ключа, настроек и неотправленного черновика |
| `alarms` | Планирование фонового опроса новых сообщений |
| `notifications` | Показ системных уведомлений |
| `host_permissions` для `api.pocketalert.app` | Обращения к API Pocket Alert — и больше ни к чему |

Широкого доступа к сайтам нет. Расширение не может читать страницы, которые вы открываете.

## Связанное

- [CLI](https://info.pocketalert.app/cli.md) — те же операции из терминала
- [Создание сообщения](https://info.pocketalert.app/api/messages/create.md) — API, с которым работает расширение
