Dynamics 365 セットアップガイド

このガイドでは、Azure AD アプリケーションを登録し、BuiltWith が Dynamics 365 インスタンスで認証を行い、リード情報を自動更新できるようにする手順を説明します。Azure Active Directory 管理者権限と Dynamics 365 システム管理者権限が必要です。

ステップ1 - Azure Active Directoryに新しいアプリを登録する

Azure管理者アカウントでportal.azure.comにサインインします。左側のメニューで「Azure Active Directory」を選択し、 「アプリ登録」を選択して「+新規登録」をクリックします。

BuiltWith Integrationなどの名前を入力します。「サポートされているアカウントの種類」で、「この組織ディレクトリ内のアカウントのみ（単一テナント）」を選択します。「リダイレクトURI」は空白のままにして、 「登録」をクリックします。

アプリの概要ページで、アプリケーション (クライアント) IDとディレクトリ (テナント) IDをコピーします。BuiltWith に資格情報を入力するときに、両方必要になります。

ステップ2 - Dynamics 365のAPI権限を構成する

アプリ登録画面で、左側のメニューにある「API 権限」をクリックし、 「+ 権限の追加」をクリックします。 「Dynamics CRM」を選択します（リストに表示されない場合は、「組織が使用するAPI」で検索してください）。 「委任された権限」を選択し、 「user_impersonation」にチェックを入れて、 「権限の追加」をクリックします。

ステップ3 - クライアントシークレットを作成する

アプリ登録で、 「証明書とシークレット」をクリックします。「クライアントシークレット」で「 +新しいクライアントシークレット」をクリックし、 「BuiltWith」などの説明を入力し、有効期限を選択して「追加」をクリックします。

シークレットの値（「値」列の長い文字列、シークレットIDではありません）をすぐにコピーしてください。この値は一度だけ表示され、ページから移動すると非表示になります。

ステップ4 - 管理者の同意を与える

アプリ登録のAPI権限に戻り、 「管理者の同意を付与」をクリックします。 「はい」をクリックして確定します。同意すると、各権限の横にあるステータス列に緑色のチェックマークが表示されます。

ステップ5 - Dynamics 365アプリケーションユーザーとしてアプリを追加する

admin.powerplatform.microsoft.comにアクセスし、環境を選択します。 「設定」→「ユーザー + 権限」→「アプリケーション ユーザー」に移動し、 「+ 新しいアプリ ユーザー」をクリックします。

「+ アプリを追加」をクリックし、アプリ登録名（BuiltWith Integration）を検索して選択します。ビジネスユニットを選択し、 「作成」をクリックします。

新しく作成したアプリケーションユーザーを開き、 「営業担当者」セキュリティロール、またはリードエンティティへの読み取りと書き込みのアクセス権を含むカスタムロールを割り当てます。このロールには、リードエンティティに対する作成、読み取り、書き込み、追加、および追加先の権限が必要です。

ステップ6 - BuiltWithで資格情報を入力する

BuiltWith Dynamics 365 接続ページに戻り、次のフィールドに入力します。

クライアント ID - 手順 1 でコピーしたアプリケーション (クライアント) ID。
クライアント シークレット- 手順 3 でコピーしたシークレット値 (シークレット ID ではありません)。
テナント ID - 手順 1 でコピーしたディレクトリ (テナント) ID。
Dynamics 365 URL — Dynamics 365 インスタンスの URL（例：https://yourorg.crm.dynamics.com）。Power Platform 管理センターの「環境」→「環境」→「環境 URL」で確認できます。

「保存」をクリックします。BuiltWith は Dynamics 365 インスタンスへのテスト呼び出しで認証情報を確認します。認証が完了すると、リードエンリッチメントが自動的に開始されます。

認証エラーが表示された場合は、手順 4 で管理者の同意が与えられていること、および手順 5 でアプリケーション ユーザーに正しいセキュリティ ロールが割り当てられていることを確認します。