菜单

整合Salesforce

藉Salesforce與CINNOX整合，提升團隊、生產力以及回應效率。你可以在同一平台，處理客戶資料，以及與他們互動。

它們的整合，可以聯繫聯絡人和與你的聯絡人資料同步，將他們的諮詢作個案記錄，其通話作為工作，以便在CINNOX平台，管理聯絡人與你的交流和參與，而無需轉換應用程式。

先決條件

📘

你的服務方案必須為The Ultimate CX Hub。你的 Salesforce方案必須是 Enterprise、Unlimited、Developer 或具有 API 訪問權限的版本。

如何知道你的Salesforce版本？

確定你使用的版本：

使用Salesforce Classic 和 Lightning Experience：

如果你使用Lightning Experience，點擊齒輪圖示，然後選取設定首頁。
如果你使用Salesforce Classic 且在使用者介面頁首中看到設定，請點擊它。如果你使用Salesforce Classic 且並未在頁首看見設定，請點擊你的姓名，然後選擇設定。
進入設定，在快速尋找方塊中輸入公司資訊，然後選取公司資訊。組織版本會顯示在右下方。

注意：Salesforce Organization ID和Instance等其他關鍵組織資料，亦會在公司資訊頁面的右側列出。你點擊此連結了解更多資料。

概述

甚麼是Salesforce Sandbox(沙盒)？

Sandbox是正式環境的副本，通常用於整合的測試與開發，不會影響到你的實際資料。在部署到生產環境之前，需要先與你的CINNOX帳號和Salesforce Sandbox帳號做整合測試。

什麼是Salesforce Production(生產環境)？

Production為一個正式環境，任何更改都會影響你的實際數據。完成與Sandbox帳號的整合後，再連接你的 Production 環境。

在將Salesforce Production連接到第三方時，Salesforce要求在部署上出現的配置，必須先在Sandbox中進行，而非直接在Production進行。

對於每個實例(沙盒和生產)，你都需要在Salesforce中新增以下項目：

遠端網站(Remote Site)：藉註冊外部網站資源的URL，你或你的組織可以使用在Salesforce進入該外部網站的資源。
連線的應用程式(Connected App)：它是一個框架，藉此，外部的應用程式能連接到Salesforce，並可使用需要權限允許的數據。
Apex類別(Apex Class)：Salesforce可以藉Apex類別，操作外部的網頁服務。
Apex觸發(Apex Trigger)：Apex觸發可以在變更 Salesforce記錄(例如：插入、更新、刪除)的前後進行設定，以執行自訂動作。(例如：你的聯絡人)。

並且，你需要提供以下信息。

消費者金鑰(Consumer Key)和消費者密碼(Consumer Secret)：用於驗證你與 Salesforce連接的應用程式。
網域名稱(Domain Name)：你在 Salesforce Org的完整網域名稱 (FQDN)，例子如下：

Sandbox的URL：https://abc--testsandbox.lightning.force.com/lightning/page/home 中，你的Salesforce Org域名是 https://abc--testsandbox.lightning.force.com。
在生產環境的URL：https://abc.lightning.force.com/lightning/page/home 中，你的Salesforce Org域名是 https://abc.lightning.force.com。

位置：僅用於Sandbox連接。每個Sandbox在你的Sandbox帳號中，都有一個對應的位置。

🚧

將Salesforce集成到CINNOX服務時，請使用你的系統管理帳號。

按照Salesforce提供的步驟，在 Sandbox中新增的Apex類別和Apex觸發，需要在生產環境中部署。

連接成功後，你和員工可以登入你的Salesforce用戶帳號，當中會提供以下功能：

CINNOX和Salesforce連接後提供的功能

功能	內容
Salesforce 連絡人資料在CINNOX顯示	當客戶的諮詢和Salesforce連絡人的資料一樣時，該資料會在CINNOX的諮詢詳細資訊中顯示。
同步Contact資料	當Salesforce連絡人資料和它在CINNOX的連絡人資料互相同步，可以在單一平台，查看所有資料。 CINNOX和Salesfore聯絡人資料的欄位配對，令兩者的資料自動同步。每一位員工需要登入Salesfore帳號，從而令Salesfore 連絡人與CINNOX同步。
連接外部聯絡人	一個Salesforce連絡人連接一個CINNX的外部聯絡人。一個CINNOX外部聯絡人可連接十個Salesforce連絡人。
新增外部聯絡人	當在CINNOX新增外部聯絡人時，Salesforce亦會新增該連絡人。
搜尋連絡人	你可以在Salesforce搜尋Salesforce連絡人。
更新連絡人	你可以在CINNOX更新儲存Salesforce連絡人。
CINNOX的諮詢自動變成Salesfoce的個案	CINNOX外部聯絡人的諮詢，會自動儲存為Salesforce的個案，並提供相關資訊和對話記錄。
CINNOX的通話自動變成Salesforce工作	你在CINNOX的諮詢通話，會自動在Salesforce儲存為工作。通話日誌的內容，會記錄在工作詳細資料內。
簡訊營銷活動	向Salesforce連絡人執行簡訊營銷活動。

