Pipeline de API: conectar tu bot de Telegram como oráculo
Índice: Pipelines de API — índice
Objetivo: tu propio bot de Telegram (creado con @BotFather) responde a las personas según la agenda que elijas. Cabi.Chat lo aloja: no necesitas servidor propio y sus conversaciones llegan a tu bandeja de entrada.
Pasos
1. Crear.
POST /v0/my/oracles
Idempotency-Key: oracle-shopbot-1
{"kind": "telegram_bot", "title": "Shop bot", "bot_token": "123456789:AAE…",
"agenda": "<agenda nonce>", "project": "<project nonce>"}
→ {"nonce": "470000000000000002", "card_type": "oracle", "kind": "telegram_bot", "status": "STOPPED", …}
bot_token: tal como lo da @BotFather (<id>:<secret>). Se guarda como clave y no se vuelve a mostrar; para cambiarlo, elimina el oráculo y créalo de nuevo.agenda: obligatoria; con qué responde el bot (una agenda tuya o que puedes ejecutar): Pipeline de API: escribir una agenda para tus oráculos
2. Iniciar.
POST /v0/my/oracles/470000000000000002/start
→ {"success": true, "status": "ACTIVE"}
3. Conversar. Quien abre tu bot en Telegram y le escribe recibe respuestas según la agenda. Cada persona es una sala: GET /v0/my/rooms. Supervisarlas: Pipeline de API: supervisar las conversaciones de tus oráculos: desactivar o activar el oyente, cerrar un handoff, fijar la agenda de una sala, pedir al oráculo que continúe
4. Detener o eliminar. POST …/stop → {"success": true, "status": "STOPPED"}; DELETE /v0/my/oracles/{nonce} detiene el bot y borra su token guardado.
En segundo plano
- Mientras el bot está en marcha, Cabi.Chat recibe sus mensajes y los responde; detenido, no responde.
- Un bot solo puede responder a quien le escribió primero (regla de Telegram).
- Cada respuesta es una ejecución de IA; su coste aparece en tu gasto de IA: Pipeline de API: ver tu gasto en IA. Precios: link
Reglas
- Para funcionar necesita un proyecto Pro (tuyo o con x sobre él) o tu único hueco gratuito de oráculo. Un segundo gratuito → 400
your free oracle slot is used by … — stop it, or make this oracle's project Pro. - Sin agenda → 400
a platform-hosted oracle needs an agenda; un token mal formado → 400bot_token must look like <id>:<secret>. - Crear requiere
Idempotency-Key; una repetición con la misma clave se rechaza, no se reproduce. - start / stop requieren w sobre el oráculo (si no, 404).
PATCH /v0/my/oracles/{nonce}cambiatitle,agenda,project.
Superficie de la API
| Endpoint | Para qué | FE | IA / oráculo |
|---|---|---|---|
POST /v0/my/oracles |
Crear el oráculo bot | sí | sí |
PATCH /v0/my/oracles/{nonce} |
Agenda, proyecto, título | sí | sí |
POST /v0/my/oracles/{nonce}/start, /stop |
Iniciar / detener | sí | sí |
GET /v0/my/rooms |
Las conversaciones del bot | sí | sí |
DELETE /v0/my/oracles/{nonce} |
Detener y eliminar | sí | rara vez |