在 Odoo 設定 WhatsApp:香港企業的連接與訊息範本指南
逐步教學:如何透過 Meta API 將 WhatsApp 連接至 Odoo,並建立用於發票、銷售確認及客戶溝通的動態訊息範本。

為何 WhatsApp 應該整合進你的 Odoo
在 APAA,我們服務的香港中小企幾乎都已經用 WhatsApp 與客戶溝通——這就是香港做生意的方式。問題在於,這些對話通常活在某人的私人電話裏,與公司系統內的訂單、發票及聯絡人完全脫節。將 WhatsApp 連接至 Odoo 正好填補這道鴻溝:你可以透過客戶每天都會查看的渠道,直接發送發票、銷售確認及營銷訊息,而資料則由 Odoo 自動帶入。
Odoo 預設已配備一套實用的 WhatsApp 範本,你也可以為自己的業務流程建立自訂範本。本指南會帶你走完整個設定——連接 Meta API、配置 webhook,以及建立令整件事真正值得做的動態範本。
將 WhatsApp 連接至 Odoo
在動手設定 Odoo 之前,你需要先在 Meta Developer Console 中建立一個 WhatsApp API 應用程式。Odoo 的官方文件會逐步說明這個流程,值得仔細跟隨——在這個階段我們見到的大部分設定問題,都源於 Meta 應用程式配置錯誤,而非 Odoo 本身。
在 Odoo 端,打開你商業帳戶的 WhatsApp 配置面板。在 Sending Messages 區域下,有五個欄位需要從你的 Meta 應用程式中填入:

- Phone Number ID
- Access Token
- App ID
- Account ID
- App Secret
輸入這些值後,點擊 Test Connection。出現綠色確認通知即表示配置正確。若未見綠色,請回頭逐項核對 Meta 應用程式中的值——只要一個字元有誤,測試便會失敗。

配置 Webhook
連接測試通過後,Odoo 會自動填入兩個額外的值:
- Callback URL
- Webhook Verify Token

這兩個值需要輸回 Meta Developer Console 中,用於設定 webhook——即將客戶在 WhatsApp 上的回覆路由回你 Odoo 資料庫的通道。略過這一步,訊息雖然能發出,回覆卻永遠回不到 Odoo,這便違背了把整件事放進系統處理的原意。
決定由誰收到通知
在 WhatsApp 商業帳戶配置頁面底部,Control 區域可讓你指定哪些使用者會在客戶回覆時收到通知。

通知規則如下:
- 建立配置的使用者會被預設加入。
- 你可手動新增其他使用者。
- 若 15 天內未發送過範本訊息,所有列出的使用者都會收到來訊通知。
- 否則,只有最近發送範本訊息的使用者會收到通知。
對成長中的企業而言,這一點相當重要:你可以在 Odoo 中為不同團隊配置多個 WhatsApp 帳戶——客服、銷售、招聘——讓正確的訊息送到正確的人手上,而不是擠在一部無人專責的共用電話裏。
認識 WhatsApp 範本
凡是由企業主動發起的對外訊息,Meta 都要求使用範本,因此範本並非可有可無——它根本就是你向客戶發訊的唯一途徑。每個範本都必須關聯至 Odoo 中的一個 WhatsApp Business Account。
要建立新範本,前往 Templates 選單並選擇 New,或開啟現有範本作為參考。

逐項拆解範本設定
每個範本都有幾個關鍵欄位,以下逐一說明其作用。
適用對象(模型)
此欄位設定範本所運行的 Odoo 模型——日記帳分錄、銷售訂單、聯絡人等。範本中的動態欄位會從這個模型提取資料,因此把它設定正確,是後續一切的基礎。

若不確定某個模型的名稱,可以這樣查找:
- 進入開發者模式。
- 將滑鼠懸停在資料所在的欄位上——例如聯絡人表單上的客戶名稱。
- 資訊框會顯示模型名稱。

電話欄位
設定為 Phone 或 Mobile,指向模型中的電話號碼欄位。該號碼必須已註冊 WhatsApp,否則訊息無處可送。
類別
選擇與範本用途相符的一項:
- Marketing——推廣內容。
- Authentication——驗證碼。
- Utility——交易訊息,例如發票及訂單確認。

對於發票等客戶交易,選擇 Utility。
允許使用者
留空,則所有 Odoo 使用者均可使用該範本。否則,指定哪些使用者有權使用。
其他設定
- Technical Name——範本的內部識別碼。
- Language——在建立範本時設定。
- Header Type——文字、圖片、影片、文件或位置。
- Footer——僅限文字,適合用於退訂提醒或簡短公告。

動態佔位符與變數
這正是範本由靜態文字蛻變為真正派上用場的關鍵。動態佔位符是訊息內文中的編號標記——{{1}}、{{2}} 等等——你把它們放進內文,每一個都對應一個變數,用於從 Odoo 資料庫中提取特定資料。

在 Variables 標籤頁中,每個佔位符有四項屬性:
- Name——佔位符參考名稱。
- Sample Value——用於測試的預覽資料。
- Type——資料來源類型。
- Field——對應的模型欄位。

變數類型
| 類型 | 說明 |
|---|---|
| Username | 當前使用者的名稱 |
| User Mobile | 當前使用者的手機號碼 |
| Free Text | 自訂靜態文字 |
| Portal Link | 自動產生的入口網址 |
| Field of Model | 來自「適用對象」模型的資料 |
當中以 Field of Model 最為靈活,它允許你引用關聯模型中的任何欄位——合作夥伴名稱、發票編號、公司、含幣種的總金額等。
實例示範:發票範本
完成的發票範本會填入:
- 客戶名稱
- 發票編號
- 公司名稱
- 含幣種的總金額
- 線上付款的入口連結

每筆交易和每位客戶的值都是獨一無二的——同一個範本發給一百位客戶,便產生一百則個人化訊息,毫無手動工序。對於以 WhatsApp 發送發票的中小企而言,這正是整件事的回報所在。
為範本新增按鈕
Buttons 標籤頁可讓你在訊息下方放置互動元素。可用的按鈕類型有三種:
| 按鈕類型 | 用途 |
|---|---|
| Quick Reply | 預設回覆選項,一鍵回覆 |
| Call Number | 直接撥打電話按鈕 |
| Visit Website | 連結至網址 |

按鈕讓訊息更具互動性、更易於行動。快速回覆按鈕會直接顯示在訊息下方,方便客戶一鍵回應。

Allow Multi
Allow Multi 開關控制該範本是否出現在批量發送的操作選單中。若需要同時向多位收件人發送同一範本,請啟用此選項。
提交範本審核
範本在獲 Meta 審核通過之前無法使用:
- 預覽範本,確認所有內容正確。

- 點擊 Submit for Approval。
- 等待 Meta 審核——所需時間視範本複雜度而定。
審核通過後,範本即可在你的 Odoo 應用程式中使用。
在 Odoo 中使用 WhatsApp,能讓銷售、會計及客服的客戶溝通變得順暢——全部源自那個早已存有你資料的系統。我們對客戶的建議始終如一:先用預設範本熟習操作,再隨業務需求建立自訂範本。
若你希望由 APAA 在你的 Odoo 實施中一併處理 Meta API 設定與範本配置,與我們聯絡——我們會讓 WhatsApp 與你的 Odoo 一次就接妥。