webhook

Webhook 是一種可用於擷取及儲存特定事件之資料的工具，可讓您註冊 https:// URL，您的事件資料就能以 JSON 或 XML 格式儲存在此。Webhooks 通常可用於：

• 提交訂單
• 變更產品價格
• 在您處於離線狀態時通知您的即時通訊 (IM) 客戶端或傳呼機
• 為資料倉儲收集數據資料
• 整合會計帳務軟體
• 篩選訂單項目，並向各個託運人傳送訂單通知
• 當客戶取消安裝您的 App 時，從資料庫中移除客戶資料

備註

若 Webhook 傳送失敗，系統會寄一封電子郵件到商店擁有人的電子郵件地址。只有當 Webhook 是由來自 Shopify App Store 的應用程式或自訂應用程式建立，系統才會傳送電子郵件。若 Webhook 目的地不斷回傳「non-200」狀態回應，則系統將自動從 Shopify 管理介面刪除 Webhook 訂閱。

建立 Webhook

步驟：

電腦版

1. 在 Shopify 管理介面 中，前往「設定」>「通知」。
2. 向下捲動至「Webhook」區段。
3. 按一下「建立 Webhook」按鈕。畫面中隨即會顯示一個新視窗。

4. 在第一個下拉式選單中，從下列清單中選擇「事件」：

   • 建立購物車：在每次建立購物車時傳送 Webhook。
   • 更新購物車：在每次更新購物車時傳送 Webhook。
   • 建立結帳作業：在每次建立結帳作業時傳送 Webhook。
   • 刪除結帳作業：在每次刪除結帳作業時傳送 Webhook。
   • 更新結帳作業：在每次更新結帳作業時傳送 Webhook。
   • 建立產品系列：在每次建立產品系列時傳送 Webhook。
   • 刪除產品系列：在每次刪除產品系列時傳送 Webhook。
   • 更新產品系列：在每次更新產品系列時傳送 Webhook。
   • 建立客戶群組：在每次建立客戶群組時傳送 Webhook。
   • 刪除客戶群組：在每次刪除客戶群組時傳送 Webhook。
   • 更新客戶群組：在每次更新客戶群組時傳送 Webhook。
   • 建立客戶：在每次建立新客戶時傳送 Webhook。
   • 刪除客戶：在每次刪除客戶記錄時傳送 Webhook。
   • 停用客戶：在每次停用顧客帳號時傳送 Webhook。
   • 啟用客戶：在每次啟用顧客帳號時傳送 Webhook。
   • 更新客戶：在每次更新客戶記錄時傳送 Webhook。
   • 建立訂單草稿：在每次建立訂單草稿時傳送 Webhook。
   • 刪除訂單草稿：在每次刪除訂單草稿時傳送 Webhook。
   • 更新訂單草稿：在每次更新訂單草稿時傳送 Webhook。
   • 建立訂單出貨作業：在每次為訂單建立訂單出貨作業時傳送 Webhook。
   • 更新訂單出貨作業：在每次為訂單更新訂單出貨作業時傳送 Webhook。
   • 訂單取消：在每次取消訂單時傳送 Webhook。
   • 建立訂單：在每次建立訂單時傳送 Webhook。
   • 刪除訂單：在每次刪除訂單時傳送 Webhook。
   • 訂單編輯：在每次編輯訂單時傳送 Webhook。
   • 出貨訂單：在每次出貨訂單時傳送 Webhook。
   • 支付訂單：在每次支付訂單款項時傳送 Webhook。
   • 更新訂單：在每次更新訂單時傳送 Webhook。
   • 建立產品：在每次建立產品時傳送 Webhook。
   • 刪除產品：在每次刪除產品時傳送 Webhook。
   • 更新產品：在每次更新產品時傳送 Webhook。
   • 建立退款：在每次核發退款時傳送 Webhook。
   • 商店更新：在每次更新商店屬性時傳送 Webhook。
   • 建立佈景主題：在每次建立佈景主題時傳送 Webhook。
   • 刪除佈景主題：在每次刪除佈景主題時傳送 Webhook。
   • 佈景主題更新：在每次更新佈景主題屬性時傳送 Webhook。

5. 在第二個下拉式選單中，選擇您想要 Shopify 用來傳送此資訊給您的格式。您可以選擇 JSON 或 XML 這兩種格式。

6. 在「網址」下方，輸入您想要用來儲存資料的網址。請務必注意，Webhook 無法回傳下列網址：

   • 本地主機
   • 任何以「internal」結尾的 URL (亦即：thisshop.com/internal)
   • 從任一自訂網域連結至此商店的網址
   • 假冒的網域 (例如：www.example.com)
   • Shopify 網域 (亦即：shopify.com 與 myshopify.com)

7. 按一下「新增 Webhook」。您的 Webhook 隨即會顯示於「Webhook」區段中。

