For the complete documentation index, see llms.txt. This page is also available as Markdown.

LINE MINI App 遊戲模組申請

Step 1:啟用 Omnichat MINI App LIFF ID 欄位

  1. 請先通知品牌專屬顧問欲申請 LINE MINI App 遊戲模組,顧問會協助開通功能。

  2. 開通後,請到「通訊渠道」>「社群帳號」頁面, 確認對應的 LINE 渠道是否有出現一個 互動遊戲 MINI App LIFF ID(非必填) 的欄位。

  3. 若有的話,請接續 Step 2;若沒有,請先聯繫品牌專屬顧問確認。

Step 2:LINE Developers 建立 MINI App channel

請擁有 LINE 原生後台 最高權限者 進入 LINE Developers 操作下方設定:

  1. 進入 https://developers.line.biz/consol,並點擊右上角頭像

  2. 在左側列表選擇對應 LINE 帳號的 Provider,點擊 Create a new channel,選擇 LINE MINI App

  1. 填寫所有必填欄位資訊,需特別注意 Icon 設計須符合 LINE 規範

  2. 送出後,請在 Basic Settings 頁面滑到最下方檢查這兩個欄位:

    1. Localization (multi-language support):

      此為在不同語系的 MINI App 名稱與描述呈現,請至少要新增英文版本的。

    2. Linked LINE Official Account: 是否有正確設定對應的 line channel,此欄位請確保要填寫正確。

Step3:完成 Web app settings 頁面設定

  • shareTargetPicker:確認為 開啟 狀態

  • Endpoint URL

    • 參考下圖,在「LIFF URL」區塊,複製 ID,並按照下方格式組成 URL,填入對應階段的 URL

      • Developing:https://game.omnichat.ai/?liffId={{ID_Developing}}

      • Review:https://game.omnichat.ai/?liffId={{ID_Review}}

      • Published:https://game.omnichat.ai/?liffId={{ID_Published}}

  • Scopes:確認以下皆為勾選狀態

    • openid

    • profile

    • chat_message.write

  • Add friend option:On

  • Scan QR:不影響,可為關閉狀態即可

Step 4:完成 Business information 頁面設定

  • Customer support information:按照欄位字面意思提供相關客服管道資料

  • Service company information

    • Service company name:品牌公司名稱

    • Service company type:Corporate

    • Tax ID:品牌統編

    • Certificate document:代表公司是合法經營的事業的文件,例如商業登記、開業申報、所得稅申報書、營業執照…等與公司存在與營運資格相關的文件。

    • Identification document:代表公司負責人身份有效的文件,例如駕照、健保卡、護照、居留卡(外國人)等文件

    • Business license:營業執照

    • Website URL:品牌公司網站

    • Email address:審查重大更新寄送的信箱位址,必須要是在品牌公司網域的位址

  • Development company information開啟「Same as the service company」開關

Step5:完成 Contact information 頁面設定

這頁聯絡資訊是要讓 LINE 來與品牌公司討論 The use of LINE MINI App、LINE Developers Agreement、LINE MINI App Platform Terms of Use 的。

建議可填寫品牌公司平常負責整個 Omnichat 專案的人員資料。

Step6:完成 Omnichat 後台的 MINI App 設定

  1. 到 LINE Developer 後台到 Web app settings

  2. 看到 Basic information,將圖中畫線的 ID (MINI App LIFF ID),按照下方說明的需求複製:

  • Developing: 客戶內部測試時使用(若複製此ID,則只有在 LINE MINI App Channel 有權限的人才能打開連結)

  • Review: 提供給 LINE 做發布審查時使用(若複製此ID,則+LINE 的人可以打開連結)

  • Published: 審查完後上線時使用(若複製此ID,則所有人都打得開連結)

  1. 將上一步驟複製的 ID 填寫到 Omnichat 後台

Step7:設定預設遊戲

  1. Omnichat 後台建立一個遊戲模組(作為長期預設遊戲)

  2. LINE Developers 後台,於 MINI App 設定中修改 Endpoint URL,加上 defaultGid (default game ID,預設遊戲的遊戲 ID)

    • 原格式:https://game.omnichat.ai/?liffId=xxxx

    • 新格式:https://game.omnichat.ai/?liffId=xxxx&defaultGid=yyyy

Step8:在 Review request 頁面送出審查

  • Reference materials for the review:可以直接省略

  • 確認資料無誤後,即可點擊頁面底部的「Request review」按鈕,送出審查

Step9:審查通過後即可對外公開(以遊戲模組為例)

  • 審查通過後會 LINE 會 email 通知(Basic settings 中的 email)

  • 從 LINE Developer 後台的 Review request 頁籤也會看到審核狀態為 Approved

注意:在這個階段要更新miniapp對外公開的id置換

  1. 在 LINE Developer 後台 > Web app settings > LIFF URL > 找到 Published 的那組id ,複制id後ˇ

  2. 回到Omnichat後台> 通訊渠道 > 先前已設定的LINE channel 把 “互動遊戲 MINI App LIFF ID” 更新Published 那組id

Step10:設定完成!

接著就可以按照平常使用互動遊戲模組的方式操作,將連結複製到活動的機器人、圖文選單、活動頁面等等,推廣給終端顧客參與。

MINI App 常見問題

Q1. 上架 MINI App 要額外付費嗎?

不需要。

Q2. 已經發出去的 LIFF 遊戲連結,啟用 MINI App 後會發生什麼事?

依然可以正常開啟遊戲,獎項庫存計算不受影響。

可以想像成,LIFF 跟 MINI App 實際上是共存的狀態,只是我們在 Omnichat 後台上只顯示 MINI App 設定與連結來避免混淆。

Q3. 啟用 MINI App 後,還可以關閉退回使用 LIFF 來開啟遊戲嗎?

  • Omnichat 產品面:可以,聯繫品牌顧問處理即可,就會看到互動遊戲模組的連結改回 LIFF URL

  • 從 LINE Service 移除:LINE後台無法刪除。若有需要,請聯繫品牌顧問處理協助人工向 LINE 申請。

Q4. 按照步驟設定送出後,LINE 審查 Review 的天數?

LINE 公告需至少約 3-5 個工作天。

Q5. 送出發布審查後可以修改內容嗎?

可以,但特定修改範圍若有任何更新,需要再次送審。

修改範圍規則請見:https://developers.line.biz/en/docs/line-mini-app/service/update-service/

Q6. 目前 MINI App 是以遊戲模組串接,如果遊戲活動結束了之後會發生什麼事?

遊戲結束後畫面會停在原本的活動已結束畫面。

Q7. 如果 miniapp 送審之後點擊遊戲連結進入之後還是出現一直 loading 的狀態怎麼辦?

檢查 「 Linked LINE Official Account」是否有設定(參考 Step2 ),記得要設定line login channel

  • 注意:這個設定只有admin身份才能設定

  • 如果本來沒有設或變更設定,請設定完畢後記得到 Review request 頁面再發重新送審

Last updated