---
url: https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/telegram-integration.md
description: >-
  貼上 BotFather 給的 bot token 就能讓 AI 在 Telegram 私訊裡回覆客人。這篇說明怎麼建 bot、支援哪些訊息，以及
  Telegram 沒有真人客服時轉真人會發生什麼事。
---

## 建立 bot 並串接

1. 在 Telegram 搜尋 **@BotFather**，輸入 `/newbot`，照指示取名字與帳號（結尾要是 `bot`）。
2. BotFather 會給一串 token，長得像 `123456789:AAH...`。
3. 到 AI 代理的**串接**分頁，按**新增串接** → **Telegram**，貼上 token 按**連線**。

連線時我們會自動把 bot 的 webhook 設到 OakXgen，**不需要另外設定網址**。成功後列表上會
出現這個 bot，名稱可以點開直接跟它對話。

**一個 bot 只能接一個 AI。** Telegram 的 bot 只有一條 webhook，同一個 token 接到別的 AI
上，原本那個 AI 就收不到訊息了，列表上會自動把舊的那筆停用。

token 貼錯會看到「Bot token 無效」開頭的錯誤。

## 支援範圍

* **只回私訊。** 把 bot 加進群組，群組裡的訊息會被忽略。
* 客人第一次按**開始**（Telegram 送的是 `/start`）時，AI 會當成客人打招呼並回覆；
  之後任何時候輸入 `/start` 都會**重新開始對話**。
* 圖片、貼圖、語音、影片、檔案目前**只會被當成「傳了一張圖片」之類的文字**，AI 看不到內容。
* AI 回覆的卡片會轉成文字；快速回覆會變成訊息下方的按鈕。

## 轉真人：已讀不回

Telegram 沒有真人客服後台，**轉真人觸發時不會通知任何人，也不會傳任何話給客人**。
AI 對這位客人暫停 30 分鐘，這段期間客人的訊息不會有回應（已讀不回），30 分鐘後自動恢復；
客人輸入 `/start` 也會立刻恢復。

所以**Channel agent 開著轉真人又接 Telegram 時，列表上會出現提醒**。如果這個 AI 只在
Telegram 上服務，建議把**轉真人**總開關關掉，見[轉真人怎麼觸發](./handoff.md)。

## 串接狀態

列表上的**最後收到**與**最後送出**是最近一次收到客人訊息、送出 AI 回覆的時間。
Telegram 那端的 webhook 出錯（例如 token 被撤銷、bot 被刪除）時，會以紅字顯示
Telegram 回報的錯誤。token 在 BotFather 重新產生過的話，要把舊的串接解除再用新 token 連一次。