【Salesforce】Teams連携の通知が来ない時の接続アプリと通知条件の見直し

SalesforceとMicrosoft Teamsの連携機能を活用すると、Salesforce内のレコード変更や承認依頼などをTeamsチャネルに通知できます。しかし、設定が正しく行われているにもかかわらず通知が届かないというトラブルは少なくありません。その原因の多くは「接続アプリの設定不備」または「通知条件の誤り」にあります。本記事では、通知が来ない場合の切り分け手順と、接続アプリおよび通知条件の見直し方法を詳しく解説します。設定の再確認から管理者への報告まで、実務で役立つ情報をまとめました。

1. 通知が来ない主な原因:接続アプリと通知条件の二大要素

SalesforceとTeamsの連携で通知が届かない場合、根本的な原因は「接続アプリ」と「通知条件」の二つに集約されます。接続アプリはSalesforceとTeamsの橋渡し役であり、OAuth認証やWebhook URLの設定が正しく行われていないと通信が成立しません。一方、通知条件とは「どのようなイベントを、どのTeamsチャネルに通知するか」を定義するルールです。この条件が適切に設定されていないと、イベントが発生しても通知が発行されません。これら二つを切り分けることが問題解決の近道です。

1.1 接続アプリの設定ミス

接続アプリでよくある設定ミスとしては、OAuthスコープの不足、アクティブ状態でない、Webhook URLの誤入力などが挙げられます。特にOAuthスコープが適切でないと、SalesforceからTeamsにデータを送信する権限が不足します。また、接続アプリが「アクティブ」になっていないと、通信自体が拒否されます。Webhook URLはTeamsのチャネルコネクタで発行された一意のURLであり、コピーミスが発生しやすいポイントです。

1.2 通知条件の設定ミス

通知条件は、例えば「承認申請が作成されたら」「レコードが更新されたら」などのトリガーと、送信先のTeamsチャネルを指定します。設定ミスの代表例は、条件が「有効」になっていない、送信先チャネルが正しく指定されていない、フィルタ条件が厳しすぎて該当するイベントが一つもない、などです。また、通知条件はプロファイルや権限によって作成・編集できるユーザが制限されている場合があります。

1.3 その他の要因(権限、ブラウザキャッシュなど)

上記の他に、ユーザのSalesforceライセンスやプロファイルで「Teams連携」が許可されていない、あるいはTeams側で会社のポリシーにより外部コネクタがブロックされている場合もあります。また、稀にブラウザのキャッシュが古い情報を保持していて、設定変更が反映されていないこともあります。

2. 接続アプリの設定を確認する手順

以下は、システム管理者が接続アプリの設定を確認・修正する手順です。一般ユーザでは変更できないため、管理者に依頼するか、自分が管理者の場合は次の手順を実行してください。

1. Salesforceにシステム管理者としてログインし、右上の歯車アイコンから「設定」を開きます。
2. 左メニューの「プラットフォームツール」→「アプリケーション」→「接続アプリ」→「管理接続アプリ」を選択します。
3. 一覧からTeams連携用の接続アプリ(例:「Microsoft Teams Integration」)をクリックします。
4. 「OAuthポリシー」タブで、許可されているスコープに「API」や「Refresh Token」など必要な権限が含まれているか確認します。不足があれば「編集」から追加します。
5. 「接続アプリの詳細」セクションで「アクティブ」チェックボックスがオンになっていることを確認します。オフの場合はオンに変更します。
6. 「Webhook URL」がTeamsのチャネルコネクタ設定で発行されたURLと完全に一致しているか確認します。不一致があれば修正します。
7. 最後に「保存」をクリックし、設定を反映します。その後、一度Teamsのチャネルコネクタを削除して再作成し、新しいWebhook URLを設定することを推奨します。

3. 通知条件の設定を見直す手順

3.1 通知条件の種類と設定内容の比較表

通知条件にはいくつかの種類があり、それぞれ設定場所や内容が異なります。以下の表で代表的なものを比較します。

通知の種類	設定場所	設定内容例
承認リクエスト	承認プロセス設定内の「Teams通知」	承認申請が作成されたら特定チャネルに通知
レコード変更	リストビューやトリガ、フロー	商談のステージが変更されたら通知
Chatter投稿	Chatterグループの「Teams連携」	特定グループに投稿があったら通知
カスタム項目の更新	プロセスビルダーまたはフロー	顧客満足度スコアが一定値以下なら通知

3.2 通知条件の詳細確認手順

通知条件の設定を確認するには、以下の手順で各機能の設定画面を開きます。

