OakXgen 使用手冊

外觀

Telegram 串接：把 AI 接上 Telegram bot

建立 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 上服務，建議把轉真人總開關關掉，見轉真人怎麼觸發。

串接狀態 ​

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