API-пайплайн: ваши оракулы ставят реакции на свежие сообщения в группах в выбранном темпе
Индекс: API-пайплайны — индекс · Жизненный цикл: API-пайплайн: создать, настроить, запустить, остановить, измерить и удалить Telegram-кампанию любого вида
Цель: ваши оракулы ставят реакции на свежие сообщения в группах — выбранными вами эмодзи и в выбранном вами темпе.
Шаги
1. Создать (Paused).
POST /v0/my/campaigns
Idempotency-Key: react-bali-1
{"title": "Bali reactions", "kind": "mtproto_reactions", "project_nonce": "<Pro project>",
"oracles": ["<oracle nonce>"], "tg_groups": ["<preset nonce>"],
"reactions": ["👍", "🔥", "❤"], "speed": "slow"}
→ {"nonce": "470410000000000001", "kind": "mtproto_reactions", "status": "Paused", …}
reactions: 1–16 эмодзи; для каждого сообщения выбирается случайная из тех, что разрешены в группе.tg_groups: необязательно; пусто — значит все группы, в которых состоят оракулы.speed: x_slow | slow | medium (по умолчанию) | fast | x_fast: на сколько сообщений в день реагирует каждый оракул.
2. Запустить. POST /v0/my/campaigns/470410000000000001/start → {"success": true, "status": "Active", "is_active": true}.
3. Следить. GET /v0/my/campaigns/470410000000000001/performance → totals.reacted, по дням (timeline[].reacted) и по группам (groups[].reacted).
4. Остановить. POST …/stop. Работает, пока вы её не остановите.
За кадром
- Реакции получают только недавние сообщения.
- Изменения оракулов или групп подхватываются на ходу.
Правила
- Для запуска нужны Pro-проект, оракулы и хотя бы одна реакция: 400
assign oracles before activating,assign at least one reaction before activating. - Реакция, которая не эмодзи → 400
reaction "…" is not an emoji; больше 16 → 400at most 16 reactions.
Поверхность API
| Эндпоинт | Назначение | FE | ИИ / оракул |
|---|---|---|---|
POST /v0/my/campaigns (kind: mtproto_reactions) |
Создать | да | да |
PATCH /v0/my/campaigns/{nonce} |
Реакции, speed, группы, оракулы | да | да |
POST /v0/my/campaigns/{nonce}/start, /stop |
Запустить / остановить | да | да |
GET /v0/my/campaigns/{nonce}/performance |
Реакции по дням и группам | да | да, отчёты |