LINE 回聲機器人

1. 取得 LINE 開發者憑證

您需要從 LINE Developers Console 取得必要的憑證。

1. 前往 LINE Developers Console 並登入您的帳號。
2. 建立一個新的「提供者 (Provider)」（如果您尚未建立）。
3. 在該提供者下，建立一個新的「Messaging API」頻道。
4. 進入頻道的「Channel basic settings」頁面，您會找到「Channel ID」和「Channel secret」。請妥善保存「Channel secret」。
5. 切換到頻道的「Messaging API」設定頁面。
6. 在「Channel access token」區塊，點擊「Issue」按鈕以發行一個「Channel access token (long-lived)」。請複製此權杖。

2. 設定環境變數

將您在上一步取得的憑證設定為環境變數，讓您的應用程式可以存取它們。

• LINE_CHANNEL_ACCESS_TOKEN: 貼上您發行的 Channel access token。
• LINE_CHANNEL_SECRET: 貼上您的 Channel secret。

部署時，請在 Firebase App Hosting 的環境變數設定中加入這些值。若在本地開發，您可以建立一個名為 .env.local 的檔案於專案根目錄，並填入以下內容 (將等號後的值替換成您自己的)：

LINE_CHANNEL_ACCESS_TOKEN=your_channel_access_token_here
LINE_CHANNEL_SECRET=your_channel_secret_here

3. 設定 Webhook URL

部署您的應用程式後 (在 Firebase Studio 中，這通常是自動的)，您會得到一個公開的網址。然後，您需要將 Webhook URL 設定到 LINE Developer Console。

1. 回到 LINE Developers Console 中您頻道的「Messaging API」設定頁面。
2. 找到「Webhook settings」區塊。
3. 在「Webhook URL」欄位中，填入您部署的應用程式公開網址，並在後面加上 /api/webhook。
   此專案目前的範例 Webhook URL 為：https://studio--line-echobot-vufda.us-central1.hosted.app/api/webhook

   如果您的應用程式部署在不同的網址，請相應地修改上述範例中的網域部分。

4. 啟用「Use webhook」(將開關切至開啟狀態)。
5. (可選) 您可以點擊「Verify」按鈕來測試 LINE 平台是否能成功連接到您的 Webhook URL。此時您的應用程式需要已經部署並正在運行。

4. 測試您的機器人

完成以上設定後，就可以開始測試您的機器人了！

1. 在 LINE Developers Console 的「Messaging API」設定頁面，您會找到一個「Bot basic ID」或一個 **QR code**。使用 LINE App 掃描 QR code 或搜尋 Bot ID，將您的機器人加為好友。
2. 開啟與機器人的聊天視窗。
3. 傳送一個**單一字元**的訊息給它，例如「A」、「好」、「1」或任何一個單獨的符號。
4. 如果一切設定正確，您的機器人應該會回覆一個「?」。
5. 如果機器人沒有反應，或是有錯誤訊息：
   • 請檢查 Firebase App Hosting 上的應用程式日誌 (logs) 是否有錯誤訊息。
   • 確認 LINE Developer Console 中的 Webhook URL 是否正確，以及「Use webhook」是否已啟用。
   • 確認環境變數是否已正確設定並部署。