Salesforce 與 3CX 整合指南 — OAuth 2.0 連接、來電彈屏與通話日誌自動化

為甚麼要將 Salesforce 與 3CX 整合？

Salesforce 是全球採用率最高的 CRM 平台之一，從銷售機會（Opportunity）管理、客戶服務到行銷自動化，都是眾多香港及跨國企業的核心業務系統。3CX V20 內建 SalesforceV2 connector，透過 3CX API for CRM 直接對接 Salesforce REST API——無需第三方中介軟件，即可實現來電彈屏、通話日誌自動寫入與瀏覽器一鍵撥號，讓電話系統與 CRM 數據真正同步。

本文是 28voip 整合系列第三篇。前兩篇分別介紹了 Asterisk / FreePBX 與 3CX 整合及 Odoo 與 3CX 整合；如想了解 3CX 支援的各種 CRM 對接方案，可參考3CX 與 CRM 整合總覽。

五大原生整合功能

3CX 與 Salesforce 的原生整合（官方文件：3CX Salesforce CRM Integration）提供以下功能：

• 來電彈屏（Caller ID to Contact Name）：外部來電即時觸發 Salesforce 聯絡人查詢，客戶姓名與資料即時顯示於 3CX 客戶端。
• 聯絡人搜尋：在 3CX Webclient 內按姓名、電話號碼或電郵地址搜尋 Salesforce 聯絡人與公司資料。
• Call & Chat Journaling：通話與聊天記錄自動寫入 Salesforce Contact Card 成為 CRM call records，團隊任何成員均可查看完整客戶互動歷史。
• 建立新聯絡人：未知號碼來電時，可直接在 3CX 客戶端為來電者建立 Salesforce Lead 或 Contact。
• Click to Call：透過 3CX Click2Call 瀏覽器擴充套件（Google Chrome / Microsoft Edge），在 Salesforce 介面一鍵撥號。

部署前檢查清單

• Salesforce 帳戶必須啟用 REST API（是否支援視乎 Salesforce edition 而定）。
• ⚠️ 啟用 Person Accounts 的 Salesforce 帳戶不支援此整合。
• 3CX V20（SalesforceV2 connector）；如需 PKCE 驗證流程，需 V20 Update 6 或以上。
• Salesforce 聯絡人電話號碼建議以 E164 格式（含 + 號前綴）儲存，確保來電匹配準確。
• 用於通話日誌的 3CX 分機，其電郵地址必須與對應 Salesforce 用戶的電郵相同（系統以此作映射）。

五步完成設定

步驟一：在 Salesforce 建立 External Client App

1. 登入 Salesforce，進入 Setup → Apps → App Manager，點擊 New External Client App。
2. 填寫基本資料後，在 API（Enable OAuth Settings）啟用 Enable OAuth。
3. Callback URL 填入 3CX 管理介面網址並加上 /api/oauth2crm，例如 https://my-pbx.example.com/api/oauth2crm。
4. 授予所需權限：Access the identity URL service（id, profile, email, address, phone）、openid、Full Access、Manage user data via APIs（api）、Manage user data via Web browsers（web）、Perform requests at any time（refresh_token、offline_access）。
5. Security 部分勾選 Require Secret for Web Server Flow 及 Require Secret for Refresh Token Flow；亦可啟用 PKCE 選項加強安全（3CX V20 Update 6 起支援）。
6. 在 OAuth Policies 將 Permitted users 設為 All users can self-authorize，最後記下 Consumer Key 與 Consumer Secret。

步驟二：在 3CX 設定 SalesforceV2 Connector

1. 3CX Admin Console → Integrations → CRM，在下拉選單選擇 SalesforceV2。
2. 填入 Consumer Key 與 Consumer Secret，按 Save 再按 Authorize 完成 OAuth 授權，系統會顯示取得的 Refresh Token。

步驟三：設定 Call & Chat Journaling

1. 確認 3CX 分機電郵與 Salesforce 用戶電郵一致，3CX 才能正確映射通話日誌的歸屬用戶。
2. 啟用 Enable Call Journaling，設定 Call Subject 及各類通話（已接來電／未接來電／已接外撥／未接外撥）的描述文字。
3. 欄位支援變數，例如 [Number] 代表外部號碼；如需記錄聊天對話，可同時啟用 Chat Journaling。

步驟四：E164 號碼匹配

