Обязательная подпискаПодтверждённое действие
EVIR для разработчиков
Подключите бота без вмешательства в его архитектуру
Используйте управляемый режим или оставьте Telegram updates у себя. Документация открыта без авторизации и не содержит секретов владельца.
- HTTPS JSON API
- Bearer-ключ на подключение
- Подписанные webhooks
Три точки входа
Инструкция подключения
Как выбрать managed или API, проверить выдачу и передать ключ разработчику.
Открыть инструкциюAPI
Получение assignments, подтверждение отправки и обработка повторов.
Открыть APIWebhooks
События результатов, отписок, подпись запроса и безопасный bootstrap.
Открыть webhooksОсновные правила интеграции
Храните ключ только на сервере
Не вставляйте EVIR API key, токен Telegram или webhook secret в frontend и публичные ссылки.
Подтверждайте только факт
В доверенном SDK вызывайте /served только после подтверждённого успешного ответа Telegram. Это заявление интегратора; при ошибке отправки подтверждение не вызывается.
Повторяйте безопасно
Повторяйте запрос для того же recipient и delivery. Не пересылайте карточку заново, если результат Telegram неизвестен.
Проверяйте подпись webhook
Сверяйте timestamp, digest и raw body до обработки события.
Что остаётся приватным
Публичный номер подключения
Его можно добавить в ссылку на инструкцию. Сам по себе он не даёт доступ к API.
Одноразовый API key
Показывается владельцу отдельно и передаётся разработчику через защищённый канал.
Webhook secret
Создаётся для конкретного endpoint и никогда не добавляется в общую документацию.
Коротко и по делу
Что часто спрашивают
Откройте вопрос, чтобы увидеть ответ. Больше технических деталей — в документации.
Все вопросыEVIR заберёт существующий Telegram webhook?
В режиме API — нет. В managed-режиме EVIR сначала читает текущее состояние и не перезаписывает чужой webhook без явного безопасного перехода.
Можно ли открыть документацию без Telegram?
Да. Все страницы документации доступны в обычном браузере без входа.
Номер подключения является секретом?
Нет, но API key и webhook secret являются секретами. Один номер подключения не авторизует запрос.
EVIR внутри Telegram