API и вебхуки Zion Tools: подключаем сайт и CRM к Telegram
Вкладка Вебхуки и API в «Настройках» соединяет Zion Tools с вашими сервисами: сайтом, CRM, TradingView, Zapier, Make или собственным скриптом. Есть два инструмента, и оба бесплатны в любом тарифе.
- Ключ API — ваши программы сами читают данные кабинета: баланс, аккаунты, маршруты, записи «Бухгалтерии», журналы модулей. Ключ с записью ещё отправляет сообщения от аккаунтов и добавляет записи.
- Входящий вебхук — адрес, на который ваш сервис присылает событие. Zion сразу выполняет действие: пишет сообщение в Telegram или добавляет запись в «Бухгалтерию».
Шаг 1. Выпустите ключ API
Откройте Настройки → вкладку Вебхуки и API и нажмите Создать ключ. Задайте название (например, «CRM») и выберите доступ:
- Только чтение — баланс, аккаунты, маршруты и журналы модулей;
- Чтение и запись — ещё сообщения от аккаунтов, записи «Бухгалтерии» и AML проверка.
Выпуск подтверждается паролем кабинета (и кодом Google Authenticator, если он включён): ключ работает, пока вы его не удалите, и выход из кабинета его не отзывает. Ключ показывается один раз: скопируйте его и сохраните в настройках своей программы. Потеряли — удалите ключ и создайте новый.
Шаг 2. Отправьте первый запрос
Адрес API — https://zion.tools/api/v1, ключ передаётся в заголовке Authorization: Bearer и ваш ключ. Первый запрос — GET /api/v1/me: в ответе профиль, баланс и тариф. Ответы — JSON, суммы — строкой с двумя знаками, время — Unix-время.
Полный список методов — кнопка Все методы в блоке «Как подключиться»: аккаунты и их чаты, маршруты пересылки, записи и категории «Бухгалтерии», чеки, журналы «Алертов» и «Валидатора», операции «Аналитики», история баланса. Длинные списки отдаются страницами: параметры limit и before.
Через API нельзя пополнить или вывести деньги, вложить в стейкинг или сменить тариф — это только в кабинете. Платные действия (AML проверка) стоят столько же, сколько в кабинете. Не больше 120 запросов в минуту на ключ.
Шаг 3. Создайте входящий вебхук
В блоке Входящие вебхуки нажмите Создать вебхук, задайте название и выберите, что делать с запросом:
- Сообщение от аккаунта — в любой чат вашего аккаунта Telegram: выберите аккаунт и чат;
- Сообщение ботом — бот «Алертов» пишет в чат, подключённый к нему в разделе «Алерты»;
- Запись в «Бухгалтерию» — сумма из поля amount попадает в выбранную категорию.
После сохранения адрес вебхука скопируется сам — вставьте его в настройки своего сервиса. Адрес — секрет: кто его знает, тот может отправить запрос. Если он попал не туда, нажмите «Новый адрес» — прежний сразу перестанет работать.
Шаг 4. Настройте текст сообщения
Вебхук принимает JSON, форму или просто текст. Без шаблона в Telegram придёт поле text (или message, content), а если его нет — все поля запроса строками «поле: значение».
С шаблоном поля из JSON подставляются в текст в фигурных скобках. Например, шаблон «Новый заказ #{order.id} на {amount}» и запрос {"order": {"id": 1024}, "amount": 59} дают сообщение «Новый заказ #1024 на 59». До элементов списка можно добраться по номеру: {items.0.name}.
Для «Бухгалтерии» сумма берётся из поля amount (1500 или -249.90), другая категория — из поля category (команда или название), а комментарий — по шаблону или из поля comment.
Шаг 5. Проверьте и следите за журналом
Кнопка Проверить у вебхука отправляет тестовый запрос прямо из кабинета. Запрос выполнится по-настоящему, а внизу окна есть готовая команда curl для своего сервиса. У каждого вебхука — счётчик запросов, время последнего и Журнал: что пришло, что сделано и ошибка, если была (например, «Нет суммы» или «Аккаунт не в сети»). Переключатель выключает вебхук, не удаляя его.
Сообщение от аккаунта уходит, пока тариф оплачен и аккаунт в сети; не больше 30 запросов в минуту на вебхук.
А если нужно наоборот
Чтобы события из Zion сами приходили в ваш сервис — новые сообщения из пересылки, срабатывания «Алертов», найденные дубликаты, чеки, — используйте исходящие вебхуки: кнопка Исходящие на той же вкладке. Они отправляют события в Discord, Slack, MAX или на ваш адрес с подписью.
Подробнее: Вебхуки и API.