1. 來電匹配規則：來電號碼最後 7 位與 CRM 電話欄位最後 7 位相符，或由 SIP Trunk 收到的全號碼完全相符。
2. 3CX Admin Console → System → Phonebook → Options：匹配策略設為 Match exactly（Salesforce 與 SIP Trunk 均使用 E164 時），或 Match at least 7 characters。
3. Salesforce 聯絡人號碼須包含 + 前綴，避免 Salesforce 自動重排格式導致匹配失敗；必要時可配合 Caller ID Reformatting 調整來電號碼格式。

步驟五：設定 Contact Creation

1. 啟用 Allow contact creation directly to your CRM using 3CX Web Client。
2. 選擇要建立的實體類型（Lead 或 Contact），並可設定 New Lead Company 預設公司名稱。
3. 注意：因 Salesforce API 限制，建立 Contact 時 Web Client 填寫的公司名稱會被忽略；建立 Lead 時則會正常填入。

進階自動化：3CX API × Salesforce Flow

原生 connector 之外，3CX 同時開放 XAPI、Call Control API 與 Webhooks，配合 Salesforce Flow 或 REST API 可建構更深層的業務自動化：

• 未接來電自動開 Case：透過 Webhooks 接收未接來電事件，觸發 Salesforce Flow 自動建立 Task 或 Case 並指派同事跟進。
• 掛線即更新商機：通話結束事件即時推送 Salesforce，自動更新 Opportunity 的最後聯絡時間，銷售報告無需人手輸入。
• AI 通話摘要歸檔：3CX V20 Update 10 的 AI 通話摘要（Summary / Notes / Action Items 三段式結構）結合通話日誌，令銷售及客服跟進工作一目了然。
• VIP 客戶路由：根據 Salesforce 客戶等級設定 3CX Route by Topic，尊貴客戶來電直達專屬團隊，提升客戶體驗。

如需了解 3CX XAPI、Call Control API 與 Webhooks 的技術細節及應用實例，可參考我們的Asterisk / FreePBX 與 3CX 整合指南中的 API 深度整合章節。

四大應用場景

• 銷售團隊：來電彈屏即時顯示客戶與商機資料，Click2Call 一鍵回撥潛在客戶，所有通話自動記錄在 Contact Card。
• 客戶服務：客服接聽前已掌握客戶完整紀錄；通話後配合 AI 摘要，大幅縮短跟進時間。
• 金融及保險業：E164 精確匹配確保客戶識別準確，所有通話自動歸檔於 CRM，符合合規審計要求。
• 跨部門協作：銷售、客服、市場共享同一份通話歷史，建立更完整的客戶 360 視圖。

部署路線圖

28voip 為客戶部署 Salesforce × 3CX 整合時，一般按以下五個階段推進：

1. ASSESS 評估：盤點 Salesforce edition 與 API 配額、聯絡人號碼格式、分機電郵映射。
2. PLAN 規劃：設計 OAuth App 建立流程、Journaling 欄位與變數、號碼匹配策略。
3. DEPLOY 部署：設定 SalesforceV2 connector、完成 OAuth 授權、安裝 Click2Call 擴充套件。
4. TEST 測試：驗證來電彈屏、日誌寫入、號碼匹配與新聯絡人建立流程。
5. OPERATE 運維：制定號碼格式規範、監察 API 用量、按業務變化持續調整。

為何選擇 28voip？

• 3CX Titanium Partner：香港少數達到鈦金級別的 3CX 合作夥伴，直接取得官方支援資源。
• V20 Basic & Advanced 雙認證工程師：由整合設定、號碼格式規劃到故障排查一手包辦。
• 豐富整合經驗：由 CRM（Salesforce、Odoo）、開源電話系統（Asterisk / FreePBX）到 AI 客服代理與 3CX AI Server，跨平台整合一次規劃到位。

28voip 是香港 3CX Titanium Partner，專注 3CX 電話系統部署、CRM 整合、SIP Trunk 及 IP 話機方案，為企業提供由規劃、部署到日常支援的一站式服務。

開始規劃你的 Salesforce × 3CX 整合

立即聯絡 28voip，由認證工程師為你評估現有 Salesforce 環境，規劃最合適的整合方案：

• 📞 電話：+852 3900 1928
• 💬 WhatsApp：wa.me/85239001928
• ✉️ 電郵查詢：聯絡我們