連接CINNOX和Salesforce

沙盒環境

你需要在Salesforce新增Sandbox。
使用你的系統管理員帳號，登入到Salesforce Sandbox Org。

之後，請繼續執行以下步驟：

使用你的員工管理員帳號，登入你的 CINNOX控制面板。
導航到管理>服務整合
點擊第三方整合。
點擊Salesforce (Sandbox)。
選擇Salesforce Sandbox，並點擊下一步。

新增遠端網站

使用你的系統管理員帳號，登入到你的Salesforce Sandbox組織。
導航到設定>安全性控制>遠端網站設定。
點擊新遠端網站。
將遠端網站名稱和遠端網站URL，從CINNOX複製到 Salesforce 的同位置的欄位內。
點擊儲存。

新增已連線的應用程式

使用你的系統管理員帳號，登入到你的 Salesforce Sandbox 組織。
導航至設定 >建立>應用程式，在已連線的應用程式部份，點擊新增。
填寫表格中必須填寫的部份，並勾選啟用 OAuth 設定。
將 Callback URL 從 CINNOX複製到 回電 URL
在選取的 OAuth 範圍 下，點擊並選擇新增以下內容：
- 透過API管理使用者資料(api)
- 存取身分URL服務(id, profile, email, address, phone)
- 隨時執行請求(refresh_token, offline_access)
點擊儲存。

螢幕出現帶有註釋的頁面：變更最多可能需要 10 分鐘才會生效。刪除父系組織也將刪除所有啟用 OAuth 設定的已連線應用程式。點擊繼續。

新增Apex類別

使用你的系統管理員帳號，登入到你的 Salesforce Sandbox 組織。
導航到設定>自訂程式碼>Apex類別>點擊新增。
從 CINNOX 複製並貼上 webhook 代碼到 Salesforce Apex類別編輯器(Apex Class分頁)。
點擊儲存。

新增Apex觸發

使用你的系統管理員帳號，登入到你的 Salesforce Sandbox 組織。
導航到設定>自訂程式碼>Apex觸發>點擊Developer Console。
在彈出窗口中，點擊File，選擇New，然後選擇Apex Trigger。

在彈出式視窗中，輸入名稱，例如：Triggercode1，在 sObject 字段中選擇 Contact，然後點擊 Submit。

刪除Developer Console中的預設代碼。
從CINNOX 複製觸發代碼，並將之貼到Developer Console內。
點擊File，選擇Save。
返回並更新 Apex 觸發頁面，新增的Apex觸發會出現。

返回CINNOX控制面板，點擊下一步。

消費者金鑰 和 消費者秘密

提供消費者金鑰：

導航到設定>應用程式>應用程式管理員。
查找最近在 CINNOX 新增的連線應用程式。
點擊向下箭頭圖標並選擇檢視。
點擊管理消費者詳細資料按鈕。

填上驗證代碼後，點擊驗證。

點擊消費者金鑰和消費者秘密的複製按鈕。
將之貼到 CINNOX 中的相應欄位內。

位置

要查找Sandbox位置：

使用你的系統管理員帳號，登入到你的 Salesforce Sandbox 組織。
導航到部署 >Sandbox 。
將位置值貼到CINNOX的相應欄位內。

域名

要查看域名：

在Sandbox頁，點擊登入。

在你的Salesforce Sandbox組織頁面上，導航到URL。
複製域名，例如：https://abcltd4--domli.sandbox.my.salesforce.com/，並將之貼到 CINNOX 中的相應欄位內。
在CINNOX，點擊驗證。

彈出式視窗出現，要求你登入Salesforce 系統管理員 帳號以授權 CINNOX。

注意：如果這是你首次使用 Salesforce 帳號，登入到設備和瀏覽器，Salesforce 將驗證碼發送到你的電子郵箱，並為 CINNOX要求取得以下權限：

存取身份URL服務
透過API管理使用者資料
隨時執行要求
然後，點擊允許。

當你完成這些步驟，並成功連接Sandbox Org到CINNOX後，會出現以下頁面。在預設的情況下，你的 Salesforce連絡人將同步並顯示在你的CINNOX 聯絡人中。

你可以啟用將外部聯絡人自動同步到Salesforce，從而在Salesforce中同步和顯示你在CINNOX外部聯絡人。
點擊下一步以確認自動同步。
點擊完成退出當前頁面。

點擊完成退出頁面。

Salesforce連絡人欄目和 CINNOX聯絡人欄目對照表

以下為Salesforce連絡人欄目和 CINNOX 聯絡人欄目對照表。這些欄目上的記錄能夠在兩者自動同步。

Salesforce連絡人欄目	CINNOX聯絡人欄目
姓氏	姓氏
名字	名字
職稱	職位
部門	團隊
生日	出生日期
電話	公司電話
住家電話	住宅電話
行動電話	手機電話號碼
其他電話	其他電話
郵寄街道	街道名稱
郵寄城市	城市
郵寄州/省	地區
郵寄郵遞區號	郵遞區號
郵寄國家	國家
電子郵件	電子郵件地址

