Webhook API — REST для кросспостинга в Telegram, VK и Max

Программный кросспостинг через REST. Один webhook — три платформы.

Возможности

Простой Bearer-токен

Никаких OAuth-редиректов или регистраций приложений. Authorization: Bearer crossly_live_... — стандартный паттерн который понимают все SDK, LLM-агенты и no-code инструменты.

Принимаем Telegram Bot API entities

Входящий webhook принимает payload с entities (offset/length/type) — формат Telegram. Существующий код для отправки в Telegram переиспользуется почти без изменений. Crosslybot конвертирует под VK и Max сам. Исходящий webhook отдаёт уже готовый text + text_html.

Idempotency-Key из коробки

Стандарт Stripe-style. Передайте Idempotency-Key или external_id — повторный запрос с тем же ID вернёт закэшированный результат. Безопасные ретраи, никаких дубликатов постов.

Sandbox для тестирования

POST /v1/sandbox/test валидирует payload без реальной публикации. Sandbox доступен на всех тарифах (Free 100/день, Mini 1000/день, Standard+ без лимита). Идеально для CI/CD.

Изоляция API: wh.crosslybot.ru

Webhook API живёт на отдельном поддомене — не пересекается с Mini App. DDoS на webhook не положит основной API. Отдельные rate limit'ы, отдельная документация.

Префиксы токенов crossly_live_/test_

Тестовые токены легко отличаются от живых при просмотре логов. Удобно при разработке: один webhook на dev, другой на prod, никакой путаницы.

Частые вопросы

На каком тарифе доступен Webhook API?

Webhook input (приём постов от внешних систем) — на тарифах Pro, Maxi и Business. Webhook output (отправка постов наружу) — со Standard и выше. Sandbox для тестирования — на всех тарифах включая Free (100 запросов/день).

Чем Webhook API лучше прямой работы с Telegram Bot API?

Один эндпоинт вместо трёх (TG/VK/Max), не нужен OAuth для VK, не нужны сложности с file_id Telegram, AI-обработка из коробки (перевод/стиль), фильтры рекламы, очередь публикаций, мониторинг ошибок. Время интеграции: 5 минут vs дни.

Можно ли отправлять с n8n / Make.com / Zapier / IFTTT?

Да, любой HTTP-клиент работает: n8n HTTP Request узел, Make.com HTTP module, Zapier Webhooks Action. Подробные гайды: см. /webhook/n8n-integration.

Поддерживается ли rate limiting?

Да, многоуровневый. Burst (1 запрос за N секунд) + дневная квота. По тарифу: Pro 1/5с + 300/час, Maxi 1/2с + 1000/час, Business 1/1с + 5000/час. При систематических нарушениях endpoint временно ставится на паузу с уведомлением.

Безопасность — как защищены endpoints?

1) Bearer-токены: plaintext показывается один раз при создании. 2) Валидация media URL (только https://, белый список типов, проверка реального mime-type). 3) Идемпотентность через Idempotency-Key. 4) HMAC-подпись на исходящих webhooks. 5) Тарифные ограничения и rate limit. 6) История запросов в UI.

Где OpenAPI-документация?

OpenAPI 3 спецификация генерируется автоматически из Pydantic-схем backend. Публичная Swagger UI на /docs планируется в следующих фазах. Уже сейчас есть: гайды по сценариям, sandbox-tester, примеры curl/Python.

Webhook API — открытая платформа для разработчиков и AI-агентов внутри Crosslybot. Вместо того чтобы интегрироваться с тремя разными API социальных сетей (Telegram Bot API, VK API, Max API), вы делаете один HTTP-запрос на webhook URL — и пост публикуется во всех настроенных каналах.

API спроектирован под developer experience: Bearer-токен, Idempotency-Key (как Stripe), entities-совместимый формат (как Telegram), префиксы токенов (как GitHub), sandbox-тестер (как Postman). Никаких неожиданных паттернов — всё что разработчик ожидает увидеть в современном REST API.

Кому это нужно

  • AI-стартапы и копирайтеры с GPT/Claude — нужно автоматически публиковать сгенерированный контент в свои каналы
  • No-code команды на n8n / Make.com / Zapier — собирают workflow из готовых блоков, нужен HTTP-узел публикации в соцсети
  • Контент-команды с Notion-календарём — Status: Ready → автопубликация
  • Новостные агрегаторы и RSS-проекты — собирают данные из множества источников, публикуют в свои каналы
  • Разработчики кастомных сервисов — пишут свой backend, нужен простой способ постинга

Связанные гайды

Webhook input доступен на тарифах Pro, Maxi и Business.

Бесплатный тариф

Готовы попробовать?

Подключите бота за 2 минуты. Бесплатный тариф — без карт и регистраций.

Подробнее о боте →