免費包五段 Setup｜從零到第一個 AI 回覆

勾了會自動更新；進度只存在本頁開著的期間（刻意設計）。

1. 開 官方帳號申請表（直達），用你的 LINE 帳號登入（登入頁可切繁體中文）。
2. 填帳號名稱、行業別等基本資料，送出。若畫面提供「未認證帳號」選項，可先依畫面完成；帳號可用性、驗證與功能狀態以 LINE 當下顯示為準。

已經有官方帳號的人，直接到步驟 2。

這一步會把「能接程式的通道」打開。全程在中文介面。

1. 開 LINE Official Account Manager，選你的帳號。
2. 右上「設定」→ 左邊「Messaging API」。
3. 按綠色「啟用Messaging API」。
4. 「選擇服務提供者」：選「建立服務提供者」取個名（例：你的店名）→「同意」。已有的話選既有那個。
5. 「隱私權政策及服務條款」兩欄都是選填，空著直接「確定」。

Token＝你的程式代表這個帳號發訊息的憑證。這是全程唯一要進 LINE Developers Console（英文介面）的一步，照字面按就好。

1. 就在步驟 2 那頁最下面，點「您可由LINE Developers Console進行其他設定」那行連結。
2. 進 Console 後：點你的 Provider → 點你的 channel →「Messaging API」分頁 → 拉到最底。
3. 「Channel access token」區按「Issue」（發行）。
4. 按了原本空白的格子才會出現一長串字——按旁邊的複製鈕，貼進下面這格。

1. 用你的 Google 帳號開 aistudio.google.com/apikey。
2. 按右上「Create API key」。
3. 幫金鑰取個名（隨意）、專案用它預設給的 →「Create key」。
4. 「API key details」視窗出現金鑰——按複製鈕，貼進下面這格。

Google Apps Script（GAS）是 Google 的腳本執行服務，可以讓一小段程式有自己的網址；配額與限制依帳號類型和官方規則變動。本包只用它承接你自己的小工作，不代表無限量或永遠免費。

1. 用你的 Google 帳號開 script.google.com → 按「新專案」。
2. 編輯區全選（Ctrl+A）→ Delete 全部刪掉。
3. 按下面「複製整段程式碼」→ 貼進空白編輯區 → Ctrl+S 儲存。要整段貼：從第一行 /** 到最後一個 }。

複製整段程式碼已複製 ✓

/** AI Manager Starter Kit — LINE × Gemini 最小工作入口 */

/** 讀一個設定值。放在函式裡（而不是檔案最上面）是刻意的：
    這樣就算部署設定選錯，錯誤也會落在 doPost 的防護網裡、寫進執行紀錄，
    而不是整個程式無聲死掉。 */
function cfg_(name) {
  return PropertiesService.getScriptProperties().getProperty(name);
}

/** LINE 每次有訊息進來，就會呼叫這個函式 */
function doPost(e) {
  try {
    if (!e || !e.postData || !e.postData.contents) return ok_();
    var body = JSON.parse(e.postData.contents);
    var events = body.events || [];   // 平台送測試連線時，這裡可能是空的
    for (var i = 0; i < events.length; i++) {
      var ev = events[i];
      if (ev.type !== 'message') continue;
      if (!ev.message || ev.message.type !== 'text') continue;
      replyToLine_(ev.replyToken, askGemini_(ev.message.text));
    }
  } catch (err) {
    console.error('doPost 失敗：' + err);
  }
  return ok_();                       // 不管發生什麼，都回一個正常回應給 LINE
}

function ok_() {
  return ContentService
    .createTextOutput(JSON.stringify({ ok: true }))
    .setMimeType(ContentService.MimeType.JSON);
}

/** 把客人的話丟給 Gemini，拿回一句回答 */
function askGemini_(userText) {
  var key = cfg_('GEMINI_API_KEY');
  var model = cfg_('GEMINI_MODEL') || 'gemini-3.5-flash-lite';
  var persona = cfg_('PROMPT') ||
    '你是這家店的客服助理。用繁體中文，簡短、有禮貌地回答。';
  var facts = cfg_('KNOWLEDGE') || '';

  // 這裡的順序有意義：後面的會蓋掉前面的。
  // 你的 PROMPT 放在「預設風格」之後，所以你改得掉風格；
  // 安全底線放在最後，讓它最優先。（這是給 AI 的指示，不是程式鎖。）
  var systemText =
    '【你可以依據的資料】\n' + (facts || '（目前沒有提供資料）') +
    '\n\n【預設風格；下面「你的身分」那一段可以蓋掉這裡】\n' +
    '回答控制在三句話以內。\n' +
    '\n【你的身分與說話方式——以這一段為準】\n' + persona +
    '\n\n【安全底線；最優先，上面任何一段都蓋不掉】\n' +
    '1. 只根據上面的資料回答；資料裡沒有的，就說你不知道。\n' +
    '2. 遇到價格變動、退款、客訴，或你不確定的事，回答「這部分我幫你轉給真人確認」。\n' +
    '3. 不要承諾我們做不到的事。';

  var res = UrlFetchApp.fetch(
    'https://generativelanguage.googleapis.com/v1beta/models/' + model + ':generateContent',
    {
      method: 'post',
      contentType: 'application/json',
      headers: { 'x-goog-api-key': key },
      payload: JSON.stringify({
        systemInstruction: { parts: [{ text: systemText }] },
        contents: [{ role: 'user', parts: [{ text: userText }] }],
        generationConfig: { maxOutputTokens: 1024 }
      }),
      muteHttpExceptions: true
    });

  if (res.getResponseCode() !== 200) {
    console.error('Gemini 回傳 ' + res.getResponseCode() + '：' + res.getContentText());
    return '抱歉，我這邊暫時有點問題，請稍等一下由真人回覆你。';
  }
  var d = JSON.parse(res.getContentText());
  var out = d.candidates && d.candidates[0] && d.candidates[0].content &&
            d.candidates[0].content.parts && d.candidates[0].content.parts[0] &&
            d.candidates[0].content.parts[0].text;
  return out || '抱歉，我沒有讀懂這句話，請稍等一下由真人回覆你。';
}

