> 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/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="/files/ppmulwT4KFknzz0jKpo6" 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="/files/dT5FggOSTIMtjKsskVis" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/ZsqMGXMCjisjNSkGiGla" 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="/files/JknDt2tNvhL2KtyOIfSu" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/naGnDUvoIORhaJ23FOs4" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/U0fmeuZ9kpaVPmyHQnQ8" 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="/files/JJOKEWC4qt8XsUBjEZxb" 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="/files/Rc1gDzHVqXX3pmGaywaI" 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="/files/2j6wO9FYbRQEpLUVIKK8" 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="/files/Is6x9OJrkoNLQ2X3jBbn" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/8dsI9xZ7t4RYBhzDmLYo" 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="/files/5pZb7KFJp86GrC049Ek4" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5ZaYRjhORvXZIBjrUlRp" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/k5arYBXOqcTDnNNjTmvl" 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="/files/XqKUdHO8S1WsoY9uaHFU" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/73kSjar3iEh8djQvGvrT" 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 頁面再發重新送審