다음을 통해 공유

Dynamics 365 Channel Integration Framework 2.0을 사용하는 소프트폰 통합을 위한 샘플 코드

Microsoft Dynamics 365 Channel Integration Framework 버전 2.0용 소프트폰 통합 샘플을 다운로드합니다.

비고

샘플 코드는 WebRTC가 지원되지 않는 Internet Explorer 및 브라우저에서 지원되지 않습니다. WebRTC에서 자세히 알아보기

필수 조건

  • Dynamics 365 고객 서비스용 옴니채널.

  • 샘플 앱을 Azure에 게시하려면 유효한 Azure 구독이 필요합니다.

    비고

    Azure 구독이 없는 경우 체험 계정을 만들 수 있습니다.

Azure에 샘플 앱 게시

  1. Visual Studio 2017을 사용하여 SampleInteg.sln 엽니다.

  2. 솔루션 탐색기에서 솔루션을 마우스 오른쪽 단추로 클릭하고 전체 솔루션을 빌드합니다.

  3. 솔루션 탐색기에서 프로젝트 SampleInteg를 마우스 오른쪽 단추로 클릭하고 게시를 선택합니다.

  4. [시작]을 선택하여 게시 마법사를 시작합니다.

  5. App Service를 게시 대상으로 선택합니다.

  6. 새로 만들기를 선택한 다음 게시를 선택합니다.

  7. 앱 이름을 제공합니다. 예를 들어 SampleInteg입니다.

  8. 유효한 구독, 리소스 그룹 및 호스팅 계획 세부 정보를 제공합니다.

  9. 만들기를 선택하여 Azure 앱 서비스를 만들고 나중에 사용할 수 있도록 App Service URL을 저장합니다.

    예: https://sampleinteg.azurewebsites.net.

    만들기를 선택하여 Azure에 앱을 게시합니다.

App Service와 함께 사용할 함수 만들기

  1. 클라이언트 음성 함수에 대한 샘플 코드를 만듭니다.
    Dynamics 365 Insider Portal의 샘플 소프트폰 통합으로 패키지된 추가 정보 파일의 함수를 참조하세요.

  2. 기능 토큰 함수에 샘플 코드를 사용합니다.
    Dynamics 365 Insider Portal의 샘플 소프트폰 통합으로 패키지된 추가 정보 파일의 함수를 참조하세요.

비고

샘플 코드에서 가져온 기능 토큰 함수의 URL을 저장합니다. 예를 들어 URL은 .입니다 https://sampleinteg.sample/capability-token.

Dynamics 365에서 샘플 앱 구성

  1. 모든 웹 리소스가 저장되는 Dynamics 365 조직의 기본 URL을 확인합니다. 온라인 조직의 경우 URL 형식이어야 https://<orgname>.crmXX.dynamics.com합니다. 예: https://sampleorg.crm10.dynamics.com

  2. Dynamics 365 Channel Integration Framework 솔루션을 가져옵니다. 자세한 내용은 Dynamics 365 채널 통합 프레임워크 가져오기를 참조하세요.

  3. 행렬에 표시된 대로 세부 정보를 제공하여 채널 공급자를 구성합니다. 자세한 내용은 채널 공급자 구성을 참조하세요.

    분야 Description
    이름 채널 공급자의 이름입니다.

    예: Contoso
    고유 이름 < _>< 형식의 > 고유 식별자입니다.
    중요하다: 고유한 이름에는 다음이 필요합니다.
    • 접두사는 영숫자일 수 있으며 길이는 3~8자 사이여야 합니다.
    • 접두사와 이름 사이에 밑줄이 있어야 합니다.
    라벨 레이블은 위젯에 제목으로 표시됩니다.

    예: Contoso
    채널 URL 채널 URL 형식은 다음과 같습니다. <azure_app_service_url>?base=<crm_base_url>

    메모: 이 샘플의 경우 URL은 .입니다 https://sampleinteg.azurewebsites.net?base=https://sampleorg.crm10.dynamics.com.
    아웃바운드 통신 사용 Yes
    채널 순서 0
    API 버전 2.0
    신뢰할 수 있는 도메인 Channel Integration Framework 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 서버에 여러 조직이 있고 구성 데이터를 가져올 조직을 선택하려는 경우 항상 사용 가능한 조직 목록 표시 확인란을 선택합니다. 로그인을 선택합니다.

  5. 조직이 여러 개인 경우 항상 사용 가능한 조직 목록 표시 확인란을 선택하면 다음 화면에서 연결하려는 조직을 선택할 수 있습니다. Dynamics 365 앱 조직을 선택합니다.

  6. 가져올 데이터 파일(data.zip)을 제공합니다. 데이터 파일로 이동하여 선택합니다. 데이터 가져오기를 선택합니다.

  7. 이 단계는 가져오는 데이터에 원본 시스템의 사용자 정보가 포함된 경우에만 적용됩니다. 대상 시스템에 매핑 사용자 정보를 입력합니다. 가져오기 프로세스를 실행하는 사용자에게 모두 매핑하거나 사용자 맵 파일(.xml)을 사용하여 개별 사용자에게 매핑할 수 있습니다. 후자를 선택하는 경우 기존 사용자 맵 파일을 지정하거나 도구에서 생성할 수 있습니다. 새 파일을 생성하는 경우 원본 서버의 모든 사용자에 대한 새 매개 변수에 매핑 사용자 이름을 입력합니다. 완료되면 도구에서 사용자 맵 파일을 선택하고 확인을 선택합니다.

  8. 다음 화면에는 레코드의 가져오기 상태가 표시됩니다. 데이터 가져오기는 여러 패스로 수행되어 종속 데이터를 큐에 대기하는 동안 먼저 기본 데이터를 가져온 다음 후속 패스에서 종속 데이터를 가져와 데이터 종속성 또는 연결을 처리합니다. 이렇게 하면 깨끗하고 일관된 데이터 가져오기가 보장됩니다.

  9. 마침을 선택하여 도구를 닫습니다.

Dynamics 365 채널 통합 프레임워크 가져오기

  • Last updated on