第 7 章 Telegram

7.1 先看這裡

項目 內容
這是什麼 建一個 Telegram 機器人,顧客跟它對話等於跟你的客服對話
預估時間 15 分鐘
要不要外部帳號 要一個 Telegram 帳號(免費)
誰接得起來 有一個能登入的 Telegram 帳號就做得完,全程在 Telegram App 裡,不需要 IT
費用 完全免費,沒有訊息量上限
狀態 ✅ 可正式使用

這是所有管道裡最快、最沒有雷的一個,很適合拿來當「第一次體驗接管道」的練習。

7.2 你需要準備的東西

  • 一個可登入的 Telegram 帳號。
  • 機器人顯示名稱:顧客看到的名字,可中文,例:蘋果客服
  • 機器人 username:全英文、必須以 _botbot 結尾,而且全 Telegram 唯一,例:apple_service_bot。建議先想 2–3 個備案,常見的名字容易被搶走。

7.3 步驟一:用 BotFather 建立機器人

  1. 打開 Telegram,搜尋 @BotFather(有藍色勾勾的官方帳號)並開始對話。
  2. 輸入指令:/newbot
  3. BotFather 會依序問你兩件事:
    • 顯示名稱:輸入你想要的名字(可中文)。
    • username:輸入英文 username(要以 bot 結尾)。被佔用的話它會請你換一個。
  4. 成功後,BotFather 會回一段訊息,裡面有一串 Bot Token,長得像: 123456789:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx(9 位數字 + 冒號 + 35 位英數)
  5. 立刻複製這串 Token

⚠️ 這串 Token 只會在這則訊息裡出現。訊息刪掉或找不到時,可以用 /mybots → 選機器人 → API Token 再看一次,或用 /revoke 重新產生(舊的會失效)。

7.4 步驟二:在對話中心建立管道

  1. 依 0.2 進到「新增對話管道」頁 → 點「Telegram」卡片。

  2. 填入:

    欄位 填什麼
    顯示名稱 你自己辨識用,例:Telegram - 蘋果客服
    Bot Token 剛剛複製的那一串
  3. 按建立。系統會自動完成訊息接收設定,你不需要回貼任何網址。

7.5 步驟三:驗收

  1. 在 Telegram 搜尋你的機器人 username,或直接開 https://t.me/你的機器人username
  2. 按「開始 / START」。
  3. 傳一句「你好」。
  4. 對話中心收件匣應該幾秒內出現這通對話。

7.6 進階:把機器人打扮一下(選配,都在 BotFather)

指令 作用
/setuserpic 設定機器人頭像
/setdescription 設定「說明」(使用者第一次打開機器人時看到的大段文字)
/setabouttext 設定「簡介」(個人檔案頁的短介紹)
/setcommands 設定指令選單(輸入框旁邊的選單)

7.7 限制

  • 每則訊息 4,096 字元,超過會自動切成多則。
  • 圖片、檔案會以附件進入對話;AI 目前以純文字為主。
  • 貼圖會被視為空訊息略過。
  • 對話中看得到對方的 Telegram username 與姓名。
  • 一組 Bot Token 同時只能被一個系統接收,不能一邊接我們、一邊接別的工具。

7.8 常見卡關

症狀 原因 解法
建立管道時 502 Bot Token 已被其他系統佔用 到 BotFather 用 /revoke 重新產生,或先移除其他整合
建好了但收不到訊息 接收設定沒建立成功 到該管道設定頁點「重新建立接收設定」按鈕
username 一直說被佔用 Telegram 全球唯一 換一個,例如加上公司英文名或年份
顧客傳貼圖沒反應 貼圖視為空訊息 正常設計