Перейти к содержимому
Notifly

Введение

Notifly — это SaaS для уведомлений, мониторинга и обратной связи. Один HTTP-запрос — и сообщение от вашего сервера, скрипта, CMS или AI-агента прилетает на телефон, в браузер, на почту или в Telegram. Ни своих воркеров, ни очередей, ни бэкенда.

Как это устроено

Заголовок раздела «Как это устроено»

Любое уведомление проходит один и тот же путь:

источник                     канал                        получатель
(сервер, скрипт, CMS,  ──▶  «Мой сайт»,       ──▶  устройство: Android-приложение,
 монитор, AI-агент)          app-токен A…            открытая вкладка админки, iOS-приложение
                                  │
                                  └─ не прочитано вовремя? ──▶ эскалация: email, SMS, звонок,
                                                               Telegram, Slack и другие

Первое уведомление за пять шагов

Заголовок раздела «Первое уведомление за пять шагов»

  1. Аккаунт. Зарегистрируйтесь в личном кабинете и подтвердите e-mail по ссылке из письма.

  2. Канал и app-токен. При первом входе откроется мастер первого запуска: нажмите «Создать первый канал» — он покажет app-токен канала и готовую команду с ним. Позже токен всегда можно найти в разделе «Каналы».

  3. Получатель. Чтобы уведомление было куда доставить, подключите устройство:

    • поставьте Android-приложение и войдите тем же e-mail и паролем — уведомления будут приходить и при закрытом приложении;
    • или держите открытой вкладку админки и нажмите в боковом меню «Разрешить уведомления» — браузер покажет уведомление, пока вкладка открыта.

  4. Тестовое сообщение. Подставьте app-токен и выполните:

    Окно терминала
    curl -X POST "https://api.notifly.ru/message" \
      -H "X-Notifly-Key: <APP_TOKEN>" \
      -H "Content-Type: application/json" \
      -d '{"title": "Привет", "message": "Первое сообщение из Notifly", "priority": 5}'

  5. Проверка. В ответ придёт JSON с id сообщения; само сообщение появится в ленте админки, а на устройстве из шага 3 — системное уведомление. Ответ пришёл, а уведомления нет — см. «Не приходят уведомления».

Подробный разбор каждого шага — в «Первом входе», все параметры отправки — на странице «Отправка сообщений».

Основные понятия

Заголовок раздела «Основные понятия»
  • Канал — источник сообщений (бэкенд-сервис, скрипт, бот) со своим app-токеном (префикс A). App-токен умеет только отправлять в свой канал.
  • Сообщение — текст, заголовок, приоритет от 0 до 10, дата и необязательные доп. поля (extras).
  • Устройство — веб-админка, Android- или iOS-приложение, в котором вы вошли в аккаунт. Получает сообщения и управляет каналами, но сам в каналы не пишет.

В API и MCP-инструментах исторически другие названия: канал там — application, устройство — client (пути совместимы с протоколом Gotify). Это те же сущности.

Каждый пользователь видит и управляет только своими каналами, устройствами и сообщениями — и каналами, к которым ему дали доступ. Подробнее — Каналы и устройства.

Какой токен для чего

Заголовок раздела «Какой токен для чего»

Токены различаются по первой букве:

ПрефиксТокенДля чего
Aapp-токен каналаОтправлять сообщения и вопросы в один канал. Его вставляют в скрипты, CMS и curl
Sтокен доступа к каналуТо же, что A, но для того, с кем каналом поделились; отправка — при праве send
MAPI-токенУправлять аккаунтом из кода: SDK, CLI, MCP-сервер. Права read или read+write, скоуп по каналам
Cтокен устройстваСессия приложения или браузера. Выдаётся при входе, для интеграций не нужен
Hping-токен heartbeatТолько в URL пинга /heartbeat/ping/{token}
Rтокен webhook-роутераТолько в URL /router/{token}/…
Tтокен скрипта для сайтаТолько в URL приёма событий скрипта

Новичку нужен только app-токен A. Полное описание — в разделе «Аутентификация» документации API.

Веб-интерфейс Notifly: клиенты, каналы и лента сообщений

Что дальше

Заголовок раздела «Что дальше»