> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/conversations/connect-telegram.md).

# 対話プラットフォーム連携：Telegram

## <mark style="color:blue;">連携前の確認</mark> <a href="#pre-integration-checklist" id="pre-integration-checklist"></a>

* [MaiAgent プラットフォーム](https://admin.maiagent.ai/)上で「AI アシスタント」を作成済みであること
* Telegram アカウントを登録済みであること

## <mark style="color:blue;">連携を開始する</mark> <a href="#start-integration" id="start-integration"></a>

### 1. 左側メニューの「対話プラットフォーム」を開き、右上の <mark style="color:blue;">「＋対話プラットフォームを連携」</mark> ボタンをクリックします <a href="#step-go-to-channel-menu" id="step-go-to-channel-menu"></a>

<figure><img src="/files/MuVNBFf2YuFYo0lyaGCx" alt=""><figcaption></figcaption></figure>

### 2. 対話プラットフォームで Telegram を選択します <a href="#step-select-telegram" id="step-select-telegram"></a>

<figure><img src="/files/dtQUG7BZD38gjU7qcLV9" alt=""><figcaption></figcaption></figure>

### 3. 対話プラットフォーム名を入力し、AI アシスタントを選択します <a href="#step-fill-channel-name-and-ai-agent" id="step-fill-channel-name-and-ai-agent"></a>

<figure><img src="/files/y3E2EgQMLFxo6hdYA5Rm" alt=""><figcaption></figcaption></figure>

### 4. BotFather <https://t.me/BotFather> から Bot Token を取得します <a href="#step-get-bot-token-from-botfather" id="step-get-bot-token-from-botfather"></a>

#### a. 「BotFather」リンクをクリックします：[https://t.me/BotFather](#a.-dian-xuan-botfather-lian-jie) <a href="#sub-step-open-botfather-link" id="sub-step-open-botfather-link"></a>

<figure><img src="/files/geQZAu0rFCRgiCoiZH04" alt=""><figcaption></figcaption></figure>

#### b. Telegram BotFather のチャンネルに入ります <a href="#sub-step-enter-botfather-channel" id="sub-step-enter-botfather-channel"></a>

<figure><img src="/files/0DWjbQ9Hw2ng2rMiw3oZ" alt=""><figcaption></figcaption></figure>

#### c. 「OPEN IN WEB」をクリックします（ウェブ版の場合） <a href="#sub-step-open-in-web" id="sub-step-open-in-web"></a>

#### クリックすると、BotFather から start を押して対話を開始するよう求められます： <a href="#sub-step-start-botfather-conversation" id="sub-step-start-botfather-conversation"></a>

<figure><img src="/files/e18wTnDG4dcSpsPcpcxa" alt=""><figcaption></figcaption></figure>

#### d. 「<mark style="color:blue;">/newbot</mark>」をクリックし、指示に従って Bot 名とユーザー名を入力すると、Bot Token を取得できます <a href="#sub-step-create-new-bot" id="sub-step-create-new-bot"></a>

<figure><img src="/files/VdSFUU2EjWUrfDCHywRk" alt=""><figcaption></figcaption></figure>

### 5. MaiAgent の対話プラットフォーム連携の編集画面に戻り、取得したばかりの Bot Token を貼り付けます <a href="#step-paste-bot-token-in-maiagent" id="step-paste-bot-token-in-maiagent"></a>

Bot Token を貼り付けたら、右下の「<mark style="color:blue;">保存</mark>」ボタンをクリックすると、連携設定が完了します。

<figure><img src="/files/bvYk38419GLnGF2U6mkm" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/FNi0OLQNcmhavaK4ct78" alt=""><figcaption></figcaption></figure>

### 6. **連携が成功したか確認します** <a href="#step-verify-integration" id="step-verify-integration"></a>

設定したばかりの Telegram Bot で対話を行うことができます。

<figure><img src="/files/7v3nCgDspDRtoZlHhGX7" alt=""><figcaption></figcaption></figure>

該当する対話が MaiAgent の「すべての対話」で確認できれば、連携が成功したことを示します！

<figure><img src="/files/mBvnLv2vhQKDAV8xMkf4" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/conversations/connect-telegram.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.