Webhook を接続する

まずは動画で確認

必要なもの

• https:// で始まる、JSON の POST を受け付けるアドレス。ほとんどの自動化ツールで発行できます（例を参照）。
• UAT Studio ワークスペースの管理者権限。

Webhook を接続する

2

UAT Studio で Webhook を追加する

ワークスペースを開いて Connections をクリックし、Add a connection で Webhook を選び、Add をクリックします。続いて次の項目を入力します。

• Webhook address：手順 1 のアドレス。
• Send automatically：
  • Only when I click Send on an issue（既定）：どの課題を送信するかは管理者が決めます。
  • Every new issue and every status change, by itself：すべてがすぐに送信されます。

Save settings をクリックします。Send automatically の選択は、変更した時点で保存されます。

{ "event": "test", "message": "Test message from UAT Studio" }

送信のタイミング

重複として別の課題に統合された課題では、新たな issue.created は送信されません。

送信される内容

Content-Type: application/json の POST です。課題のイベントはすべて同じ形式です。

{
  "event": "issue.status_changed",
  "project": { "id": "6b1f…", "name": "CRM UAT" },
  "issue": {
    "id": "a41c…",
    "key": "ISS-012",
    "title": "Save button greyed out",
    "description": "After changing the phone number, Save stays grey.",
    "severity": "High",
    "priority": "High",
    "status": "Ready for retest",
    "assignee": "Dev team",
    "ticket": "PORTAL-41",
    "ticket_url": "https://acme.atlassian.net/browse/PORTAL-41"
  },
  "test_case": { "num": 4, "title": "Edit a contact", "step": 3 },
  "reported_by": "Tess Tester",
  "from": "In progress",
  "to": "Ready for retest",
  "url": "https://app.uat.studio/p/6b1f…/issues"
}

フィールドは null になることがあり、今後フィールドが追加される可能性もあるため、フローでは未知の項目を無視するようにしてください。スクリーンショットとファイルは送信されず、UAT Studio 内に残ります。

受信側を作成する

Power Automate

1. トリガー When an HTTP request is received を使った Instant cloud flow を、Anyone 向けに作成します。
2. Request Body JSON Schema で Use sample payload to generate schema をクリックし、上の例を貼り付けます。
3. event に対する Condition（例：test と等しくない）を追加し、その後に必要なアクションを追加します。Planner のタスク、Excel の行、メール、SharePoint のアイテムなどです。
4. フローを保存します。トリガーに HTTP URL が表示されます。これが Webhook アドレスです。

注意：HTTP トリガーは Power Automate のプレミアムコネクタです。Teams チャネルへの投稿には不要なので、Microsoft Teams 接続をお使いください。

Zapier

トリガー Webhooks by Zapier › Catch Hook で Zap を作成し、アドレスをコピーします。UAT Studio で Test connection をクリックしてから課題を 1 件送信し、Zapier にフィールドを認識させます。その後、Slack へのメッセージなど必要なアクションを追加します。

Make

Webhooks › Custom webhook でシナリオを開始し、アドレスをコピーします。UAT Studio から課題を送信する前に Redetermine data structure をクリックします。

自社のサービス

JSON の POST を受け付け、Authorization ヘッダーをシークレットと照合し、すぐに 200 を返して、時間のかかる処理はその後で行います。失敗してもメッセージは再送されないため、受信した内容はログに記録してください。

うまくいかないとき

それでも解決しない場合は、表示されたメッセージを添えて [email protected] までメールでご連絡ください。シークレットそのものは絶対に送らないでください。

UAT Studio から送信されるもの

• メッセージは HTTPS でのみ送信されます。
• 含まれるのは課題のテキスト、テスト、テスターの名前だけで、ファイルやスクリーンショットは含まれません。これらの情報を預けてよいと組織が認めたサービスにだけ送信してください。
• シークレットは暗号化（AES-256）して保存され、鍵はデータベースとは別に保管されます。誰も読み出すことはできません。
• 接続を Off にするか削除すれば、以後は何も送信されません。