Quire Webhook 設定完全ガイド:ステップバイステップで解説

最終更新日：2026年7月24日

アプリ同士が自動的にやり取りできたらいいのに、と思ったことはありませんか？それこそがwebhookの役割です。新しいタスクの作成、担当者の変更、タスクの完了マークなど、Quireプロジェクトで何かが起きた瞬間にサーバーへ知らせてくれる伝令だと考えてください。

このガイドでは、アプリをQuireと同期させ続けるためのwebhook設定方法を、手間をかけずに実現する手順で紹介します。

Quire Webhookはどうやって始めればいい？

ステップ1:Quireアプリを作成する

まず必要になるのはQuireアプリです。まだ用意していない場合は、Quire APIでQuireアプリを作成するガイドを参照してください。手順を一通り説明しています。

ステップ2:更新の送信先をQuireに伝える

次はQuire開発者アプリポータルで、webhookのエンドポイントを設定します。これは単に、Quireに通知を送ってほしいWebアドレス、たとえばhttp://myserver/hookhandlerのようなものです。

いわば、Quireに自分の郵送先住所を教えて、どこにニュースを届ければいいか分かるようにするようなものです。

ステップ3:更新を購読する

最後の設定ステップは、フォローしたいプロジェクトやタスクをQuireに伝えることです。これはQuire APIを使い、自分のアプリを「フォロワー」として追加することで行います。

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

重要な注意点:このステップの前に、必ずwebhook URLを設定しておいてください。設定していないと、アプリをフォロワーとして追加しても機能しません。

更新が不要になったら、フォロワーリストからアプリを削除するだけです。とても簡単です。

詳細については、APIリファレンスのOIDによるプロジェクトの更新をご覧ください。

Webhookは裏側でどう動いているの？

受け取る内容

すべての設定が完了すると、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ドキュメントの「Responding and Retries」をご覧ください。

複数プロジェクトのWebhookはどう管理すればいい？

同じサーバーで複数のQuireプロジェクトを扱っていますか？柔軟な方法を2つ紹介します。

方法1:カスタムラベルを使う

プロジェクトの更新を購読する際に、カスタムラベルを追加できます。

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;
}

方法2:異なるパスを使う

分けて管理したい場合は、プロジェクトごとに専用のパスを設定します。

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

こうすることで、Quireはメインのエンドポイントの異なるサブパス（例:http://myserver/hookhandler/projectAUpdate）に通知を送るようになり、各プロジェクトを専用のハンドラーで処理できます。

Webhookを最短で使い始めるには？

以上で完了です！これでwebhookを設定し、アプリをQuireと完璧に同期させ続ける方法が分かりました。技術ドキュメントの全体像については、APIリファレンスのWebhookセクションをご覧ください。

独自サーバーではなくAIアシスタント向けに構築していますか？5分でできるQuire MCPセットアップで、Claude、ChatGPT、その他のAIクライアントを直接接続する方法を確認してください。

楽しい開発を！

よくある質問

Quire Webhookとは何ですか？

フォロー中のプロジェクトで何かが起きた瞬間に、自分で指定したURLへQuireが自動的に送信するHTTP通知です。これにより、ポーリングなしでアプリをQuireと同期し続けられます。

Quireでwebhookを設定するにはどうすればいいですか？

Quireアプリを作成し、Quire開発者アプリポータルでエンドポイントURLを登録した後、APIを使って自分のアプリをプロジェクトのフォロワーとして追加します。購読前にURLを設定しておかないと、呼び出しが失敗します。

webhookリクエストが本当にQuireから送られたものかを確認するにはどうすればいいですか？

すべてのペイロードにはアプリのsecretフィールドが含まれています。これを保存済みのシークレットと照合し、一致しないリクエストはすべて拒否してください。

webhookが発火した時にサーバーがダウンしていたらどうなりますか？

Quireは15分後、1時間後、1日後の3回にわたって通知を再送します。ペイロードを受信したらすぐに2xxステータスを返せば、以降のリトライは止まります。

1台のサーバーで複数のQuireプロジェクトのwebhookを扱うにはどうすればいいですか？

購読時にカスタムラベル（例:app|handleProjectA）を付けてteamフィールドでルーティングするか、各プロジェクトにwebhook URLの専用サブパスを割り当ててください。