歡迎來到 Super 8 的使用教學，這個單元將會教你如何使用開發者進階功能-外部服務及動態產生卡片訊息。
問題：
開發者進階功能對很多 Super 8 用戶來說都是不太好理解的一部分，於是我們先就外部服務及動態產生卡片訊息來說明他的功能或是在什麼情境下可以使用？下方就來為大家解答喔！
說明：
當您的情境是需要抓取您公司的資料，像會員資料、商品價格資料或菜單資料等外部資訊時，就建議您可以使用「外部服務」的功能。
當您的情境是希望用卡片的方式來呈現您的外部資訊時，就建議您可以使用「動態產生卡片訊息」的功能。
假設情境：希望顧客參加抽獎活動，並告知顧客是否有中獎
以下將結合外部服務＆動態產生卡片訊息兩種功能，在示範中一起呈現。
1. 建立流程：參加抽獎
觸發步驟：進入條件的觸發形式選擇「被顧客傳送內容觸發」，條件選擇當顧客輸入關鍵字「我要參加抽獎」。此處僅為示範，關鍵字請依您的情境自定義。
第一步驟：開啟「檢查進入條件」，條件設置為標籤等於「 2019-09-Raffle 」。行為的行為形式選擇「前往流程」，流程名稱選擇「參加抽獎 - 登記過了」
第二步驟：進入條件不開啟，行為中的行為形式選擇「設定標籤」，標籤自訂為「2019-09-Raffle」。此處僅為示範，標籤名稱請依您的情境自定義。
第三步驟：進入條件不開啟，行為中的行為形式選擇「程式碼」，參數內容設置帶入顧客資訊ID及原始名稱，參數名稱請自定。下方請再自行填入所需程式碼資訊。
Google 表單資料
第四步驟：進入條件不開啟，行為中的行為形式選擇「開發者進階功能」，選擇功能「外部服務」。Method 設置為 POST 自訂並放入 API URL。下方還可設定 Header、Query string、Body，請依您的情境自行進行設定。此處 Query string 內屬性名稱的值為 Sheet2，請記得自行更換填入您工作表分頁的名稱。
Body 的部分如果是無法用 Key - Value 表達的格式(如下所示)，建議選用自訂。
{ "key-1": "value-1", "key-2": "value-2"}
如何建立 API URL 呢？
我們推薦您一個簡單方便的方法，請先至 SheetDB 註冊帳號。建議您可以將資料整理到 Google 表單中，接著只要將 Google 表單連結貼至 SheetDB 即可轉成 API URL 囉。請注意註冊 SheetDB 的 Google 帳戶與表單的 Google 帳戶需一致。
此外，若您是使用 SheetDB 的免費方案，請注意免費方案可使用次數上限為500次。若超過此次數請自行評估是否需升級成付費方案或改其他廠商。
SheetDB 後台介面
第五步驟：進入條件不開啟，行為中的行為形式選擇「發送訊息」並填寫訊息內容
此流程所呈現的樣子是，當顧客輸入「我要參加抽獎」，機器人會先檢查顧客有沒有「 2019-09-Raffle 」的標籤。如果有此標籤的顧客就會被引導到「參加抽獎 - 登記過了」這個流程。如果沒有此標籤的顧客就會被上「 2019-09-Raffle 」的標籤，而且他的顧客資訊ID及原始名稱會被填入您 API URL 的表單中。最後，機器人會再發送一段文字，告知顧客已加入抽獎名單。
顧客視角
2. 建立流程：參加抽獎 - 登記過了
觸發步驟：進入條件的觸發形式選擇「被其他流程觸發」
第一步驟：進入條件不開啟，行為中的行為形式選擇「發送訊息」並填入訊息內容
此流程所呈現的樣子是，當顧客進入「參加抽獎 - 登記過了」這個流程時，機器人會發送訊息告知顧客請等待抽獎揭曉。
顧客視角
在開獎前，賣家要做的事就是先決定好中獎者。決定中獎者的方式有兩種，一種是直接在您決定好的顧客 hit 欄位中填入 yes 及在 prize 欄位中填入獎品名稱。
另一種是選取要抽獎的所有名單，然後點右鍵，選擇 Randomize range 。選擇後會隨機排列顧客名單，您可自行決定前幾位為中獎者，一樣在顧客 hit 欄位中填入 yes 及在 prize 欄位中填入獎品名稱。
3. 建立流程：參加抽獎 - 公開結果
前置作業：由於此流程的觸發步驟是設置當顧客輸入包含「開獎」，因此建議可以在開獎當天針對有「 2019-09-Raffle 」標籤的人，群發訊息給他們。讓顧客可以直接點選「開獎」，了解中獎資訊。
觸發步驟：進入條件的觸發形式選擇「被顧客傳送內容觸發」，條件選擇當顧客輸入包含「開獎」。此處僅為示範，關鍵字請依您的情境自定義。
第一步驟：進入條件不開啟，行為中的行為形式選擇「開發者進階功能」，選擇「外部服務」，Method 設置為 GET 自訂並放入 API URL。下方還可設定 Header、Query string、Body，請依您的情境自行進行設定。此處屬性名稱「 hit 」自訂 Yes，是表示我們在 API URL 的 Google 表單中，在 hit 欄位用 yes 來標示中獎者。請注意此處的 API URL 後面務必加上 /search，才能正常顯示卡片資料。
Google 表單資料
第二步驟：進入條件不開啟，行為中的行為形式選擇「程式碼」，參數名稱設置result，值選擇從「參加抽獎 - 公開結果 - 查詢結果 - API」這個步驟中來取資料。下方請再自行填入所需程式碼資訊。
第三步驟：開啟「檢查進入條件」，條件設置為當步驟「參加抽獎 - 公開結果 - 查詢結果 - Code」等於 no。行為中的行為形式選擇「發送訊息」並填入訊息內容。
第四步驟：開啟「檢查進入條件」，條件設置為當步驟「參加抽獎 - 公開結果 - 查詢結果 - Code」等於 yes。行為中的行為形式選擇「開發者進階功能」，選擇功能「動態產生卡片訊息」，資料來源選擇步驟回覆「參加抽獎 - 公開結果- 查詢結果 - API 」並填寫選項型卡片內資訊。
此流程所呈現的樣子是，當顧客輸入包含「開獎」時，機器人會去抓取您 API URL 表單中的中獎者資料。如果檢查進入條件等於 no 時，機器人會發訊息告知顧客沒中獎。如果檢查進入條件等於 yes 時，機器人會發送選項型卡片並且把中獎者 name 跟 prize 的欄位資料呈現在卡片中。
以上為此單元教學內容，希望有協助到您！
若有相關問題，歡迎透過 Super 8 平台右下方的「顧客聊天外掛程式」向線上客服專員詢問，服務時間為週一至週五 09:30～13:00，14:00～18:30。
Super 8 雲發互動科技 Messenger：m.me/no8.io
Super 8 雲發互動科技 LINE@：https://line.me/R/ti/p/@im888