PartyFlow

Разработчикам

Документация по интеграциям

Webhook'и, боты, slash-команды и интерактивные компоненты. Подключайте внешние сервисы к каналам PartyFlow или стройте собственных ботов на открытом REST API.

Быстрый старт

Принять первое сообщение в канал за 5 минут.

Обзор интеграций

Какой способ интеграции подходит для вашей задачи.

Справочник API

Endpoint'ы, payload'ы, коды ошибок, rate limits.

История изменений

Что нового в API и какие есть breaking-изменения.

Все разделы

Начало работы

ОбзорКакие способы интеграции доступны и для чего они подходят.Быстрый стартПервый работающий webhook за 5 минут.История измененийПубличный changelog с пометками о breaking-изменениях.

Концепции

WebhooksВходящие и исходящие webhook'и: жизненный цикл, гарантии доставки.БотыБот-аккаунты, аутентификация, членство в каналах.Slash-командыВстроенные и кастомные команды, trigger_id, коллбэки.БезопасностьHMAC-подпись, anti-replay, ротация секретов.Rate limitsЛимиты отправки, auto-disable, retry-стратегии.

Гайды

Алерты из GrafanaНастройка contact point и шаблона payload.События из GitHubPR/issue-события через FastAPI-прокси.Создание ботаМинимальный onboarding для бот-разработчика.Интерактивный ботКнопки, модалки и approval-flow за 10 минут.Приём outgoing webhookFastAPI-приёмник с idempotency и verify.Проверка подписиHMAC-сниппеты на Python / Node / Go / Bash.

Справочник

Incoming webhook endpointPOST /api/v1/webhooks/incoming/{token} — payload и ответы.Outgoing webhooksКонверт события, retry, rotate_secret, admin-команды.Bot REST APIMessages, Files, Agent Runs, Execution Tasks — endpoint'ы, параметры, ошибки.Bot Event Polling APILong-polling доставка событий боту через GET /api/v1/bot/events.Bot Webhook APIPush-доставка событий боту через HTTPS POST с HMAC-подписью.Формат сообщенияmetadata_json: attachments, blocks, buttons, files.Slash-команды (API)Регистрация, коллбэк, подпись, лимиты.Интерактивные компонентыButtons / select / modal — схема, подпись, ответы.Коды ошибокHTTP-статусы, причины, retry-стратегия.