Разделы документации
Zapnoty — REST API уведомлений через Telegram и Max. Подписчики подписываются через deep link, разработчик через API отправляет им сообщения, OTP-коды, рассылки, а также принимает заявки форм и тикеты поддержки.
Быстрый старт
Три шага до первого уведомления.
1
1. Создайте проект
Зарегистрируйтесь через Яндекс или ВК, создайте проект в дашборде.
2
2. Получите API-ключ
В настройках проекта скопируйте API-ключ формата zn_aBcDeFgH...
3
3. Отправьте первый запрос
Используйте curl или любой HTTP-клиент:
curl -X POST https://api.zapnoty.com/v1/send
-H "Authorization: Bearer zn_aBcDeFgH..."
-H "Content-Type: application/json"
-d '{
"subscriber_id": "550e8400-e29b-41d4-a716-446655440000",
"text": "Привет!"
}'
Интерактивная API-справка
OpenAPI 3.1: все эндпоинты, схемы, примеры. Спека — /openapi.yaml
Основные API
Быстрый старт
Первое сообщение за 2 минуты: получение ключа, deep link для подписки, отправка через curl.
Аутентификация
Как авторизовать запросы к API через Authorization: Bearer zn_… ключ проекта.
Authorization: Bearer zn_
POST /v1/send — отправка
Отправка персональных уведомлений: текст, HTML/Markdown, медиа, кнопки, шаблоны.
POST /v1/send
OTP — коды подтверждения
Генерация и проверка 6-значных кодов. Отдельный flow для пользователей без подписки.
POST /v1/otp/send· +3
Broadcast — массовая рассылка
Рассылка всем подписчикам или сегменту. Асинхронная обработка, polling статуса.
POST /v1/broadcast· +3
Расписание и автоматизации
Отложенные сообщения, drip-цепочки по триггерам, рассылки раз в N часов.
POST /v1/scheduled· +3
Авторизация через ботов
Вход на ваш сайт через Telegram/Max одной кнопкой. Authorization Code flow.
GET /v1/auth/link· +3
Helpdesk — тикеты поддержки
Встроенная поддержка клиентов: тикеты, ответы агентов, виртуальные пользователи без мессенджера.
POST /v1/helpdesk/tickets· +10
Формы — приём заявок
Приём заявок с сайтов без API-ключа, маршрутизация в email/мессенджер/подписчикам.
POST /f/{form_id}
Справочник
Подписчики и теги
Получение списка, установка тегов, фильтрация по каналу и сегменту.
GET /v1/subscribers· +2
Управление проектом
Шаблоны, разрешения, теги, webhooks, авто-сообщения — CRUD через API.
CRUD /v1/templates· +4
Разрешения подписчиков
Permissions — типы согласий подписчика: создание, opt-out, фильтр рассылок.
GET/POST /v1/permissions· +1
Тестирование интеграции
Как тестировать интеграцию: test-ключи, dry-run, preview, проверка вебхуков.
zn_test_ keys· +3
Гайды
Пошаговые сценарии: первая отправка, OTP, рассылки, автоматизация, вебхуки.
Ошибки, лимиты и retry
Коды ошибок, rate limit, retry-политика для идемпотентных запросов.
codes: not_found, unauthorized, forbidden, bad_request, rate_limit, conflict, internal_error
Playground — тест API
Интерактивный конструктор запросов: curl + JSON-тело для /v1/send, /v1/otp/send и других.
Интеграции
Webhooks — входящие события
Входящие события: подписка, доставка, рассылка, тикеты, формы. HMAC-подпись.
X-Zapnoty-Signature· +1
Virtual Projects — AI-настройка проекта
AI создаёт и настраивает проект под пользователя через MCP. Пользователь только Accept.
POST /v1/virtual-projects· +2
MCP-сервер для AI-агентов
Подключите Zapnoty к AI-агенту: ~60 инструментов поверх API через Model Context Protocol.
mcp.zapnoty.com/mcp· +2
Custom Bots — свой бот (white-label)
Подключите свой Telegram/Max бот: своё имя, приветствие, команды и брендинг.
bot_mode: system|custom· +2