API и вебхуки для Telegram
Подключите к Zion Tools свои сервисы. Ключ API даёт вашим программам доступ к данным кабинета (балансу, аккаунтам, маршрутам и журналам модулей), а ключ с записью ещё отправляет сообщения и добавляет записи. Входящий вебхук — адрес, на который сайт, CRM, TradingView, Zapier или Make присылают запрос, а Zion сразу пишет сообщение в чат Telegram или запись в «Бухгалтерию».
Как это выглядит
Для чего подходит
Как это работает
Создайте ключ или вебхук
«Настройки» → вкладка «Вебхуки и API»: ключ — с доступом «Только чтение» или «Чтение и запись», вебхук — с действием и чатом или категорией.
Вставьте в свой сервис
Ключ — в заголовок Authorization: Bearer, адрес вебхука — в настройки сайта, CRM, TradingView, Zapier или Make.
Смотрите журнал
Каждый запрос вебхука попадает в журнал: что пришло, что сделано и ошибка, если была. «Проверить» отправляет тестовый запрос прямо из кабинета.
Возможности
Ключи с правами
«Только чтение» — баланс, аккаунты, маршруты и журналы модулей; «Чтение и запись» — ещё сообщения, записи «Бухгалтерии» и AML проверка.
Входящие вебхуки
Принимают JSON, форму или просто текст, поэтому подойдёт любой сервис, который умеет отправлять запрос.
Шаблон сообщения
Поля из JSON подставляются в текст: «Заказ #{order.id} на {amount}». Без шаблона приходит поле text.
От аккаунта или ботом
Сообщение уходит от вашего аккаунта Telegram в любой его чат или ботом «Алертов» в подключённый к нему чат.
Защита
Ключ хранится только в виде хеша и выпускается с паролем кабинета. Деньги через API не двигаются: нет пополнения, вывода и смены тарифа.
Журнал и лимиты
Последние 100 запросов каждого вебхука хранятся в журнале; лимит — 120 запросов в минуту на ключ и 30 на вебхук.
Частые вопросы
Что такое вебхук?
Адрес в интернете, на который один сервис отправляет данные другому, когда что-то произошло. Входящий вебхук Zion Tools принимает такой запрос (например, о новом заказе с сайта) и сразу пишет сообщение в Telegram или запись в «Бухгалтерию».
Чем API отличается от вебхука?
Через API вы сами запрашиваете данные или выполняете действие по ключу, когда это нужно. С вебхуком ваш сервис сам присылает событие, без ключа: секрет содержится в самом адресе вебхука.
Что можно сделать через API?
Получить баланс и тариф, аккаунты и их чаты, маршруты пересылки, записи «Бухгалтерии», чеки, журналы «Алертов» и «Валидатора», операции «Аналитики» и историю баланса. С ключом записи можно ещё отправить сообщение от аккаунта, добавить запись в «Бухгалтерию» и проверить адрес AML.
Можно ли через API пополнить или вывести деньги?
Нет. Пополнение, вывод, стейкинг и смена тарифа — только в кабинете. Платные действия через API (AML проверка) стоят столько же, сколько в кабинете.
Сколько это стоит?
Ключи и вебхуки бесплатны в любом тарифе. Сообщение от аккаунта отправляется, пока тариф оплачен и аккаунт в сети; запись в «Бухгалтерию» — когда модуль подключён.
Как получать события из Zion у себя?
Это исходящие вебхуки: в «Пересылке», «Алертах», «Валидаторе» и других модулях события сами уходят в Discord, Slack, MAX или на ваш адрес. Настраиваются они кнопкой «Исходящие» в разделе «Вебхуки и API».
Начните бесплатно
Регистрация за минуту: email и пароль. Основные продукты доступны на пробном периоде без оплаты, а пять модулей бесплатны в любом тарифе.