SETUP GUIDE

LINE LIFF 發票辨識

跟著步驟走，幾分鐘就能部署完成

步驟 1 / 5

歡迎！

這個引導會帶你完成所有設定，讓你擁有一個透過 LINE 上傳發票、自動辨識並存入 Google Sheets 的系統。

你需要準備

  • 一個 Google 帳號（Gmail 即可）
  • Gemini API Key（下一步教你取得）
  • Google Sheets 試算表 + Apps Script
  • LINE Developers 帳號 (選填)
  • Vercel 或 GitHub 帳號（免費，用來部署）
預估時間：約 10～15 分鐘。不需要寫任何程式碼！

Step 1：取得 Gemini API Key

Gemini 是 Google 的 AI 服務，用來辨識發票照片上的文字。

  1. 前往 Google AI Studio，用 Google 帳號登入
  2. 點擊「Create API Key」按鈕
  3. 選擇任一 Google Cloud 專案（沒有的話會自動建立）
  4. 複製產生的 API Key
Google AI Studio — Create API Key 按鈕位置
以 AIza 開頭的字串
格式不正確，API Key 通常以 AIza 開頭
免費額度：Gemini API 提供免費使用額度，一般使用量不會產生費用。

Step 2：設定 Google Sheets

發票辨識結果會存入你自己的 Google Sheets 試算表。我們需要透過 Apps Script 來接收資料。

2-1. 建立試算表

  1. 前往 sheets.new 建立新的試算表
  2. 你可以幫它取個名字，例如「發票登錄」
新建 Google Sheets 試算表

2-2. 開啟 Apps Script

  1. 在試算表上方選單，點擊 擴充功能 → Apps Script
  2. 會開啟一個新的程式碼編輯器
擴充功能 → Apps Script 選單位置

2-3. 設定共用密鑰

這是用來驗證身份的隨機字串，防止陌生人寫入你的試算表。

產生後，下方程式碼會自動帶入這個密鑰

2-4. 貼上程式碼

  1. 全選編輯器中的預設程式碼（Ctrl+A / Cmd+A），刪除它
  2. 點擊下方「複製程式碼」按鈕
  3. 在編輯器中貼上（Ctrl+V / Cmd+V）
程式碼第 1 行的 SECRET 已自動替換為上方產生的密鑰，直接複製貼上即可。

2-5. 部署 Apps Script

  1. 點擊編輯器上方的 部署 → 新增部署
  2. 左邊齒輪圖示，選擇類型 → 網頁應用程式
  3. 執行身分：我
  4. 存取權限：所有人
  5. 點擊 部署
  6. 首次會要求授權，點擊「授予存取權」
  7. 複製產生的 Web App URL
Apps Script 部署設定對話框
部署完成 — 複製 Web App URL
以 https://script.google.com/ 開頭的網址
網址格式不正確

Step 3：設定 LINE LIFF (選填)

設定 LIFF 後，可以辨識是哪位 LINE 使用者上傳的發票。不設定也能正常使用。

可以跳過！如果你只是想先試用，可以直接跳到下一步。之後隨時可以回來補設定。
  1. 前往 LINE Developers Console，登入 LINE 帳號
  2. 建立一個 Provider（輸入任意名稱）
  3. 在 Provider 下建立一個 LINE Login channel
  4. 進入 channel → LIFF 頁籤 → 點擊 Add
  5. 設定：
    • Size：Full
    • Endpoint URL：先填 https://example.com（部署後再更新）
    • Scope：勾選 profile 和 chat_message.write
  6. 建立完成後，複製 LIFF ID
LINE Developers Console — LIFF 設定頁面
LIFF ID 複製位置
數字-英數字混合的字串
設定後，發票成功寫入 Google Sheets 時會在 LINE 聊天室中自動發送此訊息。需勾選上方 chat_message.write scope。留空則不發送。
支援變數：{user_name} {user_id} {invoice_date} {vendor_name} {invoice_number} {total_amount} {currency} {source}

準備部署！

確認以下設定值，然後一鍵部署到 Vercel。

自訂網站外觀 (選填)

不填則使用預設值。

預設：發票登錄

設定值總覽

GEMINI_API_KEY
GOOGLE_APPS_SCRIPT_URL
GOOGLE_APPS_SCRIPT_SECRET
NEXT_PUBLIC_LIFF_ID
NEXT_PUBLIC_LIFF_SUCCESS_MESSAGE
SITE_TITLE
安全提示：你的 API Key 和密鑰只會存在你的瀏覽器中，不會傳送到任何伺服器。點擊部署後，這些值會直接傳給 Vercel 作為環境變數。
部署到 Vercel

部署後別忘了

  • 如果有設定 LINE LIFF，回到 LINE Developers Console 更新 Endpoint URL 為你的 Vercel 網址
  • 開啟你的 Vercel 網址測試上傳發票
  • 檢查 Google Sheets 是否有收到資料