Pipeline de API: que la IA lea grupos por lotes, publique un resumen en tu canal y pase selecciones a un radar
Índice: Pipelines de API — índice · Ciclo de vida: Pipeline de API: crear, configurar, iniciar, detener, medir y eliminar una campaña de Telegram de cualquier tipo
Objetivo: la IA lee por lotes lo que se dice en tus grupos, publica un resumen con sus selecciones en un canal de Telegram tuyo y puede pasar las selecciones a un radar para el primer contacto.
Pasos
1. Crear (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: le dice a la IA qué te importa, qué es ruido y cómo escribir el resumen.- Un lote se cierra cada
batch_window(15m | 30m | 60m | 3h | 6h | 12h | 24h | 72h; por defecto 6h) o trasbatch_messagesmensajes (50–2000; por defecto 500), lo que llegue antes. outreach_campaign(opcional): uno de tus radares; las selecciones que la IA marca para outreach van a él para el primer contacto. Pipeline de API: escuchar grupos de Telegram para encontrar a quien te necesita: crear y ajustar un radar, trabajar sus coincidencias y hacer el primer contacto (borrador, envío, outreach automático)
2. Iniciar. POST /v0/my/campaigns/470390000000000001/start → {"success": true, "status": "Active", "is_active": true}. En el primer inicio uno de tus oráculos crea un canal de Telegram « · AI Scout»; su enlace de invitación está en la tarjeta como overview_chat_link.
3. Leer. Cada lote publica en ese canal un resumen con sus selecciones (motivo + enlace al mensaje) y lo guarda en el overviews_workspace de la campaña: GET /v0/my/workspaces/<overviews_workspace>.
4. Detener. POST …/stop. Sigue hasta que la detengas.
En segundo plano
- Cada lote es una ejecución de IA según tu agenda; su coste aparece en tu gasto de IA: Pipeline de API: ver tu gasto en IA. Precios: link
- Las selecciones pasadas a un radar siguen las reglas de outreach de ese radar.
Reglas
- Iniciar requiere un proyecto Pro, una agenda, oráculos y grupos: 400
ai scout requires an agenda assigned,ai scout requires oracles assigned,ai scout requires telegram groups assigned. batch_window/batch_messagesfuera de los conjuntos → 400;outreach_campaigndebe ser un radar tuyo (400outreach_campaign must be a radar campaign).
Superficie de la API
| Endpoint | Para qué | FE | IA / oráculo |
|---|---|---|---|
POST /v0/my/campaigns (kind: mtproto_ai_scout) |
Crear | sí | sí |
PATCH /v0/my/campaigns/{nonce} |
Agenda, grupos, oráculos, lotes, radar de destino | sí | sí |
POST /v0/my/campaigns/{nonce}/start, /stop |
Iniciar / detener | sí | sí |
GET /v0/my/campaigns/{nonce} |
overview_chat_link, overviews_workspace |
sí | sí |
GET /v0/my/workspaces/{overviews_workspace} |
Leer los resúmenes | sí | sí |