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

[Automatisation](https://ailoot.ai/docs/fr-be/integrations/#automation) 

# Bot Telegram

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

Bots · OpenAI Chat

| Format | Où configurer |
| --- | --- |
| OpenAI Chat | Les frameworks Telegram ne possèdent pas de couche LLM propre : le gestionnaire de messages appelle le SDK OpenAI avec base\_url Ailoot, ou le SDK Anthropic avec base\_url sans /v1 |

## [](https://ailoot.ai/docs/fr-be/integrations/telegram-bot/#setup)Configuration

Copiez la configuration et remplacez `sk-...` par votre clé de l’espace client Ailoot. Il est préférable de stocker la clé dans la variable d’environnement `AILOOT_API_KEY`, si l’application le permet.

Avant de démarrer, appelez GET /v1/models avec votre clé Ailoot. Choisissez un identifiant exact de modèle dont les méthodes incluent POST /v1/chat/completions, puis utilisez-le dans la configuration. Pour les agents, vérifiez aussi les outils et les fonctions nécessaires à votre version du client.

Enregistrez le code Python dans ailoot-telegram-bot.py. Installez les dépendances, définissez les deux variables d’environnement, puis lancez le fichier. Envoyez Hello au bot et vérifiez la réponse textuelle. En cas d’erreur, conservez le Request ID et vérifiez le résultat initial avant une nouvelle génération.

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

Exemple de modèle : `claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-flash`. Choisissez tout autre modèle dans le [catalogue](https://ailoot.ai/models/fr-be/) — vérifiez qu’il prend en charge le format requis.

## [](https://ailoot.ai/docs/fr-be/integrations/telegram-bot/#notes)À savoir

Les frameworks Telegram ne possèdent pas de couche IA propre : l’adresse Ailoot se configure dans le SDK OpenAI à l’intérieur du bot. Avec un solde nul, Ailoot renvoie une erreur 402 explicite et un Request ID : affichez-la à l’utilisateur du bot au lieu de laisser l’application échouer.

## [](https://ailoot.ai/docs/fr-be/integrations/telegram-bot/#check)Vérification

- Pour le format OpenAI, l’adresse est `https://api.ailoot.ai/v1` (ou le chemin complet si l’application demande une adresse complète).
- Posez une question courte. En cas d’erreur, consultez le code et le Request ID, puis reportez-vous à la page [Erreurs et limites](https://ailoot.ai/docs/fr-be/errors/).
- Une erreur 404 immédiatement après la configuration indique presque toujours une adresse incorrecte : la présence superflue ou l’absence de `/v1`.
- Une erreur 402 signifie que le solde ne couvre pas la réservation. Les agents réservent plus qu’un chat : [pourquoi](https://ailoot.ai/docs/fr-be/billing/reserve/).

Documentation de l’application : [https://github.com/openai/openai-python](https://github.com/openai/openai-python)

Des questions ? Envoyez-nous le Request ID et une description : nous vous aiderons à y voir plus clair.[Contacter l’assistance](mailto:support@ailoot.ai)

## Ailoot · L’entreprise et son portefeuille de projets





Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI.





L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.





Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.