Содержание
Echobell Direct — это режим персональных оповещений, который полностью обходится без настройки канала. Вы создаёте прямой ключ, получаете URL вебхука и отправляете POST с title и body, чтобы мгновенно получить уведомление на своё устройство. Ни подписчиков, ни шаблонов, ни настройки маршрутизации.
В этом руководстве разбираем, что такое Direct, как его настроить и когда использовать его вместо каналов.
Что такое Echobell Direct?
Каждый прямой ключ создаёт уникальный URL вебхука (/d/{token}). Отправьте запрос на этот URL — и уведомление сразу придёт на ваше устройство.
Используйте Direct, когда вам нужны:
- Персональные уведомления из скриптов, cron-задач или CI-пайплайнов
- Свои заголовок и текст в каждом запросе вместо фиксированных шаблонов
- Быстрая настройка без конфигурации полноценного канала
Если нужны общие уведомления, переиспользуемые шаблоны или доставка по условиям, используйте каналы через вебхуки.
Настройка в 3 шага
Шаг 1: создайте прямой ключ
Откройте Echobell, нажмите Direct в списке каналов и создайте ключ. Назовите его по сервису, к которому он относится (например, CI Server, Cron, AI Tasks).
Шаг 2: скопируйте URL вебхука
У каждого ключа есть URL в формате:
https://hook.echobell.one/d/YOUR_KEY_TOKENОтноситесь к этому URL как к секрету — любой, у кого он есть, сможет отправлять вам уведомления.
Шаг 3: отправьте первое уведомление
curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
-H "Content-Type: application/json" \
-d '{
"title": "Deploy failed",
"body": "api-service failed health check",
"notificationType": "time-sensitive",
"externalLink": "https://dashboard.example.com/deploys/123"
}'Полный справочник по полям: Direct API
Уровни срочности
Direct поддерживает notificationType, чтобы вы могли сопоставить срочность с событием:
active— обычные обновленияtime-sensitive— важные оповещения, которые пробиваются через «Фокусирование»calling— критические инциденты (нужна активная подписка Premium; иначе понижается до time-sensitive)
Подробности о поведении — в разделе Типы уведомлений.
Как добавить контекст в оповещения
Передайте externalLink в теле запроса, чтобы прикрепить к уведомлению ссылку, — удобно, чтобы сразу открыть лог деплоя, дашборд или pull request.
Для ИИ-агентов и долгих асинхронных задач Direct — простой способ узнать о завершении работы, не опрашивая статус вручную. См. также: WebhookMCP + Echobell.
Direct или каналы
| Direct | Каналы | |
|---|---|---|
| Получатели | Только вы | Общие с коллегами |
| Шаблоны | Содержимое задаётся в запросе | Переиспользуемые фиксированные шаблоны |
| Время настройки | Меньше минуты | Нужна настройка канала |
| Условия | Не поддерживаются | Поддерживаются |
Используйте каналы, когда оповещения должны доходить до нескольких человек или когда нужно единое оформление в рамках сервиса. Документация по шаблонам · Что такое Echobell
Практики безопасности
- Храните токены Direct в переменных окружения или менеджере секретов, а не в коде
- Создавайте отдельный ключ для каждого сервиса, чтобы отзывать их по отдельности
- Сразу меняйте токен, если URL мог утечь
- Оставьте
callingдля настоящих инцидентов — злоупотребление ведёт к усталости от оповещений
FAQ
Direct только для разработчиков? Нет. Им может пользоваться любой, у кого есть инструмент, умеющий отправлять HTTP-запросы.
Поддерживает ли Direct GET-запросы? Да, но рекомендуется POST с JSON.
Что будет, если подписка закончится, а я использую calling? Уведомление автоматически понизится до time-sensitive.
Начните с руководства по Direct. Когда вашему рабочему процессу понадобятся совместная работа или шаблоны, каналы станут естественным следующим шагом.
Читайте также
- Документация по Direct API — полный справочник по полям и примеры
- WebhookMCP + Echobell — уведомления о завершении задач ИИ через Direct
- Как обойти «Фокусирование» в iOS — как выбрать подходящую срочность уведомления
- Уведомления из Zapier через вебхуки — сценарии автоматизации без программирования
- Типы уведомлений — поведение обычных, срочных и звонковых уведомлений