Source: https://ailoot.ai/docs/es/integrations/telegram-bot/
Canonical: https://ailoot.ai/docs/es/integrations/telegram-bot/
Language: es

[Automatización](https://ailoot.ai/docs/es/integrations/#automation) 

# Bot de Telegram

[Markdown](https://ailoot.ai/docs/es/integrations/telegram-bot/index.md)

Bots · OpenAI Chat

| Formato | Dónde configurar |
| --- | --- |
| OpenAI Chat | Los frameworks de Telegram no tienen una capa LLM propia: el controlador de mensajes llama a OpenAI SDK con la base\_url de Ailoot, o a Anthropic SDK con base\_url sin /v1 |

## [](https://ailoot.ai/docs/es/integrations/telegram-bot/#setup)Configuración

Copia la configuración y sustituye `sk-...` por tu clave del panel de control de Ailoot. Es mejor guardar la clave en la variable de entorno `AILOOT_API_KEY` si la aplicación lo permite.

Antes de iniciar, consulte GET /v1/models con su clave de Ailoot. Elija un ID exacto de modelo cuyos métodos incluyan POST /v1/chat/completions y úselo en la configuración. Para agentes, compruebe también las herramientas y funciones que requiere su versión del cliente.

Guarde el código Python como ailoot-telegram-bot.py. Instale las dependencias, defina las dos variables de entorno y ejecute el archivo. Envíe Hello al bot y compruebe la respuesta de texto. Ante un error, conserve el Request ID y compruebe el resultado original antes de otra generación.

```bash
python3 -m pip install "aiogram>=3,<4" openai
```

`ailoot-telegram-bot.py`

```python
import asyncio
import os
from aiogram import Bot, Dispatcher, F
from aiogram.types import Message
from openai import AsyncOpenAI, APIError

async def main():
    dp = Dispatcher()
    async with AsyncOpenAI(
        base_url="https://api.ailoot.ai/v1",
        api_key=os.environ["AILOOT_API_KEY"],
        max_retries=0,
    ) as llm:
        @dp.message(F.text)
        async def reply(message: Message):
            try:
                result = await llm.chat.completions.create(
                    model="claude-sonnet-5-5",
                    messages=[{"role": "user", "content": message.text}],
                )
                content = result.choices[0].message.content or "—"
                for start in range(0, len(content), 4000):
                    await message.answer(content[start:start + 4000])
            except APIError as error:
                await message.answer(
                    f"{type(error).__name__}; Request ID: "
                    f"{getattr(error, 'request_id', None) or '—'}"
                )
        bot = Bot(token=os.environ["TELEGRAM_BOT_TOKEN"])
        await dp.start_polling(bot)

if __name__ == "__main__":
    asyncio.run(main())
```

```bash
export AILOOT_API_KEY="sk-..."
export TELEGRAM_BOT_TOKEN="<TELEGRAM_BOT_TOKEN>"
python3 ailoot-telegram-bot.py
```

Modelo de ejemplo: `claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-flash`. Para cualquier otro modelo, consulta el [catálogo](https://ailoot.ai/models/es/) y comprueba que tenga el formato necesario.

## [](https://ailoot.ai/docs/es/integrations/telegram-bot/#notes)Qué debes saber

Los frameworks de Telegram no tienen una capa propia para modelos de IA: la URL de Ailoot se configura en OpenAI SDK dentro del bot. Con saldo cero, Ailoot devuelve un error 402 claro con Request ID; muéstralo al usuario del bot en lugar de dejar que la aplicación falle.

## [](https://ailoot.ai/docs/es/integrations/telegram-bot/#check)Comprobación

- Para el formato OpenAI, la URL es `https://api.ailoot.ai/v1` (o la ruta completa, si la aplicación pide la URL completa).
- Haz una pregunta corta. Si recibes un error, consulta el código y el Request ID y compáralos con la página [Errores y límites](https://ailoot.ai/docs/es/errors/).
- Un 404 justo después de configurar casi siempre indica una URL incorrecta: sobra o falta `/v1`.
- 402: no hay suficiente saldo para la reserva. Los agentes reservan más que un chat: [por qué](https://ailoot.ai/docs/es/billing/reserve/).

Documentación de la aplicación: [https://github.com/openai/openai-python](https://github.com/openai/openai-python)

¿Tienes alguna pregunta? Envíanos el Request ID y una descripción; te ayudaremos a resolverla.[Contactar con soporte](mailto:support@ailoot.ai)

## Ailoot · La empresa y su cartera de proyectos





Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI.





La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.





Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.