【開發工具】開發計劃-快速入門

前言 #

ManyChat應用程序是連接ManyChat和第三方工具的一種方式。

它需要了解以下內容：

• API認證
• API調用
• JSON格式

如果您有開發經驗，則本文和提供的示例可以用作構建第一個ManyChat應用程序的綜合指南。

對於沒有開發經驗的客戶，ManyChat當前不提供任何教育支持，但是您可能會發現以下有用的資源：

• 與郵遞員進行身份驗證和撥打電話
• W3Schools的JSON定義
• JSON路徑查找器

---

讓我們概述一下ManyChat Application的工作方式。應用程序由名稱，描述和JSON組成。

應用程序名稱和應用程序描述是不言自明的，請參考所附的圖像：它顯示了安裝後應用程序名稱如何導入到操作列表中：

JSON是ManyChat應用程序的核心概念，它指定了集成的詳細信息。然後，ManyChat會對此規范進行內省，以找出您的應用程序具有的功能，並將JSON轉換為最終用戶的本機UI元素。

一個典型的應用程序包含：

• auth -如果您將ManyChat連接到的平台需要授權，請設置此阻止並將其指定為 "auth": null
• actions -每個應用程式應至少包含1個動作
• sources-這是可選的。您可以根據需要為操作中使用的變量設置源。

這是ManyChat如何識別動作標題和描述的簡要概述：

讓我們更深入地研究細節，並逐步學習如何開發自己的應用程序。

步驟1：建立應用程式 #

讓我們創建一個簡單的示例應用程序，該應用程序在給定範圍內生成一個隨機數。

檢查以下先決條件：

• https://csrng.net/documentation/csrng-lite/將用作API
• 我們希望最終用戶將使用漫遊器字段指定範圍

請按照以下步驟創建應用：

• 轉到應用程序，然後單擊“ +新應用程序”按鈕
• 完成以下字段：
  • 應用名稱：隨機數應用
  • 應用說明：最佳隨機數生成應用
  • 應用程序JSON（如果您想嘗試該應用程序，請參考Glitch項目-使用app_for_copy.json，因為它不包含註釋，當前的應用程序JSON字段僅接受不帶註釋的JSON ）： 

    

  • 點擊“創建應用程序”按鈕

以下是ManyChat如何導入此數據的一些示例：

表單JSON→表單用戶界面：

通過表單捕獲的數據用於請求：

對應：

步驟2：安裝應用程序 #

• 單擊三點菜單下的“安裝”按鈕
• 選擇您要應用此帳戶並完成安裝。

步驟3：測試應用程序 #

• 轉到“流”構建器，然後在“動作”列表中選擇您的應用
• 設置動作 

• 像下面的例子一樣建立一個新的流程：

• 預覽您的流程：

  

步驟4：與客戶共享應用程序 #

準備好應用程序後，您可以獲取鏈接以共享它。

• 轉到應用程序
• 單擊三點菜單
• 單擊複製鏈接按鈕

鏈接已復製到剪貼板中，可以共享。

仔細共享以下鏈接：

1. 擁有此鏈接的每個人都可以安裝您的應用。此鏈接可以無限次使用。鏈接無法撤消。生成並共享這些鏈接後，即可安裝您的應用。
2. 安裝了您的應用的每個人都會立即收到應用更新。目前，我們僅支持一個版本-‘dev’。因此，當您確定更改兼容且不會中斷流程時，請將更改應用於應用程序JSON。

在我們進行版本控制以獲取更安全的更新時，我們建議創建兩個應用程序：

• 內部-為了測試更新，請勿共享此應用程序的鏈接
• 外部-要在測試後應用更新，請共享此應用程序的鏈接

如何使用身份驗證塊 #

隨機數API不需要API密鑰，但是許多其他API都需要。

為了使用這些API創建連接，您可以設置一個auth塊。

先決條件：

• 在此處創建帳戶： https://tastedive.com/account/api_access
• 在此處查看API文檔：   https://tastedive.com/read/api

讓我們嘗試創建一個需要API密鑰的應用，然後將其用作查詢參數：

這是完整的代碼示例： 

如何使用有效載荷 #

一些API端點需要有效負載。

要使JSON在這些情況下有效，您可以添加payload {}如下所示。有效負載的值可以從傳遞forms [[]]。

在這種情況下，我們在Pipedrive CRM中創建了一條記錄。API端點需要帶有名稱和電子郵件的有效負載。最終用戶配置操作時，他們選擇名稱和電子郵件的自定義字段。然後，ManyChat觸發添加到針對與自定義字段相關聯的每個訂戶值特定的有效負載的操作。

這是Glitch鏈接，請隨時使用此項目作為示例：   

在某些情況下，無需傳遞有效負載的動態值。所以它看起來像這樣：

每次處理動作時，我們都會將相同的有效負載傳遞給指定的URL。

如何使用來源 #

枚舉：靜態 #

因為random-number-app-v1我們使用了用戶通過自定義字段提供的“最小值”和“最大值”字段。

如果我們想提供自己的價值，則可以利用這一sources概念。

請參考故障示例，並檢查forms和sources塊的註釋：

這是ManyChat處理此數據的方式：

枚舉：rpc #

因為similar-to-music-app我們使用自定義字段作為q參數。

使用enum:rpc我們可以提供該API中的音樂家和樂隊的列表。查看此Glitch項目，以了解如何將enum:rpc源添加到您的App：  

這是一個已實現的代碼示例：

摘要 #

1. 瀏覽本文檔和Glitch項目以了解如何使App JSON用於不同目的
2. 單擊“混音以編輯”以使用我們的示例製作自己的應用
3. 複製JSON並將其粘貼到ManyChat應用程序中
4. 安裝您的應用程序以通過自己的集成獲得更多結果
5. 與客戶共享您的應用以贏得榮譽