## 這是什麼 一個簡單的集成，將您的 Aftership 帳戶與您的 Botpress 機器人。實時跟蹤發貨情況，並在發生更新時直接通過機器人通知使用者。 ## 運作方式 啟用集成后，一個 Webhook 使用提供的「API 金鑰」為您的 Aftership 帳戶設定訂閱。這 webhook 每當貨件的跟蹤狀態發生重大變化時，都會向集成發送更新。 “追蹤貨件”操作可用於啟動貨件追蹤。它需要一個「跟蹤號」，並利用 Aftership 的 API 來獲取和監控貨件狀態，在跟蹤數據中嵌入一個唯一的「對話 ID」。然後，此ID用於觸發對話中的“Aftership 事件”，使機器人能夠回應運輸更新。 “對話 ID”是每個對話的唯一標識符。您可以將「傳遞到此欄位中以嵌入您的 ID。收到 Aftership 更新時，您可以在“Aftership 事件觸發器”的高級選項“對話 ID”字段中使用“”。這會將更新定向到相應的對話。 您可以在 Simply Great Bots Git 頁面查看完整的集成代碼：[Aftership Repo]（https://github.com/SimplyGreatBots/aftership） ### Aftership 設置 #### 先決條件 您必須擁有 Aftership Pro 計劃或更高版本才能獲得 webhook 用於跟蹤的事件。 #### 獲取 API 金鑰 1. 進入 [Aftership Admin Dashboard]（https://admin.aftership.com/）。 2. 導航到「開發人員」->」API 金鑰“。 3. 按兩下「建立 API 金鑰」，命名您的金鑰，然後選擇「儲存」。 4. 將您的 API 金鑰複製並貼到安全的地方，您將在 Botpress 設置。 #### Webhook 和秘密 1. 導航到 [跟蹤儀錶板 -> 通知 -> Webhook]（https://admin.aftership.com/notifications/webhooks#）。 2. 複製你的 Webhook 秘密並將其粘貼到安全的地方。您將在 Botpress 設置。 3. 點擊“添加” Webhook`. 4. 將 webhook version 設置為預設的“Legacy”。 5. 粘貼 Webhook URL 來自您的 Botpress Aftership 集成到”Webhook URL“欄位。 6. 保存 webhook 設置。 ### Botpress 設置 1. 將您的 Aftership API 金鑰從 Aftership 設定中複製並粘貼到“API 金鑰”字段中。 2. 複製並貼上您的Webhook Secret“從 Aftership 設置中進入您的”Secret“字段。
