連接 Telegram Bot

開始之前

連接 Telegram 不需要付費、也不需要任何公司驗證，只要你有一個 Telegram 帳號就能完成。整個流程分成三步:

1. 在 Telegram 裡跟官方的 @BotFather 申請一個機器人，拿到 Bot Token(本頁重點)。
2. 把 Token 貼進 Kinsunn AI 對話中心，建立 Telegram 對話管道。
3. 把機器人連結分享給客戶，客戶按下「開始(Start)」就能開始對話。

💡 什麼是 Bot Token? 它是 Telegram 發給「你這個機器人」的一把鑰匙。Kinsunn AI 用這把鑰匙代替你的機器人收訊息、回訊息。誰拿到這把鑰匙，就能控制你的機器人 —— 所以請把它當成密碼一樣保管。

第一步:跟 @BotFather 取得 Bot Token

BotFather 是 Telegram 官方用來「製造機器人」的機器人，所有機器人都從它這裡申請。你可以用手機 App 或電腦版 / 網頁版(web.telegram.org)操作，步驟相同。

Step 1 — 找到並開啟 BotFather

1. 在 Telegram 上方的搜尋列輸入 @BotFather。
2. 點選名稱旁有藍色勾勾(已驗證)的那一個 —— 認明帳號是 @BotFather，避免點到仿冒帳號。
3. 進入對話後，按下方的 開始 / Start。

Step 2 — 建立新機器人

1. 送出指令 /newbot。
2. BotFather 會問機器人的顯示名稱(name) —— 這是客戶會看到的名字，可用中文，例如 Kinsunn 客服。
3. 再問機器人的帳號名稱(username)，有兩個規則:
   • 只能用英文、數字、底線;
   • 必須以 bot 結尾，例如 kinsunn_support_bot。
   若名稱已被別人用走，BotFather 會請你換一個。

Step 3 — 複製 Token

成功後，BotFather 會回覆一段「Done! ... Use this token to access the HTTP API」的訊息，裡面那一行就是你的 Bot Token。它長這樣(數字 + 冒號 + 一串英數):

🔑 在 BotFather 的對話裡，點一下那行 Token 通常就會自動複製。之後若忘記，隨時送 /token 給 BotFather 就能再拿一次。

第二步:把 Token 填進對話中心

1. 在對話中心點 設定 → 對話管道 → 新增對話管道 → Telegram。
2. 在 Bot Token 欄位貼上剛剛複製的整段 Token，按建立。
3. 系統會自動用這把 Token 連上你的機器人、設定好接收訊息所需的設定，管道就建立完成了。

💡 一支機器人同一時間只能接到一個地方。如果你之前把這支機器人接過其他系統(或自己寫過程式接 Webhook)，接進來後舊的那邊就會收不到訊息 —— 這是正常的，Telegram 規則如此。

第三步:讓客戶開始跟你對話

機器人不會主動敲客戶，一定要客戶先開啟對話、按下「開始(Start)」，訊息才會進到對話中心。把下面任一種方式給你的客戶:

• 機器人連結:https://t.me/你的機器人username(例:https://t.me/kinsunn_support_bot)，放在官網、Email 簽名檔、社群連結都可以。
• 直接搜尋:請客戶在 Telegram 搜尋你的機器人 username。
• QR Code:把上面的連結做成 QR Code，放在實體店面、名片、DM。

客戶按下「開始」後傳的第一則訊息，就會出現在對話中心左側的「全部」對話列表裡。

自訂你的機器人(選用)

想讓機器人更專業?在 BotFather 對話裡送這些指令就能改(都不影響已建立的對話管道):

疑難排解

• 建立管道時說 Token 無效 —— 多半是複製時漏了字或多帶空白。請回 BotFather 送 /token 重拿，確認含冒號整段一起貼，前後不要有空白。
• /newbot 一直說名稱已被使用 —— 是帳號名稱(username)重複了(全 Telegram 唯一)，換一個、並確認以 bot 結尾即可;顯示名稱(name)則可以重複。
• 客戶說傳了沒反應 / 對話中心沒看到 —— 確認客戶有先按「開始(Start)」;同一支機器人是否還接在別的系統上(會搶走訊息);新對話可能還沒指派給你，先看左側「全部」而不是「我的」。
• 想換一支全新機器人 —— 重跑一次 /newbot 拿新 Token，再到對話中心新增一個 Telegram 管道即可。
• 還是接不起來?寄信給 [email protected]，我們協助你處理。