1. Salesforce「設定」→「プロセスオートメーション」→「プロセスビルダー」を開き、Teams通知に関連するプロセスを探します(フローを使用している場合は「フロー」を開きます)。
2. 該当するプロセスを選択し、「条件」タブでトリガー条件が適切か確認します。例えば「レコードが作成されたとき」ではなく「レコードが更新されたとき」になっていないか注意します。
3. 「アクション」タブで「Teamsにメッセージを送信」アクションが正しいチャネルを指定しているか確認します。チャネル名は正確に一致している必要があります。
4. 承認プロセスの場合は「設定」→「承認プロセス」から該当プロセスを開き、「Teams通知」セクションが有効で宛先チャネルが正しいか確認します。
5. Chatter連携の場合は、Chatterグループの「設定」→「Teams連携」でグループとチャネルのマッピングが存在するか確認します。
6. すべての設定を確認したら、可能であればテストイベントを発生させて通知が届くか試します。例えば承認申請を自分で作成するなどです。

4. よくある失敗パターンとその対処法

4.1 接続アプリのOAuthスコープ不足

失敗例:Teamsコネクタにメッセージを送信するために必要な「API」スコープが許可されていないため、通知が送信されない。対処法:接続アプリのOAuthポリシーで「API」と「Refresh Token」を追加し、ユーザに再認証(ログインし直し)を促します。

4.2 通知条件が有効になっていない

失敗例:プロセスビルダーのプロセスが「非アクティブ」状態のまま。対処法:プロセスを「アクティブ」に変更します。フローの場合は「有効」にします。また、承認プロセスの「Teams通知」セクションのチェックボックスがオフになっていないか確認します。

4.3 Teams側のチャネルコネクタが削除または変更されている

失敗例:Teams管理者がチャネルコネクタを削除したため、Webhook URLが無効化され通知が届かない。対処法:Teamsチャネルの「コネクタ」設定で「Incoming Webhook」を開き、Webhookが存在するか確認します。存在しない場合は新しいWebhookを作成し、Salesforceの接続アプリのWebhook URLを更新します。

5. 管理者へ確認すべき設定項目

通知が来ない問題が発生した場合、システム管理者は以下の設定を包括的に確認する必要があります。一般ユーザではアクセスできないため、管理者に情報を伝える際のチェックリストとして活用してください。

• 接続アプリのアクセス権:特定のプロファイルのみ接続アプリを使用できる設定になっていないか。少なくとも通知を利用するユーザのプロファイルに「接続アプリの使用」権限が付与されている必要があります。
• 通知条件の所有者:プロセスビルダーやフローの所有者が適切か。所有者が退職しているとプロセスが意図せず無効になることがあります。
• Teamsライセンスとポリシー:ユーザに適切なMicrosoft Teamsライセンスが割り当てられているか、また組織のTeamsポリシーで外部コネクタが許可されているか確認します。
• Salesforceのリモートサイト設定:TeamsのWebhookエンドポイントがSalesforceのリモートサイト設定に追加されているか。追加されていない場合は通信がブロックされます。
• ブラウザキャッシュ:設定変更後、ユーザにキャッシュクリアまたはシークレットウィンドウでのテストを依頼します。

6. よくある質問(FAQ)

Q. 通知が来ない場合、最初に確認すべきことは?

A. 真っ先に確認すべきは「通知条件が有効になっているか」と「接続アプリのWebhook URLが正しいか」の2点です。これらは最も頻繁に問題になる箇所です。次に、Teamsのチャネルコネクタが存在するか確認します。

Q. 接続アプリの再認証方法は?

A. 接続アプリの詳細画面で「OAuthポリシー」→「更新」ボタンをクリックすると、トークンが再発行されます。また、ユーザにSalesforceから一度ログアウトして再ログインしてもらうことで、新しいスコープが適用されます。

Q. 通知条件は誰でも作成できる?

A. いいえ、プロセスビルダーやフローの作成には「プロセスビルダーの管理」や「フローの管理」権限が必要です。また、承認プロセスのTeams通知設定はシステム管理者のみが編集できます。一般ユーザは作成・変更できないため、管理者に依頼してください。

Q. Teams側で何か設定は必要?

A. 事前にTeamsの各チャネルに「Incoming Webhook」コネクタを追加し、Webhook URLを取得する必要があります。また、組織のTeams管理センターでカスタムコネクタが許可されているか確認してください。

Q. 複数のチャネルに通知するには?

A. 通知条件ごとに送信先を1つのチャネルにしか指定できません。複数チャネルに通知したい場合は、同じ条件で複数の通知条件を作成するか、フローでループ処理を使用して複数のWebhook URLに送信する方法があります。

7. まとめ

SalesforceとTeamsの連携通知が届かない場合、最初に接続アプリと通知条件の設定を系統立てて確認することが重要です。本記事で紹介した手順に沿って、OAuthスコープやWebhook URL、通知条件の有効状態を一つずつチェックすれば、ほとんどの問題は解決できます。設定変更はシステム管理者が行う必要があるため、一般ユーザは管理者に的確に状況を伝えましょう。また、トラブル再発防止のために、定期的に設定の棚卸しを実施することをお勧めします。

👥

Teams/Outlookトラブル完全解決データベース サインイン、接続エラー、メール送受信の不具合など、特有のトラブル解決策を網羅。困った時の逆引きに活用してください。