設定 Quire Webhooks 逐步教學

最後更新：2026年7月24日

你有冇試過希望自己嘅應用程式可以自動互相溝通？呢個正正就係webhooks嘅作用！你可以將佢哋想像成信差，一旦你嘅Quire專案有任何動靜——新增任務、有人更新指派、標記任務完成——都會即時通知你嘅伺服器。

喺呢篇教學，我哋會示範點樣設定webhooks，令你嘅應用程式同Quire保持同步，全程毋須你郁手。

點樣開始設定 Quire Webhooks？

第一步：建立你嘅 Quire 應用程式

首先，你需要一個Quire應用程式。如果你仲未設定過，可以參考我哋嘅用Quire API建立Quire應用程式教學，一步步跟住做就得。

第二步：話畀 Quire 知去邊度接收更新

而家係時候喺Quire 開發者應用程式後台設定你嘅webhook接收端點。呢個其實好簡單，就係你想Quire發送通知嘅網址，例如http://myserver/hookhandler。

可以將呢個想像成你將自己嘅通訊地址交畀Quire，等佢知道去邊度送信。

第三步：訂閱更新通知

最後一步就係話畀Quire知你想追蹤邊啲專案或任務。做法就係用Quire API將你嘅應用程式加做「追蹤者」：

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app"]}' \
  https://quire.io/api/project/projectAOid

重要提醒：呢一步之前，一定要確保你已經設定好webhook網址。冇設定好嘅話，將你嘅應用程式加做追蹤者呢個動作就會失敗。

如果你唔再需要接收更新，只需將你嘅應用程式由追蹤者名單移除就得，就係咁簡單！

想知更多細節，可以查閱API參考文件入面嘅按OID更新專案。

Webhooks 幕後究竟點運作？

你會收到啲乜嘢

一切設定好之後，只要你追蹤嘅專案有任何動靜，Quire就會開始向你發送通知。呢啲通知會以POST請求嘅形式送達，內容包裝成一份精簡嘅JSON資料：

{
  "type": "notification",
  "secret": "your-app-secret",
  "data": {
    "type": 0, 
    "when": "2019-09-30T08:20:12.000Z",
    "what": {
      "oid": "YxjapXXRCOYxoaiCT4tT3OQm", 
      "id": 101,
      "name": "Brand new start"
    },
    "user": {
      "oid": "1AbDEFed2A5031BEDDweqmde",
      "id": "john.doer",
      "name": "John Doer"
    },
    "message": "<a href=\"https://quire.io/u/john.doer\">John Doer</a> added <a href=\"https://quire.io/w/MyProjects/101\">Brand new start</a>",
    "text": "John Doer added Brand new start",
    "url": "https://quire.io/w/MyProjects/101"
  } 
}

安全第一：驗證來源

每個webhook都會帶埋你應用程式嘅密鑰。呢個係你用嚟確認訊息真係嚟自Quire，而唔係有人假冒我哋嘅唯一方法。喺處理任何資料之前，一定要先做呢個檢查！

因應唔同事件作出回應

你嘅專案入面會發生唔同嘅事情，你會想針對唔同情況分別處理。以下係一個簡單例子，示範點樣按發生嘅事件作出回應：

switch(json["data"]["type"]) {
  case 0:
    // new task added
    log("New task: " + json["data"]["what"]["name"]);
    break;
  case 1:
    // task removed
    log(json["data"]["user"]["name"] + " deleted " + json["data"]["what"]["name"]);
    break;
}

Quire 會發送邊啲事件類型？

Quire可以通知你各種各樣嘅活動。以下係一啲最常見嘅例子：

想睇完整清單？歡迎瀏覽我哋嘅活動類型文件，睇晒Quire可以話畀你知嘅所有內容。

讓 Quire 知道你已經收到訊息

當你嘅webhook接收到通知，只需要回傳一個成功狀態碼（200至299之間任何一個都得）。呢個就係話畀Quire知：「收到，多謝晒！」

如果過程中出咗差錯，你回傳咗其他狀態碼，都唔使擔心，Quire會分別喺15分鐘後、1小時後，最後喺1日後再嘗試發送通知一次。

想知更多細節，可以參閱API文件入面嘅「回應與重試」。

點樣管理跨多個專案嘅 Webhooks？

同時喺同一部伺服器處理多個Quire專案？我哋為你準備咗兩種靈活嘅做法：

方法一：使用自訂標籤

你可以喺訂閱專案更新嗰陣加一個自訂標籤：

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|handleProjectA"]}' \
  https://quire.io/api/project/projectAOid

Quire會喺每個webhook通知入面帶埋呢個標籤，方便你辨識邊個專案發出嘅通知：

{
  "type": "notification",
  "team": "handleProjectA",
  "data": {
    // event details...
  }
}

咁樣喺你嘅程式碼入面，你就可以按呢個標籤將通知分流處理：

switch(json["data"]["type"]) {
  case 0:
    // new task added
    if (json["team"] == "handleProjectA") {
      log("ProjectA has a new task: " + json["data"]["what"]["name"]);
    }
    break;
}

方法二：使用不同路徑

想將唔同專案分開處理？可以為每個專案設定獨立路徑：

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|/projectAUpdate"]}' \
  https://quire.io/api/project/projectAOid

咁樣，Quire就會將通知送去你主要接收端點下面唔同嘅子路徑（例如http://myserver/hookhandler/projectAUpdate），你就可以用專屬處理程式分別處理每個專案。

邊條係最快嘅第一個Webhook設定路徑？

就係咁簡單！你而家已經識得點樣設定webhooks，令你嘅應用程式同Quire保持完美同步。想睇完整技術文件，可以查閱API參考入面嘅Webhook 章節。

想幫AI助理而唔係自訂伺服器建置？可以睇吓5分鐘設定Quire MCP，直接連接Claude、ChatGPT或任何AI客戶端。

祝你開發順利！

常見問題

乜嘢係Quire webhook？

一種自動化嘅HTTP通知，喺你追蹤嘅專案有任何動靜嗰一刻，Quire就會發送到你指定嘅網址——令你嘅應用程式毋須輪詢查詢都能保持同步。

點樣喺Quire度設定webhook？

先建立一個Quire應用程式，喺開發者應用程式後台註冊你嘅接收端點網址，再透過API將你嘅應用程式加做專案追蹤者。記得喺訂閱之前先設定好網址，否則呼叫就會失敗。

點樣驗證webhook請求真係嚟自Quire？

每個負載都會帶埋你應用程式嘅secret欄位——將佢同你儲存嘅密鑰做比對，如果唔相符就拒絕呢個請求。

如果webhook觸發嗰陣我嘅伺服器落線咗，會點樣？

Quire會重試三次——分別喺15分鐘後、1小時後同1日後。記得一收到負載就盡快回覆2xx狀態，就可以停止後續重試。

點樣喺同一部伺服器處理多個Quire專案嘅webhooks？

你可以喺訂閱嗰陣加一個自訂標籤（例如app|handleProjectA），再按team欄位做路由，又或者喺webhook網址度為每個專案設定獨立子路徑。