API-пайплайн: ИИ читает группы пачками, публикует обзор в ваш канал и передаёт находки радару

Индекс: API-пайплайны — индекс · Жизненный цикл: API-пайплайн: создать, настроить, запустить, остановить, измерить и удалить Telegram-кампанию любого вида

Цель: ИИ пачками читает, что говорят в ваших группах, публикует обзор со своими находками в ваш Telegram-канал и может передать находки радару для первого контакта.

Шаги

1. Создать (Paused).

POST /v0/my/campaigns
Idempotency-Key: scout-bali-1
{"title": "Bali rentals scout", "kind": "mtproto_ai_scout", "project_nonce": "<Pro project>",
 "agenda": "<swappable agenda>", "oracles": ["<oracle nonce>"], "tg_groups": ["<preset nonce>"],
 "batch_window": "6h", "batch_messages": 500, "outreach_campaign": "<your radar nonce>"}
→ {"nonce": "470390000000000001", "kind": "mtproto_ai_scout", "status": "Paused", …}

• agenda: объясняет ИИ, что для вас важно, что считать шумом и как писать обзор.
• Пачка закрывается каждые batch_window (15m | 30m | 60m | 3h | 6h | 12h | 24h | 72h; по умолчанию 6h) или после batch_messages сообщений (50–2000; по умолчанию 500) — что наступит раньше.
• outreach_campaign (необязательно): один из ваших радаров; находки, которые ИИ отметит для outreach, уходят в него для первого контакта. API-пайплайн: слушать Telegram-группы и находить людей, которым вы нужны: создать и настроить радар, работать с его совпадениями и выходить на первый контакт (черновик, отправка, автоматический outreach)

2. Запустить. POST /v0/my/campaigns/470390000000000001/start → {"success": true, "status": "Active", "is_active": true}. При первом запуске один из ваших оракулов создаёт Telegram-канал « · AI Scout»; ссылка-приглашение в него есть на карточке как overview_chat_link.

3. Читать. Каждая пачка публикует обзор со своими находками (причина + ссылка на сообщение) в этот канал и сохраняет его в overviews_workspace кампании: GET /v0/my/workspaces/<overviews_workspace>.

4. Остановить. POST …/stop. Работает, пока вы её не остановите.

За кадром

• Каждая пачка — запуск ИИ по вашей агенде; его стоимость видна в ваших расходах на ИИ: API-пайплайн: ваши расходы на ИИ. Цены: link
• Находки, переданные радару, следуют правилам outreach этого радара.

Правила

• Для запуска нужны Pro-проект, агенда, оракулы и группы: 400 ai scout requires an agenda assigned, ai scout requires oracles assigned, ai scout requires telegram groups assigned.
• batch_window / batch_messages вне допустимых наборов → 400; outreach_campaign должен быть вашим радаром (400 outreach_campaign must be a radar campaign).

Поверхность API