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

[Автоматтандыру](https://ailoot.ai/docs/kk/integrations/#automation) 

# Telegram боты

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

Боттар · OpenAI Chat

| Формат | Қайда баптау керек |
| --- | --- |
| OpenAI Chat | Telegram фреймворктерінде өз LLM қабаты жоқ: хабарлама өңдеушісінде Ailoot base\_url мекенжайы бар OpenAI SDK шақырылады (немесе /v1 бөлігісіз base\_url бар Anthropic SDK) |

## [](https://ailoot.ai/docs/kk/integrations/telegram-bot/#setup)Баптау

Конфигурацияны көшіріп, мынаны ауыстырыңыз: `sk-...` Ailoot жеке кабинетіңіздегі кілтке. Кілтті мына орта айнымалысында сақтаған дұрыс: `AILOOT_API_KEY`, қолданба мұны қолдаса.

Іске қоспас бұрын Ailoot кілтіңізбен GET /v1/models сұрауын жіберіңіз. Әдістері POST /v1/chat/completions қамтитын нақты модель ID мәнін таңдап, баптауда қолданыңыз. Агенттер үшін клиент нұсқасына қажетті құралдар мен мүмкіндіктердің қолдауын да тексеріңіз.

Python кодын ailoot-telegram-bot.py атауымен сақтаңыз. Тәуелділіктерді орнатып, екі орта айнымалысын беріңіз де, файлды іске қосыңыз. Ботқа Hello жіберіп, мәтіндік жауапты тексеріңіз. Қате кезінде Request ID мәнін сақтап, жаңа генерация жібермес бұрын бастапқы нәтижені тексеріңіз.

```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
```

Модель мысалы: `claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-flash`. Кез келген басқа модельді мына жерден алыңыз: [каталогтан](https://ailoot.ai/models/kk/) — оның қажетті форматты қолдайтынын тексеріңіз.

## [](https://ailoot.ai/docs/kk/integrations/telegram-bot/#notes)Білу маңызды

Telegram фреймворктерінде нейрожелілерге арналған өз қабаты жоқ: Ailoot мекенжайы бот ішіндегі OpenAI SDK-да беріледі. Нөлдік баланста Ailoot Request ID бар түсінікті 402 қатесін қайтарады — боттың құлауына жол бермей, оны пайдаланушыға көрсетіңіз.

## [](https://ailoot.ai/docs/kk/integrations/telegram-bot/#check)Тексеру

- OpenAI форматы үшін мекенжай — `https://api.ailoot.ai/v1` (немесе қолданба толық мекенжай сұраса, толық жол).
- Қысқа сұрақ қойыңыз. Қате келсе, код пен Request ID-ді қарап, мына бетпен салыстырыңыз: [Қателер және лимиттер](https://ailoot.ai/docs/kk/errors/).
- Баптаудан кейін бірден шыққан 404 әрдайым дерлік мекенжайдың қате екенін білдіреді: артық немесе жетіспейтін `/v1`.
- 402 — резервке баланс жетпейді. Агенттер чатқа қарағанда көбірек резервтейді: [неге](https://ailoot.ai/docs/kk/billing/reserve/).

Қолданба құжаттамасы: [https://github.com/openai/openai-python](https://github.com/openai/openai-python)

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.[Қолдау қызметіне жазу](mailto:support@ailoot.ai)

## Ailoot · Компания және оның жобалар портфелі





Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді.





Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.





Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.