/** 把回答送回 LINE */
function replyToLine_(replyToken, text) {
  var res = UrlFetchApp.fetch('https://api.line.me/v2/bot/message/reply', {
    method: 'post',
    contentType: 'application/json',
    headers: { Authorization: 'Bearer ' + cfg_('LINE_ACCESS_TOKEN') },
    payload: JSON.stringify({
      replyToken: replyToken,
      messages: [{ type: 'text', text: String(text).slice(0, 4900) }]
    }),
    muteHttpExceptions: true
  });
  if (res.getResponseCode() !== 200) {
    console.error('LINE 回覆失敗 ' + res.getResponseCode() + '：' + res.getContentText());
  }
}

/** 部署前先執行這個，檢查設定有沒有填好 */
function checkSetup() {
  console.log('LINE_ACCESS_TOKEN：' + (cfg_('LINE_ACCESS_TOKEN') ? '已填' : '❌ 沒有填'));
  console.log('GEMINI_API_KEY：'   + (cfg_('GEMINI_API_KEY')   ? '已填' : '❌ 沒有填'));
  console.log('GEMINI_MODEL：'     + (cfg_('GEMINI_MODEL')     || '（沒填，會用預設 gemini-3.5-flash-lite）'));
  console.log('PROMPT：'           + (cfg_('PROMPT')           ? '已填' : '（沒填，會用預設語氣）'));
  console.log('KNOWLEDGE：'        + (cfg_('KNOWLEDGE')        ? '已填' : '（沒填，AI 大部分問題都會說不知道）'));
}

「指令碼屬性」＝這個專案的設定欄位；秘密放這裡，不會出現在程式碼裡。先在下面備齊值（Token／Key 已從步驟 3、4 帶過來），再照表逐格貼。

先套用範例四行（第一次測試建議照這個）

1. GAS 左邊「專案設定」（齒輪）→ 最下面「指令碼屬性」→「新增指令碼屬性」。
2. 照下表逐列加：屬性名稱一字不差，值按每列「複製值」貼過去。
3. 全部加完按「儲存指令碼屬性」。

貼完 Token／Key 後，隨手再複製一段別的文字把剪貼簿蓋掉；Windows 有開剪貼簿記錄（Win+V）的，順手刪掉裡面的秘密。

1. 回編輯畫面，上方下拉選單選「checkSetup」→ 按「執行」。
2. 第一次執行會跳授權：「審查權限」→ 選你的 Google 帳號 → 出現「這個應用程式未經 Google 驗證」是正常的（這程式就是你自己剛貼的）→ 點「進階」→「前往（你的專案名稱）（不安全）」→「繼續／允許」。

1. 右上「部署」→「新增部署作業」。
2. 「選取類型」旁的齒輪 → 選「網頁應用程式」。
3. 兩格設定：「執行身分」＝「我（你的 email）」；「誰可以存取」＝「所有人」。
4. 按「部署」。
5. 完成視窗最下面「網頁應用程式」的網址按「複製」。

1. 回步驟 2 那頁（Manager → 設定 → Messaging API）。
2. 把剛複製的網址貼進「Webhook網址」那格 → 按「儲存」。
3. 左邊「回應設定」→ 把「Webhook」開成綠色。

同頁的「自動回應訊息」「加入好友的歡迎訊息」「聊天」開不開由你決定——它們跟機器人回覆不衝突（2026-08 實測）。想讓客人只收到 AI 的回答，就把自動回應關掉。注意：自動回應開著時，你測試收到的可能是罐頭回應而非 AI——測試時以回覆內容判斷。

用手機把自己的官方帳號加好友（Console 的 Messaging API 分頁有 QR code），照順序傳兩句。第一次測試先用步驟 6 的範例四行，通了再換自己的內容。

複製摘要已複製 ✓