【Power Automate】Teamsチャット投稿でつまずく時の入力値と条件分岐の直し方

Power AutomateでTeamsのチャット投稿を自動化しようとしたものの、思ったように動かない経験はありませんか。特に、投稿先の指定やメッセージの内容が正しく反映されず、フローがエラーで停止してしまうケースはよくあります。原因の多くは、入力値の指定方法や条件分岐の設定にあります。この記事では、Teamsチャット投稿アクションでつまずきやすいポイントを整理し、具体的な直し方を解説します。基本的な設定から応用的な条件分岐まで、実務で使える知識を身につけてください。

なぜTeamsチャット投稿でつまずくのか

Power AutomateからTeamsへの投稿は、トリガーやアクションの組み合わせによって実現します。しかし、入力値の指定方法が原因で期待通りに動作しないことが多々あります。例えば、動的コンテンツで「ユーザーのメールアドレス」を指定したつもりが、実際には表示名が入っていたり、グループチャットのIDが正しく取得できていなかったりします。また、条件分岐を使う場合、条件式の書き方や値の型が合っていないと、意図した投稿が行われません。特に、TeamsのチャットとチャネルではAPIの仕様が異なるため、それぞれに適したパラメーターを設定する必要があります。このセクションでは、典型的な失敗パターンを整理します。

よくある失敗パターン

• 受信者の指定ミス: 1対1チャットに投稿する場合、受信者にユーザーのプリンシパル名(UPN)やメールアドレスを指定しますが、組織によっては表示名を入れても動作しません。動的コンテンツで「ユーザープリンシパル名」を選択すべきところを「表示名」にしてしまうケースです。
• チャネル投稿のパス誤り: チームとチャネルを指定する際、チームIDとチャネルIDの組み合わせが正しくないとエラーになります。また、チャネル名だけで指定しようとしても動作しません。
• メッセージ内容のフォーマット問題: 改行や特殊文字を含むメッセージを投稿するとき、Power Automateの式(expression)を使わずに直接改行を入れると、JSONのパースエラーになることがあります。
• 権限不足: フローを実行するユーザーがTeamsに投稿する権限を持っていない、またはアプリの同意が不足している場合に発生します。

入力値の直し方:具体的な手順

Teamsチャット投稿アクションの入力値を正しく設定する手順を説明します。以下の手順は、Power Automateのクラウドフローを想定しています。デスクトップフローやプレミアムコネクタの場合は一部異なる場合があります。

1. 1. Teamsコネクタの「チャットまたはチャネルにメッセージを投稿する」アクションを追加する。 既存のフローを編集している場合は、該当アクションをクリックしてプロパティを開きます。
2. 2. 「投稿先」を選択する。 ドロップダウンから「チャット」「チャネル」「会議チャット」のいずれかを選びます。会議チャットは予定表アイテムに関連する場合のみ使えます。
3. 3. 受信者(チャットの場合)またはチーム/チャネル(チャネルの場合)を指定する。 動的コンテンツ一覧から、トリガーや前のアクションで取得した値を選択します。例えば、承認アクションの「承認者メール」を使う場合は、動的コンテンツの「ユーザープリンシパル名」を選んでください。値が正しいかどうかは、フローのテスト実行時に確認できます。
4. 4. 「メッセージ」フィールドに投稿内容を入力する。 プレーンテキストの場合はそのまま入力します。動的な値を含める場合は、式(expression)を使って構築します。改行を入れたい場合は、char(10) を使用します。例: @{concat('1行目', char(10), '2行目')}
5. 5. 「詳細設定」でメッセージの種類を確認する。 「メッセージの種類」は「標準」または「アダプティブカード」から選択できます。「標準」はプレーンテキストまたはHTML、「アダプティブカード」はJSON形式のカードです。特にカードを使う場合は、JSONの構文ミスに注意してください。
6. 6. 「詳細設定」の「重要なフラグ」や「重要度」など必要に応じて設定する。 これらの項目はオプションですが、誤った値を入れるとエラーになることは通常ありません。
7. 7. フローを保存し、テスト実行する。 「テスト」ボタンから「手動」または「自動」を選んで動作確認します。テストの結果、エラーが出た場合は、エラーメッセージを基に修正します。