有關登入 Salesforce 的詳細資料，以及更多其功能的資料，請參閱本指南的CINNOX 中的 Salesforce連絡人及案例部份。

🚧

當終斷Sandbox連接，Salesforce連絡人和外部聯繫人的更改，不再在CINNOX 服務中生效。

Sandbox用於測試集成，並新增 Apex 類別和其觸發，以在生產環境中部署。

中斷連接Sandbox和CINNOX

如要中斷連接Sandbox和CINNOX：

使用員工管理員帳號，登入 CINNOX 控制面板。
導航到管理>服務整合。
點擊第三方整合。
點擊中斷連接。
在彈出式視窗點擊中斷連接。

生產環境

使用你的系統管理員帳號，登入到新增的 Salesforce Org 的生產環境。

之後，請繼續執行以下步驟：

使用你的員工管理員帳號，登入到你的CINNOX控制面板。
導航到管理 > 服務整合。
中斷連接Sandbox。
點擊編輯。
Salesforce 整合選擇頁中，選擇Salesforce 生產。
點擊下一步。

📘

遠端網站和連線應用程式 的新增步驟與其在Sandbox的步驟類似，唯一分別在於環境的不同。

新增遠端網站

使用你的系統管理員帳號，登入到新增的 Salesforce Org 的生產環境。
導航到設定>應用程式>遠端網站設定。
點擊新遠端網站。
將遠端網站名稱和遠端網站URL，從CINNOX複製到 Salesforce 的同位置的欄位內。
點擊儲存。

新增連線應用程式

使用你的系統管理員帳號，登入到你的Salesforce生產組織。
導航到 **設置 >應用程式>應用程式管理員>**新的已連線應用程式**。
填寫表格中必須填寫的部份，並勾選啟用 OAuth 設定。
將Callback URL從CINNOX複製到回電 URL。
在選取的OAuth範圍下，點擊並選擇新增以下內容：
- 透過API管理使用者資料(api)
- 存取身分URL服務(id, profile, email, address, phone)
- 隨時執行請求(refresh_token, offline_access)
點擊儲存。

螢幕出現帶有註釋的頁面：變更最多可能需要 10 分鐘才會生效。刪除父系組織也將刪除所有啟用 OAuth 設定的已連線應用程式。點擊繼續。

在生產環境部署Sandbox Apex類別和觸發

你需要新增測試類，並且代碼覆蓋率超過 75%，才能在生產環境中部署Apex類別。

更多詳細資料請參考Instructions to test Apex code。

I. 新增測試類別

以下是你可以添加到 Sandbox 組織的示例測試類。

使用你的系統管理員帳號，登入到你的 Salesforce Sandbox 環境。
導航到設定>自定程式碼>Apex 類別。

點擊新增建立一個新的Apex Class。
複製並貼上下面的代碼到Apex Class。

WebhookMockImpl

复制代码

global class WebhookMockImpl implements HttpCalloutMock {
    public static HttpResponse response;
    global HTTPResponse respond(HTTPRequest req) {
        response = new HttpResponse();
        response.setStatusCode(200);
        return response;
    }
    global static void callout(String url, String content) {
        
    }
}

點擊Save
成功新增了一個Apex類別。

返回 Apex 類別主頁
點擊新增建立一個新的Apex Class。
複製並貼上下面的代碼到Apex Class。

TestContactTrigger

复制代码

@isTest
public class TestContactTrigger {
    @isTest static void TestTrigger() {
        // Test data setup
        // Create an account with an opportunity, and then try to delete it
        Account acct = new Account(Name='Test Account2');
        insert acct;
        Contact newContact = new Contact(LastName='TestContact3', AccountId=acct.id);
        //insert newContact;
        
        

        // Perform test
        Test.startTest();
        Test.setMock(HttpCalloutMock.class, new WebhookMockImpl());
        Database.SaveResult result = Database.insert(newContact, false);
        Test.stopTest();
        // Verify 
    System.debug(result.getErrors());        
        System.assert(result.isSuccess());
    }
}

點擊Save
成功新增了一個Apex類別。

返回 Apex 類別主頁
點擊新增建立一個新的Apex Class。
複製並貼上下面的代碼到Apex Class。

TestWebhook

复制代码

@isTest
public class TestWebhook {
    @isTest static void TestJsonContent() {
        System.TriggerOperation op = TriggerOperation.AFTER_INSERT;
        List<Account> contacts = new List<Account>();

        String result = Webhook.jsonContent(op, contacts, contacts);
        System.assert(result.length()>0);
    }
}

點擊Save
成功新增了一個Apex類別。

📘

你在Sandbox Org 總共新增了4個Apex Class。

II. 部署 Apex 類別

使用你的系統管理員帳號，登入到你的 Salesforce 生產組織。
導航到環境>部署>部署設定。
檢查你的Apex類別是否在Sandbox Org。
當上載驗證方向不是從 Sandbox 指向 Production的綠色箭頭時。例如：它顯示一條斷開的紅線(請參閱下圖)，點擊Sandbox名稱旁的編輯按鈕。