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

[الأتمتة](https://ailoot.ai/docs/ar/integrations/#automation) 

# بوت Telegram

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

بوتات · OpenAI Chat

| الصيغة | مكان الإعداد |
| --- | --- |
| OpenAI Chat | لا تتضمن أطر Telegram طبقة LLM خاصة؛ يستدعي معالج الرسائل OpenAI SDK مع base\_url لـAiloot (أوAnthropic SDK بعنوان base\_url دون /v1) |

## [](https://ailoot.ai/docs/ar/integrations/telegram-bot/#setup)الإعداد

انسخ الإعداد واستبدل `sk-...` بمفتاحك من لوحة حساب Ailoot. يُفضّل حفظ المفتاح في متغير البيئة `AILOOT_API_KEY`إذا كان التطبيق يدعم ذلك.

قبل البدء، استدعِ GET /v1/models بمفتاح Ailoot الخاص بك. اختر معرّف نموذج دقيقًا تتضمن طرقه POST /v1/chat/completions واستخدمه في الإعدادات. للوكلاء، تحقّق أيضًا من دعم الأدوات والميزات المطلوبة لإصدار العميل لديك.

احفظ كود 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/ar/) — وتحقق من دعمه للصيغة المطلوبة.

## [](https://ailoot.ai/docs/ar/integrations/telegram-bot/#notes)معلومات مهمة

لا تتضمن أطر Telegram طبقة خاصة للنماذج العصبية؛ يُحدد عنوان Ailoot في OpenAI SDK داخل البوت. عند رصيد صفري، يعيد Ailoot خطأ 402 مفهوماً مع Request ID؛ اعرضه لمستخدم البوت بدلاً من تعطل التطبيق.

## [](https://ailoot.ai/docs/ar/integrations/telegram-bot/#check)التحقق

- لصيغة OpenAI، العنوان هو `https://api.ailoot.ai/v1` (أو المسار الكامل إذا طلب التطبيق عنواناً كاملاً).
- اطرح سؤالاً قصيراً. إذا ظهر خطأ، فراجع الرمز وRequest ID وطابقهما مع صفحة [الأخطاء والحدود](https://ailoot.ai/docs/ar/errors/).
- يشير 404 مباشرةً بعد الإعداد غالباً إلى عنوان غير صحيح: وجود لاحقة زائدة أو مفقودة من `/v1`.
- 402 يعني أن الرصيد غير كافٍ للحجز. يحجز الوكلاء أكثر من الدردشة: [لماذا](https://ailoot.ai/docs/ar/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 إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.