次の方法で共有

Dynamics 365 チャネル統合フレームワーク 2.0 を使った Softphone 統合のサンプル コード

  • [アーティクル]

Microsoft Dynamics 365 チャネル統合フレームワーク (バージョン 2.0) の Softphone 統合サンプルの ダウンロード。

Note

サンプル コードは、Internet Explorer と、webRTC サポートのないブラウザーはサポートしていません。 詳細: WebRTC。

前提条件

  • Dynamics 365 Customer Service のオムニチャネル

  • Azure にサンプル アプリケーションを公開するには、有効な Azure サブスクリプションが必要です。

    Note

    Azure サブスクリプションを持っていない場合、無料アカウントを作成できます。

Azure にサンプル アプリを公開する

  1. Visual Studio 2017 を使用してソリューション SampleInteg.sln を開きます。

  2. ソリューション エクスプローラーで、ソリューションを右クリックし、完全なソリューションをビルドします。

  3. ソリューション エクスプローラーで、プロジェクト SampleInteg を右クリックして、公開を選択します。

  4. 公開ウィザードを起動するには 開始 を選択します。

  5. アプリケーション サービス を公開対象として選択します。

  6. 新規作成 を選択し、公開 を選択します。

  7. アプリケーションの名前を指定します。 たとえば、SampleInteg です。

  8. 有効なサブスクリプション、リソース グループ、およびホスティング プランの詳細を提供します。

  9. 作成 を選択して Azure アプリ サービスを作成し、後で使用できるようにアプリ サービス URL を保存します。

    たとえば、https://sampleinteg.azurewebsites.net などとします。

    [作成] を選択して、Azure でアプリを公開します。

アプリ サービスで使用するための関数を作成する

  1. client-voice 関数のサンプル コードを作成します。
    Dynamics 365 Insider ポータル で、サンプル Softphone 統合とパッケージ化された readme ファイルの関数を参照してください。

  2. capability-token 関数のサンプル コードを使用します。
    Dynamics 365 Insider ポータル で、サンプル Softphone 統合とパッケージ化された readme ファイルの関数を参照してください。

Note

上記のサンプル コードから取得した capability-token 関数の URL を保存します。 たとえば、URL は https://sampleinteg.sample/capability-token です。

Dynamics 365 でサンプル アプリを構成する

  1. すべての Web リソースが保存されている Dynamics 365 組織の基本 URL に留意してください。 オンライン組織の場合、これは https://<orgname>.crmXX.dynamics.com の形式になります。 例: https://sampleorg.crm10.dynamics.com

  2. Dynamics 365 Channel Integration Framework ソリューションを取得します。 詳細については、Dynamics 365 Channel Integration Framework の取得を参照してください。

  3. 行列に示された通り、詳細を提供することで、チャネル プロバイダを構成します。 詳細については、チャネル プロバイダーの構成 を参照してください。

    フィールド 内容
    件名 チャネル プロバイダーの名前。

    例: Contoso
    一意の名前 <接頭辞>_<名前> フォーマットの一意識別子です。
    重要 :一意の名称には以下のものが必要です :
    • 接頭辞には英数字のみを使用でき、長さは3〜8文字である必要があります。
    • 接頭辞と名前の間にはアンダースコアが必要です
    Label ラベルはウィジェットにタイトルとして表示されます。

    例: Contoso
    チャネル URL チャネル URL の形式: <azure_app_service_url>?base=<crm_base_url>

    注意: この例では、URL は https://sampleinteg.azurewebsites.net?base=https://sampleorg.crm10.dynamics.com です。
    送信の通信を有効にする あり
    チャネルの順序 0
    API のバージョン 2.0
    信頼される側のドメイン チャネル統合フレームワーク API にアクセスできるドメイン (URL)。
    チャネルの統一インターフェイス アプリを選択する チャネルがエージェントに対して表示される統一インターフェイス アプリの一覧。
    チャネルのロールを選択する Dynamics 365 にあるセキュリティ ロール。
    注意: ロールを割り当てない場合、Dynamics 365 統一インターフェイス アプリに割り当てられたすべてのユーザーにチャネル プロバイダーが表示されます。

  4. 統一インターフェイス アプリを起動して、左側の通信ウィジェットを表示します。

重要

  • すべての URL は HTTPS でなければなりません。
  • Azure アプリまたは Dynamics 365 組織の自己署名証明書を使用している場合は、特定ブラウザーは接続を拒否し、サンプル電話を読み込めない可能性があります。 回避策として、別のタブで Azure アプリケーションを開き、証明書を一度承認してください。
  • マイクとスピーカーのアクセスがブラウザーのポリシーによってブロックされいないことを確認します。

構成データのインポート

  1. 構成の移行ツール をダウンロードします。 構成の移行ツールは NuGet パッケージ として使用できます。

  2. 構成移行ツールを起動します。 フォルダー: [your folder]\Tools\ConfigurationMigration\ で DataMigrationUtility.exe をダブルクリックします。

  3. メイン画面で、データのインポート を選択し、その後 続行 を選択します。

  4. サインイン画面で、認証の詳細を指定し、データのインポート元の Dynamics 365 インスタンスに接続します。 Dynamics 365 Server に複数の組織があり、構成データのインポート先の組織を選択する場合は、使用可能な組織の一覧を常に表示する チェック ボックスをオンします。 ログインを選択します。

  5. 複数の組織があり、使用可能な組織の一覧を常に表示するチェック ボックスをオンにする場合、次の画面で接続する組織を選択できます。 接続する Dynamics 365 アプリ組織を選択します。

  6. インポートされるデータ ファイル (data.zip) を供給します。 データ ファイルを参照して選択します。 データのインポートを選択します。

  7. この手順は、インポートするデータにソース システムのユーザー情報が含まれている場合にのみ適用可能です。 ターゲット システム上のマッピング ユーザー情報を入力します。 インポート処理を実行しているユーザーに対してそれらすべてをマッピング、またはユーザー マップ ファイル (.xml) を使用して個々のユーザーにマッピングできます。 後者を選択した場合、既存のユーザー マップ ファイルを指定するか、ツールで生成するかを指定する必要があります。 新しいファイルを生成する場合、ソース サーバーのすべてのユーザーに対し、新規パラメーターでマッピング ユーザー名を入力します。 完了したらツール内のユーザー マップ ファイルを選択して、OK を選択します。

  8. 次の画面にレコードのインポートの状態が表示されます。 データのインポートは複数のパスで実行され、最初に依存データのキュー中に基盤データをインポートし、続くパスで依存データをインポートし、データ依存またはリンクを処理します。 これにより、クリーンで一貫性のあるデータ インポートができます。

  9. 終了を選択してツールを閉じます。

参照

Dynamics 365 Channel Integration Framework の取得