> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pathors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Bot 整合快速入門指南

> 學習如何在 Pathors 中快速整合 Telegram Bot，包括 BotFather 建立機器人、取得 Token、設定 Webhook 等

## 概述

本教學將指導您如何在 Pathors 中整合 Telegram Bot，包含使用 BotFather 建立機器人、取得 Bot Token、在 Pathors 中設定整合以及設定 Webhook。

## 步驟 1：使用 BotFather 建立 Telegram Bot

1. 在 Telegram 中搜尋並開啟 [@BotFather](https://t.me/botfather)
2. 傳送 `/newbot` 指令開始建立新的機器人
3. 依照 BotFather 的指引：
   * 輸入您的機器人名稱（可以是任何名稱）
   * 輸入機器人的使用者名稱（必須以 `bot` 結尾，例如：`myawesomebot` 或 `MyAwesome_bot`）

<Frame>
  <img
    src="https://mintcdn.com/pathorstechnology/KdB-f_Xl4XvHDQAi/images/telegram/step1-create-bot-with-botfather.png?fit=max&auto=format&n=KdB-f_Xl4XvHDQAi&q=85&s=de8fbb13b5ef5276917713ea639da71b"
    alt="使用 BotFather
建立機器人"
    width="1720"
    height="1636"
    data-path="images/telegram/step1-create-bot-with-botfather.png"
  />
</Frame>

4. 建立成功後，BotFather 會提供您的 **Bot Token**，請妥善保存這個 Token

<Frame>
  <img src="https://mintcdn.com/pathorstechnology/KdB-f_Xl4XvHDQAi/images/telegram/step2-get-bot-token.png?fit=max&auto=format&n=KdB-f_Xl4XvHDQAi&q=85&s=3760df9edb6a4ea1fbae782ca399b8e1" alt="取得 Bot Token" width="1724" height="1632" data-path="images/telegram/step2-get-bot-token.png" />
</Frame>

## 步驟 2：在 Pathors 中啟用 Telegram 整合

1. 登入您的 Pathors 專案
2. 前往「整合」頁面
3. 找到 Telegram 整合選項並點擊進入

<Frame>
  <img
    src="https://mintcdn.com/pathorstechnology/KdB-f_Xl4XvHDQAi/images/telegram/step3-go-to-telegram-integration.png?fit=max&auto=format&n=KdB-f_Xl4XvHDQAi&q=85&s=7640f6a8c2e1458f24b1f078e0662326"
    alt="前往 Telegram
整合頁面"
    width="3018"
    height="1888"
    data-path="images/telegram/step3-go-to-telegram-integration.png"
  />
</Frame>

4. 點擊右上角的開關按鈕啟用 Telegram 整合

<Frame>
  <img src="https://mintcdn.com/pathorstechnology/KdB-f_Xl4XvHDQAi/images/telegram/step4-enable-telegram-integration.png?fit=max&auto=format&n=KdB-f_Xl4XvHDQAi&q=85&s=96fdb68edf5e03e94b487ab0500fb088" alt="啟用 Telegram 整合" width="3020" height="1888" data-path="images/telegram/step4-enable-telegram-integration.png" />
</Frame>

## 步驟 3：設定 Bot Token

1. 在「Bot Token」欄位中輸入您從 BotFather 取得的 Token
2. 點擊「測試機器人」按鈕驗證 Token 是否有效

<Frame>
  <img src="https://mintcdn.com/pathorstechnology/KdB-f_Xl4XvHDQAi/images/telegram/step5-input-and-test-bot-token.png?fit=max&auto=format&n=KdB-f_Xl4XvHDQAi&q=85&s=0977e77c5a476a12d910f607751b37c1" alt="輸入和測試 Bot Token" width="3024" height="1889" data-path="images/telegram/step5-input-and-test-bot-token.png" />
</Frame>

3. 如果測試成功，會顯示機器人的資訊
4. 點擊「儲存」按鈕儲存設定

<Frame>
  <img src="https://mintcdn.com/pathorstechnology/KdB-f_Xl4XvHDQAi/images/telegram/step6-save-bot-configuration.png?fit=max&auto=format&n=KdB-f_Xl4XvHDQAi&q=85&s=3d6339f7ffc851133de7cd3225f716c5" alt="儲存機器人設定" width="3024" height="1889" data-path="images/telegram/step6-save-bot-configuration.png" />
</Frame>

## 步驟 4：設定 Webhook

1. 在頁面下方的「Webhook 設定」區塊，您會看到自動產生的 Webhook URL
2. 點擊「設定 Webhook」按鈕，系統會自動將 Webhook 註冊到 Telegram

<Frame>
  <img src="https://mintcdn.com/pathorstechnology/KdB-f_Xl4XvHDQAi/images/telegram/step7-set-webhook.png?fit=max&auto=format&n=KdB-f_Xl4XvHDQAi&q=85&s=d769fcf2ab923dc2844b00b981041df9" alt="設定 Webhook" width="3024" height="1886" data-path="images/telegram/step7-set-webhook.png" />
</Frame>

3. 您也可以點擊「檢查狀態」來確認 Webhook 是否設定成功

<Frame>
  <img src="https://mintcdn.com/pathorstechnology/KdB-f_Xl4XvHDQAi/images/telegram/step8-check-webhook-status.png?fit=max&auto=format&n=KdB-f_Xl4XvHDQAi&q=85&s=63a1f7a12169bb4fc0c5fcb4fe7ba72c" alt="檢查 Webhook 狀態" width="3024" height="1891" data-path="images/telegram/step8-check-webhook-status.png" />
</Frame>

## 步驟 5：測試您的機器人

1. 在 Telegram 中搜尋您的機器人使用者名稱
2. 點擊「Start」或傳送 `/start` 指令
3. 開始與您的 Pathors AI 助手對話！

## 重要提示

* **Bot Token 格式**：Token 應該類似於 `123456789:ABCdefGhIJKlmNoPQRsTUVwxyz`
* **安全性**：請妥善保管您的 Bot Token，不要分享給他人
* **啟用順序**：必須先啟用整合開關，才能輸入和儲存 Bot Token
* **Webhook 要求**：只有在輸入有效的 Bot Token 後，才能設定 Webhook

## 常見問題

### Q: 為什麼我無法儲存 Bot Token？

A: 請確保您已經啟用了 Telegram 整合開關（右上角的開關按鈕）。

### Q: Bot Token 驗證失敗怎麼辦？

A: 請檢查：

* Token 格式是否正確
* 是否完整複製了 BotFather 提供的 Token
* 機器人是否已正確建立

### Q: Webhook 設定失敗怎麼辦？

A: 請確保：

* Bot Token 已正確設定並測試通過
* 網路連線正常
* 聯絡技術支援取得進一步協助

### Q: 如何刪除或重設 Webhook？

A: 在 Webhook 設定區塊中，點擊「刪除 Webhook」按鈕即可移除現有的 Webhook 設定。

## 相關資源

* [Telegram Bot API 官方文件](https://core.telegram.org/bots/api)
* [BotFather 官方指南](https://core.telegram.org/bots/tutorial)
* [Pathors 整合說明文件](../integrations)