Pipeline de API: que tus oráculos reaccionen a mensajes recientes en grupos al ritmo que elijas
Í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: tus oráculos reaccionan a mensajes recientes en grupos con los emojis que elijas, al ritmo que elijas.
Pasos
1. Crear (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: de 1 a 16 emojis; para cada mensaje se elige uno al azar entre los que permite el grupo.tg_groups: opcional; vacío significa todos los grupos en los que están los oráculos.speed: x_slow | slow | medium (por defecto) | fast | x_fast: a cuántos mensajes reacciona cada oráculo al día.
2. Iniciar. POST /v0/my/campaigns/470410000000000001/start → {"success": true, "status": "Active", "is_active": true}.
3. Seguir. GET /v0/my/campaigns/470410000000000001/performance → totals.reacted, por día (timeline[].reacted) y por grupo (groups[].reacted).
4. Detener. POST …/stop. Sigue hasta que la detengas.
En segundo plano
- Solo reciben reacciones los mensajes recientes.
- Los cambios de oráculos o grupos se recogen en marcha.
Reglas
- Iniciar requiere un proyecto Pro, oráculos y al menos una reacción: 400
assign oracles before activating,assign at least one reaction before activating. - Una reacción que no es un emoji → 400
reaction "…" is not an emoji; más de 16 → 400at most 16 reactions.
Superficie de la API
| Endpoint | Para qué | FE | IA / oráculo |
|---|---|---|---|
POST /v0/my/campaigns (kind: mtproto_reactions) |
Crear | sí | sí |
PATCH /v0/my/campaigns/{nonce} |
Reacciones, speed, grupos, oráculos | sí | sí |
POST /v0/my/campaigns/{nonce}/start, /stop |
Iniciar / detener | sí | sí |
GET /v0/my/campaigns/{nonce}/performance |
Reacciones por día y grupo | sí | sí, informes |