Вебхуки Сигнального центра

Вебхуки позволяют автоматически или вручную доставлять сигналы Сигнального центра на внешний URL — торговый терминал, бот или собственный сервис. Функция доступна только подписчикам Signals Pro.

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

Режимы срабатывания

При создании вебхука выбирается один из двух режимов:

• Auto — вебхук срабатывает автоматически при каждом сигнале, прошедшем фильтры. Не требует ручного вмешательства. Подходит для полностью автоматизированной торговли.

• Manual — вебхук срабатывает только по команде из Telegram-бота. Когда бот присылает сигнал, рядом с ним появляется кнопка «Открыть сделку». Нажатие на кнопку отправляет запрос на URL вебхука. Подходит для полуавтоматической торговли, когда решение принимает трейдер, а исполнение делегируется вебхуку.

Безопасность

• URL вебхука должен использовать протокол HTTPS. HTTP-адреса не принимаются.
• URL хранится в зашифрованном виде и не отображается в интерфейсе после сохранения.
• При редактировании существующего вебхука URL можно не указывать — в этом случае сохранится текущий адрес.

Создание вебхука (пошагово)

1. Перейдите на страницу /signals/center/webhooks.
2. Нажмите «Создать вебхук».
3. Заполните основные поля:
   • Название — произвольное имя для идентификации (например, «Finandy BTC Long»).
   • URL — HTTPS-адрес, на который будут отправляться POST-запросы.
4. Выберите режим срабатывания: Auto или Manual.
5. Настройте шаблон сообщения (подробнее ниже).
6. Добавьте источники сигналов через конструктор (подробнее ниже).
7. Нажмите «Создать».

Шаблон сообщения (Message Template)

Шаблон определяет тело POST-запроса, которое отправляется на URL вебхука. Формат — произвольный текст (обычно JSON). В шаблоне можно использовать переменные в двойных фигурных скобках.

Доступные переменные:

Переменные, не относящиеся к конкретному сервису, подставляются как пустая строка. Например, {{quality}} будет пустым для сигналов Impulse.

Пример шаблона для Finandy:

{
  "name": "Hook 12345",
  "secret": "your_secret_here",
  "side": "{{side}}",
  "symbol": "{{ticker}}"
}

Конструктор источников сигналов

Конструктор позволяет указать, от каких сервисов и с какими параметрами вебхук должен получать сигналы. Можно добавить от одного до трёх источников (Impulse, Bablo, Strong Signal). Каждый источник настраивается независимо.

Impulse:

• Направления: Growth, Fall или оба.
• Минимальный процент (по умолчанию 10%).
• Включение/исключение конкретных монет.

Bablo:

• Направления: Long, Short или оба.
• Минимальное качество (по умолчанию 7).
• Таймфреймы: 1m, 5m, 15m, 30m, 1h (можно выбрать несколько или все).
• Включение/исключение конкретных монет.

Strong Signal:

• Направления: Long, Short или оба.
• Включение/исключение конкретных монет.

Если ни один источник не добавлен, вебхук будет получать все сигналы без фильтрации.

Тестирование

После создания вебхука в режиме редактирования появляется кнопка «Тест». Она отправляет тестовый запрос на указанный URL и показывает результат: HTTP-код ответа и задержку в миллисекундах.

Рекомендуется всегда тестировать вебхук перед включением в рабочий режим.

Лог доставок (Delivery Log)

Каждая отправка вебхука фиксируется в логе доставок. Для каждой записи сохраняются:

• Сервис-источник сигнала.
• Торговая пара.
• HTTP-код ответа.
• Задержка ответа (мс).
• Статус: успех или ошибка.
• Сообщение об ошибке (при наличии).
• Время доставки.

Лог помогает диагностировать проблемы с доставкой и убедиться, что вебхук работает корректно.

Мониторинг здоровья (Health Tracking)

Система автоматически отслеживает состояние каждого вебхука:

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

При накоплении большого числа последовательных ошибок вебхук может быть автоматически деактивирован для предотвращения бесполезных запросов.

Интеграция с Finandy

Для подключения вебхука к Finandy:

1. В настройках Finandy создайте хук (Hook) и скопируйте URL.
2. Добавьте оба IP-адреса серверов SrgArt в белый список Finandy: 185.26.120.221 и 178.212.12.186.
3. Создайте вебхук в Сигнальном центре, указав URL хука из Finandy.
4. Настройте шаблон сообщения в соответствии с документацией Finandy.
5. Протестируйте вебхук кнопкой «Тест».

Без добавления обоих IP в белый список Finandy будет отклонять запросы от серверов SrgArt.

Статусы вебхука