条件分岐を正しく設定する方法

条件分岐を使って、特定の条件下でのみTeamsに投稿したい場合があります。その際、条件式の書き方に注意しないと、意図した分岐になりません。以下に具体例を交えて説明します。

条件分岐でよくあるミスと修正法

• ミス1: 値の比較に「等しい」を使うべき場面で「次の値を含む」を使う。 「等しい」は完全一致、「次の値を含む」は部分一致です。例えば、ステータスが「承認済み」の場合だけ投稿したいなら「等しい」を選びます。部分一致の場合は「次の値を含む」が適切です。
• ミス2: 動的コンテンツの値が空の場合を考慮していない。 条件分岐の前に「条件」アクションを使って値が空でないことを確認するか、条件式で「空でない」を指定します。
• ミス3: 複数条件をANDやORでつなぐときに括弧を忘れる。 Power Automateの条件式では、括弧を使って優先順位を明示できます。特に3つ以上の条件を組み合わせる場合は、括弧を適切に使ってください。

修正の具体例として、以下のようなフローを考えます。「新しいメールが届いたとき、件名に『緊急』が含まれている場合のみ、Teamsの特定チャネルに投稿する」というシナリオです。この場合、条件アクションで「件名 次の値を含む 緊急」と設定します。もし「等しい」にしてしまうと、件名が完全に「緊急」の場合しか投稿されません。また、件名が空の場合はエラーになる可能性があるため、条件の前に「件名 空でない」という条件を追加すると安全です。

管理者に確認すべき設定

Power AutomateのフローがTeamsに投稿できない場合、テナント全体の設定が原因のこともあります。特に以下の項目を管理者に確認してください。

• Power AutomateとTeamsの統合が許可されているか。 Teams管理センターで「Microsoft Power Platform」の統合が有効になっている必要があります。
• アプリの同意設定。 Power AutomateがGraph APIを使用するための同意がユーザーまたはテナントレベルで承認されているか確認します。
• カスタムコネクタの利用制限。 もしカスタムコネクタを使っている場合、そのコネクタが許可されているかどうか。
• データ損失防止(DLP)ポリシー。 Power AutomateとTeamsのコネクタが同じDLPポリシー内で許可されているか確認します。ビジネスデータとして扱われる場合、コネクタのグループが適切に設定されていないとブロックされます。

これらの設定は一般ユーザーでは変更できないため、IT管理者に依頼して確認してもらってください。

よくある質問(FAQ)

Q1. テスト実行で「無効な要求」エラーが出ます

入力値の型が間違っている可能性が高いです。特に、チャット投稿で受信者に複数のユーザーを指定する場合、配列形式(JSONのリスト)が必要です。動的コンテンツが配列ではない場合は、式で split() を使ってリストに変換します。

Q2. チャネル投稿で「チームが見つかりません」と出ます

チームIDまたはチャネルIDが正しくない可能性があります。チームの取得アクションを使い、チーム名からIDを動的に取得することをお勧めします。静的にIDを指定する場合は、PowerShellなどで事前にIDを調べてください。

Q3. メッセージに改行が反映されません

Power Automateのメッセージフィールドに直接改行を入力しても、JSONに変換されるときに無視されることがあります。代わりに、式ビルダーで concat('行1', char(10), '行2') のように指定してください。

Q4. フローを共有したら動作しなくなりました

フローに使用している接続(Teamsコネクタなど)が共有されていない可能性があります。フロー編集画面で「接続参照」を確認し、正しい接続が設定されているかチェックしてください。また、実行ユーザーに適切な権限が付与されているかも確認します。

まとめ

Power AutomateでTeamsチャット投稿がうまくいかない場合、まずは入力値の指定が正しいか、条件分岐の条件式が意図通りかを見直してください。特に動的コンテンツの選択ミスや、値の型不一致が原因の大半を占めます。また、テナントの設定に問題がある場合は管理者に確認を依頼しましょう。基本的なトラブルシューティング手順を身につければ、フローの開発効率が格段に向上します。今回紹介したポイントを活用して、安定したTeams連携フローを構築してください。