> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/features/she-ding/tong-xun-qu-dao/integrations/line-mini-app/line-mini-app-you-xi-mo-zu-shen-qing.md).

# LINE MINI App 遊戲模組申請

## **Step 1：啟用 Omnichat MINI App LIFF ID 欄位**

1. 請先通知品牌專屬顧問欲申請 LINE MINI App 遊戲模組，顧問會協助開通功能。
2. 開通後，請到「通訊渠道」>「社群帳號」頁面，\
   確認對應的 LINE 渠道是否有出現一個 <mark style="color:red;">**`互動遊戲 MINI App LIFF ID（非必填）`**</mark> 的欄位。
3. 若有的話，請接續 Step 2；若沒有，請先聯繫品牌專屬顧問確認。

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2F4JOLsqxCrjVmKPVu8VMO%2FiScreen%20Shoter%20-%20Google%20Chrome%20-%20260708112657.png?alt=media&amp;token=5d92473c-9eb7-460e-b0b2-c29f2f4f1f67" alt="" width="563"><figcaption></figcaption></figure>

## Step 2：LINE Developers 建立 MINI App channel

請擁有 LINE 原生後台 <mark style="color:red;">**最高權限者**</mark> 進入 LINE Developers 操作下方設定：

1. 進入 [https://developers.line.biz/consol](https://developers.line.biz/console)，並點擊右上角頭像
2. 在左側列表選擇對應 LINE 帳號的 Provider，點擊 Create a new channel，選擇 LINE MINI App

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FNcQ0ZXaUWL8DvxBg7o3s%2FiScreen%20Shoter%20-%20Google%20Chrome%20-%20260708114229.png?alt=media&amp;token=4c7a6330-e962-4dba-9968-a460a2c69fea" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FhAHKxLRiv2y27QnPQ2DI%2F%E6%88%AA%E5%9C%96%202026-07-17%20%E4%B8%8A%E5%8D%8811.08.05.png?alt=media&amp;token=4a975c87-16c0-40af-bf2e-3c0134e293dc" alt="" width="563"><figcaption></figcaption></figure>

3. 填寫所有必填欄位資訊，需<mark style="color:red;">特別注意</mark> Icon 設計須符合 [LINE 規範](https://developers.line.biz/en/docs/line-mini-app/design/line-mini-app-icon/#logo-design)。
4. <mark style="color:red;">**送出後，請在 Basic Settings 頁面滑到最下方檢查這兩個欄位：**</mark>
   1. **Localization (multi-language support):**

      此為在不同語系的 MINI App 名稱與描述呈現，**請至少要新增英文版本**的。
   2. **Linked LINE Official Account:**\
      是否有正確設定對應的 line channel，此欄位請確保要填寫正確。

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FsyJauODLG7Rs3kTiYf5S%2F%E6%88%AA%E5%9C%96%202026-07-17%20%E4%B8%8B%E5%8D%882.23.51.png?alt=media&amp;token=919e7211-2da3-483f-a048-9d01f86aef07" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FqmbJSHQqjdCMYEnbYOaM%2F%E6%88%AA%E5%9C%96%202026-07-17%20%E4%B8%8A%E5%8D%8811.14.28.png?alt=media&amp;token=958115e1-14ba-415d-bf8b-eacee2c12bb8" alt=""><figcaption></figcaption></figure>

## Step3：完成 Web app settings 頁面設定

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FfZLTzU2YYELrmcnDH1g0%2F%E6%88%AA%E5%9C%96%202026-07-17%20%E4%B8%8B%E5%8D%882.23.43.png?alt=media&amp;token=abc30585-affc-4444-b238-08ac9e22e371" alt=""><figcaption></figcaption></figure>

* **shareTargetPicker**：確認為 <mark style="color:red;">`開啟`</mark> 狀態
* **Endpoint URL**
  * 參考下圖，在「LIFF URL」區塊，複製 ID，並按照下方格式組成 URL，填入對應階段的 URL
    * Developing：<https://game.omnichat.ai/?liffId=><mark style="color:red;">`{{ID_Developing}}`</mark>
    * Review：<https://game.omnichat.ai/?liffId=><mark style="color:red;">`{{ID_Review}}`</mark>
    * Published：<https://game.omnichat.ai/?liffId=><mark style="color:red;">`{{ID_Published}}`</mark>

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FLuBuA0A8cuVgwuWPcoHT%2Fimage.png?alt=media&amp;token=98272623-22e0-432e-96c4-8e44d7f0a2f7" alt="" width="563"><figcaption></figcaption></figure>

* **Scopes**：確認以下皆為勾選狀態
  * openid
  * profile
  * chat\_message.write
* **Add friend option**：On
* **Scan QR**：不影響，可為關閉狀態即可

## Step 4：完成 Business information 頁面設定

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2F8S5WQFnaLqlIvvmARPk4%2F%E6%88%AA%E5%9C%96%202026-07-17%20%E4%B8%8B%E5%8D%882.28.16.png?alt=media&amp;token=17bd8d23-895c-46f8-90ce-de6645e725e6" alt=""><figcaption></figcaption></figure>

* **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**：<mark style="color:red;">**開啟**</mark>「Same as the service company」開關

## Step5：完成 Contact information 頁面設定

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FTsIDKHcHdEI7ZbGWYi6v%2F%E6%88%AA%E5%9C%96%202026-07-17%20%E4%B8%8B%E5%8D%882.31.57.png?alt=media&amp;token=bebfb69e-29d7-4551-bb19-501db2fa0d45" alt=""><figcaption></figcaption></figure>

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

建議可填寫**品牌公司平常**<mark style="color:red;">**負責整個 Omnichat 專案的人員**</mark>資料。

## 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，則所有人都打得開連結）

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2Fz9SM4eD7kdHsFAfa0xVU%2Fimage.png?alt=media&amp;token=6228603e-b18d-4175-b551-5f0dd3f04374" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FmCkmd3Zuvke2XrDT5fkw%2Fimage.png?alt=media&amp;token=b9b56706-0c28-41ec-9d24-77a6fb0225b7" alt="" width="563"><figcaption></figcaption></figure>

## Step7：設定預設遊戲

1. 於 **Omnichat 後台建立一個遊戲模組**（作為長期預設遊戲）
2. 至 **LINE Developers 後台**，於 MINI App 設定中修改 Endpoint URL，加上 defaultGid (default game ID，預設遊戲的遊戲 ID)
   * 原格式：<https://game.omnichat.ai/?liffId=><mark style="color:red;">`xxxx`</mark>
   * 新格式：<https://game.omnichat.ai/?liffId=><mark style="color:red;">`xxxx`</mark>**\&defaultGid=**<mark style="color:red;">**`yyyy`**</mark>

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FE5Is6Bhz4q7BHJyfHLvv%2Fimage.png?alt=media&amp;token=066dd825-1149-4d3c-8b11-53f1e7eed6fd" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2F8Vo4H18R4Hzqe61bznH7%2Fimage.png?alt=media&amp;token=7963d803-5fff-4f3c-8cf2-a1dcc4244439" alt=""><figcaption></figcaption></figure>

## Step8：在 Review request 頁面送出審查

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FmN9iVqmnRa21su48qsSG%2F%E6%88%AA%E5%9C%96%202026-07-17%20%E4%B8%8B%E5%8D%882.43.37.png?alt=media&amp;token=fcb51f9f-70f8-47cf-b06b-d301980951a0" alt=""><figcaption></figcaption></figure>

* **Reference materials for the review**：可以直接省略
* 確認資料無誤後，即可點擊頁面底部的「Request review」按鈕，送出審查

## Step9：審查通過後即可對外公開（以遊戲模組為例）

* 審查通過後會 LINE 會 email 通知（Basic settings 中的 email）
* 從 LINE Developer 後台的 Review request 頁籤也會看到審核狀態為 Approved

#### <mark style="color:red;">**注意：在這個階段要更新miniapp對外公開的id置換**</mark>

1. 在 LINE Developer 後台 > **Web app settings > LIFF URL > 找到 Published** 的那組id ，複制id後ˇ
2. 回到Omnichat後台> 通訊渠道 > 先前已設定的LINE channel 把 **“互動遊戲 MINI App LIFF ID”** 更新Published 那組id

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FWfhK3eW06Jrk3nUv1eFP%2Fimage.png?alt=media&amp;token=1bd34e85-8504-493c-ab55-8b99ad568f3e" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FXDgJmU7d43scaixNfBTf%2Fimage.png?alt=media&amp;token=378f37a8-a664-4bbc-be62-4af09c422d38" alt="" width="563"><figcaption></figcaption></figure>

## Step10：設定完成！

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

## MINI App 常見問題

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

不需要。

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

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

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

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

* **Omnichat 產品面：**&#x53EF;以，聯繫品牌顧問處理即可，就會看到互動遊戲模組的連結改回 LIFF URL
* **從 LINE Service 移除：**&#x4C;INE後台無法刪除。若有需要，請聯繫品牌顧問處理協助人工向 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](https://app.gitbook.com/o/-L_qBouk_wijumBR7PT3/s/-LaFmilpuDQ-f7VKjHCH/~/edit/~/changes/2203/features/tong-xun-qu-dao/integrations/line-mini-app/line-mini-app-you-xi-mo-zu-shen-qing#step-2line-developers-jian-li-mini-app-channel) ），記得要設定line login channel

* 注意：這個設定只有admin身份才能設定
* 如果本來沒有設或變更設定，請設定完畢後記得到 Review request 頁面再發重新送審