8. 此外，您還可以對 Webhook 進行測試，以確認您所需的資訊會傳送至正確的 URL。若要執行此動作，請按一下「傳送測試通知」連結。確認您所指定的 URL 是否有效。

iPhone

1. 在 Shopify 應用程式中，點選「…」按鈕和「設定」。
2. 在「商店設定」區段中，點選「通知」。
3. 向下捲動至「Webhook」區段。
4. 按一下「建立 Webhook」按鈕。畫面中隨即會顯示一個新視窗。

5. 在第一個下拉式選單中，從下列清單中選擇「事件」：

   • 建立購物車：在每次建立購物車時傳送 Webhook。
   • 更新購物車：在每次更新購物車時傳送 Webhook。
   • 建立結帳作業：在每次建立結帳作業時傳送 Webhook。
   • 刪除結帳作業：在每次刪除結帳作業時傳送 Webhook。
   • 更新結帳作業：在每次更新結帳作業時傳送 Webhook。
   • 建立產品系列：在每次建立產品系列時傳送 Webhook。
   • 刪除產品系列：在每次刪除產品系列時傳送 Webhook。
   • 更新產品系列：在每次更新產品系列時傳送 Webhook。
   • 建立客戶群組：在每次建立客戶群組時傳送 Webhook。
   • 刪除客戶群組：在每次刪除客戶群組時傳送 Webhook。
   • 更新客戶群組：在每次更新客戶群組時傳送 Webhook。
   • 建立客戶：在每次建立新客戶時傳送 Webhook。
   • 刪除客戶：在每次刪除客戶記錄時傳送 Webhook。
   • 停用客戶：在每次停用顧客帳號時傳送 Webhook。
   • 啟用客戶：在每次啟用顧客帳號時傳送 Webhook。
   • 更新客戶：在每次更新客戶記錄時傳送 Webhook。
   • 建立訂單草稿：在每次建立訂單草稿時傳送 Webhook。
   • 刪除訂單草稿：在每次刪除訂單草稿時傳送 Webhook。
   • 更新訂單草稿：在每次更新訂單草稿時傳送 Webhook。
   • 建立訂單出貨作業：在每次為訂單建立訂單出貨作業時傳送 Webhook。
   • 更新訂單出貨作業：在每次為訂單更新訂單出貨作業時傳送 Webhook。
   • 訂單取消：在每次取消訂單時傳送 Webhook。
   • 建立訂單：在每次建立訂單時傳送 Webhook。
   • 刪除訂單：在每次刪除訂單時傳送 Webhook。
   • 訂單編輯：在每次編輯訂單時傳送 Webhook。
   • 出貨訂單：在每次出貨訂單時傳送 Webhook。
   • 支付訂單：在每次支付訂單款項時傳送 Webhook。
   • 更新訂單：在每次更新訂單時傳送 Webhook。
   • 建立產品：在每次建立產品時傳送 Webhook。
   • 刪除產品：在每次刪除產品時傳送 Webhook。
   • 更新產品：在每次更新產品時傳送 Webhook。
   • 建立退款：在每次核發退款時傳送 Webhook。
   • 商店更新：在每次更新商店屬性時傳送 Webhook。
   • 建立佈景主題：在每次建立佈景主題時傳送 Webhook。
   • 刪除佈景主題：在每次刪除佈景主題時傳送 Webhook。
   • 佈景主題更新：在每次更新佈景主題屬性時傳送 Webhook。

6. 在第二個下拉式選單中，選擇您想要 Shopify 用來傳送此資訊給您的格式。您可以選擇 JSON 或 XML 這兩種格式。

7. 在「網址」下方，輸入您想要用來儲存資料的網址。請務必注意，Webhook 無法回傳下列網址：

   • 本地主機
   • 任何以「internal」結尾的 URL (亦即：thisshop.com/internal)
   • 從任一自訂網域連結至此商店的網址
   • 假冒的網域 (例如：www.example.com)
   • Shopify 網域 (亦即：shopify.com 與 myshopify.com)

8. 按一下「新增 Webhook」。您的 Webhook 隨即會顯示於「Webhook」區段中。

9. 此外，您還可以對 Webhook 進行測試，以確認您所需的資訊會傳送至正確的 URL。若要執行此動作，請按一下「傳送測試通知」連結。確認您所指定的 URL 是否有效。

Android

1. 在 Shopify 應用程式中，點選「…」按鈕和「設定」。
2. 在「商店設定」區段中，點選「通知」。
3. 向下捲動至「Webhook」區段。
4. 按一下「建立 Webhook」按鈕。畫面中隨即會顯示一個新視窗。

