FyneDeskの通知をMicrosoft Teamsに送信する

チケットが作成、コメント、またはステータス変更されるたびに、Teamsチャンネルにメッセージを受け取りましょう。FyneDeskがイベントをWebhookに送信し、短いPower AutomateフローがそれをTeamsのメッセージに変換します。以下のステップを順番に進めてください。約10分で完了します。

仕組み

FyneDeskは、各イベント（新しいチケット、新しいコメントなど）を小さなJSONデータパケットとして、指定したURLに送信します。Microsoft Teamsはそのパケットをそれ自体で表示することはありません。Power Automateフローがデータを受け取り、メッセージとして投稿する必要があります。

これが、テストで「正常に送信されました」と表示されるのにTeamsには何も表示されない理由です。Power Automateはリクエストを受け取った瞬間に202 Acceptedと返すため、「成功」はMicrosoftがデータを受信したことを意味するだけです。メッセージが投稿されたかどうかについては何も示しません。パート3で投稿ステップを追加すると、メッセージが表示されます。

始める前に

• 通知を表示したいMicrosoft Teamsのチームとチャンネル、そしてTeamsに投稿できるライセンスを持つPower Automateアカウント。
• FyneDeskのWebhookへの管理者アクセス（管理者設定 → 詳細設定 → Webhook。設定 → 接続 → Webhookからもアクセスできます）。
• 約10分。既製のテンプレートからフローを構築し、そのURLをFyneDeskに貼り付け、メッセージを投稿するステップを1つ追加します。

設定する

これは、私たちのチームが端から端まで使っているとおりの手順です。シンプルで読みやすいテキストメッセージが生成されます。（メッセージに各イベントタイプの名前を付けたい、または書式付きのカードがよいですか? 下記の高度なオプションをご覧ください。）

パート1 — テンプレートからフローを作成する

make.powerautomate.comにアクセスしてサインインします。左メニューでTemplatesを選び、検索ボックスにwebhookと入力し、Send webhook alerts to a channelを開きます。プレーンなもので、「(TEST)」バージョンではありません。Continueをクリックします（求められたら再度サインインします）。

テンプレートは、Teams → Microsoft Teamsを接続し、Webhook URLを生成することを示します。Createをクリックする前に、通知を投稿したいTeamとChannelを設定してください。これは見落としやすく、重要です。

TeamとChannelを選び、Createをクリックします。フローが開いたら、Editをクリックして編集を開始します。

パート2 — URLをFyneDeskに渡す

フローで、最初のボックス「When a Teams webhook request is received」をクリックし、表示されるHTTP URLをコピーします。

次に、FyneDeskで管理者設定 → 詳細設定 → Webhookに移動し、Webhookを追加をクリックします:

• 後で識別できる名前を付けます（例: Microsoft Teams）。
• Power AutomateのURLをエンドポイントURLに貼り付けます（HTTPSリンクである必要があります）。
• ticket.createdのチェックを入れたままにします。始めるにはこれだけで十分です。（後でイベントを追加できます。）
• 保存をクリックします。

パート3 — 何を投稿するかをフローに指定する

これが見落としやすいステップです。そして、これこそがテストで「送信されました」と表示されるのにTeamsには何も表示されない理由です。

1. あらかじめ作られた2つのステップを削除します。 テンプレートはInitialize variableアクション（場合によっては2つ）とAttachments is null条件を追加します。両方を削除します。各ステップの…をクリックし、Deleteを選びます。これらを残しておくと、「AdaptiveCard」エラーがトリガーされます。

2. 投稿アクションを追加します。 トリガーの下の+をクリックし、Post message in a chat or channel（Microsoft Teamsコネクタ）を選びます。ドロップダウンを設定します:

3. メッセージを構築します。 Messageボックス内をクリックし、青いfx（Insert expression）ボタンをクリックし、下記の式をそのまま貼り付け、Addをクリックします。

concat('New ticket ', triggerBody()?['data']?['ticket_number'], ' - ', triggerBody()?['data']?['title'], ' | Status: ', triggerBody()?['data']?['status'], ' | Priority: ', triggerBody()?['data']?['priority'], ' | https://fynedesk.ai/tickets/', string(triggerBody()?['data']?['id']))

4. 保存します。 Save（右上）をクリックします。「Your flow is ready to go.」と表示されるはずです。

パート4 — テスト

