LINE 三件套整合指南 — Odoo 18 x WOOWTECH

1. 模組架構總覽

LINE 三件套由三個 Odoo 模組組成，依賴關係由下而上：

2. 前置準備

你需要準備的

LINE 需要建立的 Channel（兩個）

3. LINE Developer Console 設定

Step 1：建立 Provider

Step 2：建立 Messaging API Channel

Step 3：建立 LINE Login Channel（供 LIFF 使用）

Step 4：建立 LIFF App

4. 模組安裝

安裝順序

5. Odoo 設定（line.liff.config）

進入：LINE 選單 → 設定檔 → 新增

必填欄位（6 個）

LIFF ID（至少填一個）

店家資訊（選填）

行為設定

自動計算欄位（唯讀）

6. Webhook 設定

在 LINE Developer Console 設定

Webhook 處理的事件類型

7. LIFF 設定

LIFF（LINE Front-end Framework）讓用戶在 LINE 內開啟時自動登入 Odoo Portal。

LIFF 登入流程

LIFF Redirect 支援的目標頁面

8. LINE Official Account Manager 設定

到 manager.line.biz 設定以下項目：

9. 完整參數對照表

ir.config_parameter 系統參數

以下參數由 line.liff.config 自動同步寫入：

Messaging API 參數

LINE Login 參數

行為控制

LIFF 參數

店家資訊

其他

10. 功能模組說明

Rich Menu 管理

LINE → Rich Menu → 新增。上傳選單圖片 → 定義觸按區域 → 上傳到 LINE → 設為預設。

推播方式

分眾標籤（Audience Tag）

LINE → 分眾標籤 → 新增標籤 → 加入用戶 → 同步到 LINE Audience → 用於 narrowcast 推播

統計紀錄（Insight Log）

每日凌晨自動抓取 LINE Insight API：送達數、好友數、封鎖數、互動率。

關鍵字自動回覆

11. 程式碼範例

推播文字訊息

svc = env['line.api.service'].sudo()
user = env['line.user'].search([('display_name', 'like', 'Peter')], limit=1)

# push() 接受 line.user recordset
svc.push(user, [svc.build_text_message('Hello!')])

# push_message() 接受 string UID
svc.push_message('Ud370eadae1a02...', [svc.build_text_message('Hello!')])

全員廣播

svc = env['line.api.service'].sudo()
svc.broadcast([svc.build_text_message('公告：本週六休息')])

批量推播

svc = env['line.api.service'].sudo()
uids = env['line.user'].search([('is_follower', '=', True)]).mapped('line_user_id')
svc.multicast(uids, [svc.build_text_message('批量訊息')])

Flex 通知訊息

factory = env['line.flex.factory'].sudo()
flex = factory.build_notification(
    event_type='success',
    title='訂單已確認',
    subtitle='SO00123',
    info_rows=[('產品', '專業按摩'), ('金額', 'NT$ 1,500')],
    buttons=[{'label': '查看詳情', 'uri': 'https://你的網域/my/orders/123'}],
)
svc = env['line.api.service'].sudo()
svc.push_message('Ud370eadae...', [flex])

透過 Partner 推播

partner = env['res.partner'].browse(42)
partner.push_to_line('你的訂單已出貨！')  # 自動找到 LINE 用戶推播

分眾推播（Narrowcast）

# 1. 建立標籤並加入用戶
tag = env['line.audience.tag'].create({'name': 'VIP 客戶'})
vip_users = env['line.user'].search([('partner_id.customer_rank', '>', 5)])
tag.write({'user_ids': [(6, 0, vip_users.ids)]})

# 2. 同步到 LINE Audience
tag.action_sync_to_line()

# 3. 在推播新聞時選擇 narrowcast + 該標籤

12. 流程圖

設定流程

Webhook 事件處理

自動推播 Hook 流程

13. 疑難排解

14. 安全性注意事項

Webhook 安全

LIFF Token 安全

憑證儲存

Token 輪換流程

15. 完整設定檢查表

Phase 1：LINE Console 設定

• 到 developers.line.biz 建立 Provider
• 建立 Messaging API Channel → 複製 Channel ID / Secret
• 發行長效 Access Token → 複製
• 建立 LINE Login Channel → 複製 Channel ID / Secret
• 建立 LIFF App（至少 1 個）→ 複製 LIFF ID
• 設定 LIFF Endpoint URL

Phase 2：Odoo 安裝

• 安裝 woow_line_base 模組
• 安裝 woow_odoo_line_liff 模組
• 安裝 woow_odoo_livechat_line 模組（選裝）

Phase 3：Odoo 設定

• 建立 line.liff.config 記錄
• 填入 Messaging Channel ID
• 填入 Messaging Channel Secret
• 填入 Messaging Access Token
• 填入 Login Channel ID
• 填入 Login Channel Secret
• 填入 LIFF ID (Member)
• 填入店家資訊（選填）
• 設定 web.base.url 為 HTTPS

Phase 4：LINE Console 回填

• 複製 Odoo 的 Webhook URL → 貼到 LINE Console Webhook 設定
• 啟用 Use webhook 開關
• 點擊 Verify 確認成功
• 設定 LIFF Endpoint URL

Phase 5：LINE Official Account Manager

• 回應模式改為 Bot 模式（關閉聊天）
• Webhook 確認啟用
• 停用自動回應訊息
• 停用加入好友歡迎訊息

Phase 6：測試驗證

• 從 LINE App 傳訊息 → 確認 Odoo line.event.log 有記錄
• 從 Odoo 推播測試訊息 → 確認 LINE App 收到
• 測試 LIFF 登入 → 確認能自動登入 Portal
• 建立 Rich Menu → 確認 LINE 聊天室顯示
• 建立分眾標籤 → 同步到 LINE → 測試 narrowcast