5. 在第一個下拉式選單中，從下列清單中選擇「事件」：

   • 建立購物車：在每次建立購物車時傳送 Webhook。
   • 更新購物車：在每次更新購物車時傳送 Webhook。
   • 建立結帳作業：在每次建立結帳作業時傳送 Webhook。
   • 刪除結帳作業：在每次刪除結帳作業時傳送 Webhook。
   • 更新結帳作業：在每次更新結帳作業時傳送 Webhook。
   • 建立產品系列：在每次建立產品系列時傳送 Webhook。
   • 刪除產品系列：在每次刪除產品系列時傳送 Webhook。
   • 更新產品系列：在每次更新產品系列時傳送 Webhook。
   • 建立客戶群組：在每次建立客戶群組時傳送 Webhook。
   • 刪除客戶群組：在每次刪除客戶群組時傳送 Webhook。
   • 更新客戶群組：在每次更新客戶群組時傳送 Webhook。
   • 建立客戶：在每次建立新客戶時傳送 Webhook。
   • 刪除客戶：在每次刪除客戶記錄時傳送 Webhook。
   • 停用客戶：在每次停用顧客帳號時傳送 Webhook。
   • 啟用客戶：在每次啟用顧客帳號時傳送 Webhook。
   • 更新客戶：在每次更新客戶記錄時傳送 Webhook。
   • 建立訂單草稿：在每次建立訂單草稿時傳送 Webhook。
   • 刪除訂單草稿：在每次刪除訂單草稿時傳送 Webhook。
   • 更新訂單草稿：在每次更新訂單草稿時傳送 Webhook。
   • 建立訂單出貨作業：在每次為訂單建立訂單出貨作業時傳送 Webhook。
   • 更新訂單出貨作業：在每次為訂單更新訂單出貨作業時傳送 Webhook。
   • 訂單取消：在每次取消訂單時傳送 Webhook。
   • 建立訂單：在每次建立訂單時傳送 Webhook。
   • 刪除訂單：在每次刪除訂單時傳送 Webhook。
   • 訂單編輯：在每次編輯訂單時傳送 Webhook。
   • 出貨訂單：在每次出貨訂單時傳送 Webhook。
   • 支付訂單：在每次支付訂單款項時傳送 Webhook。
   • 更新訂單：在每次更新訂單時傳送 Webhook。
   • 建立產品：在每次建立產品時傳送 Webhook。
   • 刪除產品：在每次刪除產品時傳送 Webhook。
   • 更新產品：在每次更新產品時傳送 Webhook。
   • 建立退款：在每次核發退款時傳送 Webhook。
   • 商店更新：在每次更新商店屬性時傳送 Webhook。
   • 建立佈景主題：在每次建立佈景主題時傳送 Webhook。
   • 刪除佈景主題：在每次刪除佈景主題時傳送 Webhook。
   • 佈景主題更新：在每次更新佈景主題屬性時傳送 Webhook。

6. 在第二個下拉式選單中，選擇您想要 Shopify 用來傳送此資訊給您的格式。您可以選擇 JSON 或 XML 這兩種格式。

7. 在「網址」下方，輸入您想要用來儲存資料的網址。請務必注意，Webhook 無法回傳下列網址：

   • 本地主機
   • 任何以「internal」結尾的 URL (亦即：thisshop.com/internal)
   • 從任一自訂網域連結至此商店的網址
   • 假冒的網域 (例如：www.example.com)
   • Shopify 網域 (亦即：shopify.com 與 myshopify.com)

8. 按一下「新增 Webhook」。您的 Webhook 隨即會顯示於「Webhook」區段中。

9. 此外，您還可以對 Webhook 進行測試，以確認您所需的資訊會傳送至正確的 URL。若要執行此動作，請按一下「傳送測試通知」連結。確認您所指定的 URL 是否有效。

刪除 Webhook

步驟：

電腦版

1. 在 Shopify 管理介面 中，前往「設定」>「通知」。
2. 向下捲動至「Webhook」區段。
3. 在您建立的 Webhook 旁會有一個垃圾桶圖示。
4. 按一下垃圾桶圖示，即可刪除 Webhook。

iPhone

1. 在 Shopify 應用程式中，點選「…」按鈕和「設定」。
2. 在「商店設定」區段中，點選「通知」。
3. 向下捲動至「Webhook」區段。
4. 在您建立的 Webhook 旁會有一個垃圾桶圖示。
5. 按一下垃圾桶圖示，即可刪除 Webhook。

Android

1. 在 Shopify 應用程式中，點選「…」按鈕和「設定」。
2. 在「商店設定」區段中，點選「通知」。
3. 向下捲動至「Webhook」區段。
4. 在您建立的 Webhook 旁會有一個垃圾桶圖示。
5. 按一下垃圾桶圖示，即可刪除 Webhook。

備註

若 Webhook 目的地不斷回傳「non-200」狀態回應，則系統將自動從 Shopify 管理介面刪除 Webhook 訂閱。