FyneDeskで実際のチケットを作成または更新します。数秒以内にTeamsチャンネルにメッセージが表示されます。

任意: すべてのイベントにラベルを付ける、またはカードを投稿する

上記の式は常に「New ticket」で始まります。メッセージにイベント名（新しいコメント、ステータス変更など）を付けたい場合や、書式付きのカードがよい場合は、以下のオプションのいずれかを使います。設定は同じで、Message式だけが変わります。

FyneDeskが送信する内容

Webhookは4つのイベントを購読できます。各パケットの形は次のとおりです（値は例です）。

ticket.created

{
  "event": "ticket.created",
  "timestamp": "2026-05-30T22:19:59",
  "organization": { "id": 173, "name": "SafePACS" },
  "data": {
    "id": 6381,
    "ticket_number": "INC004736",
    "title": "Printer not working",
    "description": "The 3rd floor printer is offline",
    "status": "New",
    "priority": "Medium",
    "ticket_type": "Incident",
    "source": "Email",
    "created_at": "2026-05-30T22:19:59"
  }
}

ticket.updatedとticket.status_changedは、上記と同じ形に加えて、updated_at、assigned_to、assigned_team_idを使用します。

ticket.commented — ここではフィールド名がわずかに異なることに注意してください:

{
  "event": "ticket.commented",
  "timestamp": "2026-05-30T22:19:59",
  "organization": { "id": 173, "name": "SafePACS" },
  "data": {
    "ticket_id": 6381,
    "ticket_number": "INC004736",
    "ticket_title": "Printer not working",
    "ticket_status": "New",
    "content": "Any update on this?",
    "comment_id": 8809,
    "is_internal": false
  }
}

オプションA — より充実したテキストメッセージ

単一の式の代わりに、以下のレイアウトをMessageボックスに入力します。〈プレースホルダー〉でないものはすべて、自分で入力するプレーンテキストです。各〈プレースホルダー〉について、fxボタンをクリックし、表から対応する式を貼り付け、Addをクリックします。

〈eventLabel〉  〈ticketNumber〉
〈title〉

Status: 〈status〉   •   Priority: 〈priority〉

〈message〉

Open in FyneDesk: 〈link〉

オプションB — 書式付きのカード

カードがよいですか? アクションPost card in a chat or channelを使い、以下をAdaptive Cardフィールドに貼り付けます。同じ式を使うため、同じデータをより整ったレイアウトで表示できます。

{
  "type": "AdaptiveCard",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.2",
  "body": [
    {
      "type": "TextBlock",
      "size": "Medium",
      "weight": "Bolder",
      "text": "@{if(equals(triggerBody()?['event'],'ticket.created'),'🎫 New ticket',if(equals(triggerBody()?['event'],'ticket.commented'),'💬 New comment',if(equals(triggerBody()?['event'],'ticket.status_changed'),'🔄 Status changed','✏️ Ticket updated')))} @{triggerBody()?['data']?['ticket_number']}"
    },
    {
      "type": "TextBlock",
      "text": "@{coalesce(triggerBody()?['data']?['title'],triggerBody()?['data']?['ticket_title'],'(no title)')}",
      "wrap": true
    },
    {
      "type": "FactSet",
      "facts": [
        { "title": "Status", "value": "@{coalesce(triggerBody()?['data']?['status'],triggerBody()?['data']?['ticket_status'],'-')}" },
        { "title": "Priority", "value": "@{coalesce(triggerBody()?['data']?['priority'],'-')}" }
      ]
    },
    {
      "type": "TextBlock",
      "text": "@{coalesce(triggerBody()?['data']?['content'],triggerBody()?['data']?['description'],'')}",
      "wrap": true
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "Open in FyneDesk",
      "url": "@{concat('https://fynedesk.ai/',if(equals(triggerBody()?['data']?['ticket_type'],'Service Request'),'requests/','tickets/'),string(coalesce(triggerBody()?['data']?['id'],triggerBody()?['data']?['ticket_id'])))}"
    }
  ]
}

トラブルシューティング

セキュリティについての注記

Power AutomateのURLには秘密の署名（sig=...の部分）が含まれています。URL全体をパスワードのように扱い、共有しないでください。FyneDeskは、フロー内で信頼性を検証したい場合に備えて、すべてのリクエストにX-FyneDesk-Signatureヘッダー（HMAC-SHA256）で署名します。ただしこれは任意であり、メッセージを流すために必須ではありません。

よくある質問