Bots de Koto en
cualquier lenguaje
La Bot API es HTTP + JSON sencillo. La pasarela de Koto gestiona la identidad E2E del bot y el descifrado, mientras tú escribes la lógica en lo que quieras: Python, JavaScript, Go, Rust o Luna. También sirven las bibliotecas cliente para bots ya listas.
# Send a message — it's a single HTTP request
curl -X POST https://api.koto.run/sendMessage \
-H "Authorization: Bearer kbot_…" \
-H 'content-type: application/json' \
-d '{"chat_id":"KOTO-…","text":"Hello from Koto!"}'
# → { "ok": true, "result": { "message_id": "…" } }Un bot en tres pasos
Del token a un bot funcional, sin SDK ni complicaciones con la criptografía.
Consigue un token
Abre @BotKoto en la app, envía /newbot y obtén un token kbot_….
Llama a la API
Envía solicitudes HTTP a {GATEWAY}/{method}. El token va en una cabecera Authorization: Bearer. Cualquier lenguaje, sin SDK.
Recibe actualizaciones
Sondea getUpdates (long-poll) o configura un webhook: el bot reacciona a los mensajes.
Qué puede hacer la Bot API
Mensajes y multimedia
Texto, fotos, documentos y encuestas. El ciclo de vida completo de la conversación.
Botones inline
Teclados bajo el mensaje y gestión de pulsaciones mediante callback_query.
Mini aplicaciones
Una página web dentro del chat con un botón lateral de lanzamiento y el puente KotoWebApp.
Webhooks y long-poll
Recibe actualizaciones por webhook en tiempo real o sondea getUpdates.
Menú de comandos
Una lista pública de comandos «/» mediante setMyCommands.
Ediciones y reacciones
Edición, eliminación, fijado, reacciones y reenvío de mensajes.
Sin SDK, solo HTTP
Un bot es código que hace solicitudes HTTP. Sirve cualquier cosa: Python, JavaScript, Go, Rust, bash o Luna. La pasarela se encarga del cifrado de extremo a extremo y de la identidad del bot: nunca tocas la criptografía.
import requests
API = "https://api.koto.run"
HEADERS = {"Authorization": "Bearer kbot_…"}
# long-poll and echo back
r = requests.get(f"{API}/getUpdates", headers=HEADERS, params={"timeout": 20}).json()
for u in r["result"]:
m = u.get("message")
if m and m.get("text"):
requests.post(f"{API}/sendMessage", headers=HEADERS, json={
"chat_id": m["chat"]["id"],
"text": "Echo: " + m["text"],
})Métodos de la API de Koto
Las llamadas van a {GATEWAY}/{method}, el token va en una cabecera Authorization y la respuesta es un sobre JSON { ok, result }. Abajo hay algunos métodos principales; la referencia completa está en la documentación.
Crea tu primer bot en minutos
Abre @BotKoto, consigue un token y envía tu primer mensaje a través de la API.