藉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外部聯絡人。
點擊下一步以確認自動同步。
點擊完成退出當前頁面。

點擊完成退出頁面。

1562 — Sandbox Integration to CINNOX Successfully Completed

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。

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。

@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。

@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名稱旁的編輯按鈕。