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

[自動化](https://ailoot.ai/docs/ja/integrations/#automation) 

# Telegramボット

[Markdown](https://ailoot.ai/docs/ja/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/ja/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/ja/) 。必要な形式に対応しているか確認してください。

## [](https://ailoot.ai/docs/ja/integrations/telegram-bot/#notes)注意事項

Telegramのフレームワークには、独自のAIモデル接続層がありません。Ailootのアドレスは、ボット内のOpenAI SDKで指定します。残高ゼロでは、AilootがRequest ID付きの分かりやすい402エラーを返します。ボットを異常終了させず、ユーザーへ表示してください。

## [](https://ailoot.ai/docs/ja/integrations/telegram-bot/#check)確認

- OpenAI形式のアドレス：`https://api.ailoot.ai/v1` （アプリケーションが完全なアドレスを求める場合は、完全なパス）。
- 短い質問を送信してください。エラーが返った場合は、コードとRequest IDを確認し、次のページと照合してください：[エラーと制限](https://ailoot.ai/docs/ja/errors/)。
- 設定直後の404は、ほとんどの場合、アドレスの間違いです。追加しすぎ、または不足している部分：`/v1`。
- 402は、仮確保に必要な残高の不足です。エージェントはチャットより多くの金額を仮確保します。参照：[理由](https://ailoot.ai/docs/ja/billing/reserve/)。

アプリケーションのドキュメント：[https://github.com/openai/openai-python](https://github.com/openai/openai-python)

ご不明な点はありますか？Request IDと状況の説明をお送りください。調査をお手伝いします。[サポートに問い合わせる](mailto:support@ailoot.ai)

## Ailoot · 企業とそのプロジェクト群





Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。





企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。





Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。