Dynamics 365 채널 통합 프레임워크 2.0을 사용한 소프트폰 통합을 위한 샘플 코드

Microsoft Dynamics 365 채널 통합 프레임워크 버전 2.0용 소프트폰 통합 샘플을 다운로드하세요.

노트

샘플 코드는 Internet Explorer 및 webRTC를 지원하지 않는 브라우저에서 지원되지 않습니다. 추가 정보: WebRTC

전제 조건

• Dynamics 365 Customer Service용 옴니채널

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

  노트

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

Azure에 샘플 앱 게시하기

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

2. 솔루션 탐색기에서 솔루션을 마우스 오른쪽 버튼으로 클릭하고 전체 솔루션을 구축합니다.

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

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

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

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

7. 앱 이름을 입력합니다. 예: SampleInteg

8. 유효한 구독, 리소스 그룹 및 호스팅 요금제 세부 정보를 입력합니다.

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

   https://sampleinteg.azurewebsites.net을 예로 들 수 있습니다.

   
   

앱 서비스에서 사용할 함수 만들기

1. client-voice 함수에 대한 샘플 코드를 만듭니다.
   샘플 소프트폰 통합과 함께 패키지로 제공되는 readme 파일에서 Dynamics 365 Insider Portal의 기능을 참조하세요.

2. capability-token 함수에 대한 샘플 코드를 사용합니다.
   샘플 소프트폰 통합과 함께 패키지로 제공되는 readme 파일에서 Dynamics 365 Insider Portal의 기능을 참조하세요.

노트

위의 샘플 코드에서 얻은 capability-token 함수의 URL을 저장합니다. 예를 들어, URL은 https://sampleinteg.sample/capability-token입니다.

Dynamics 365에서 샘플 앱 구성하기

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

2. Dynamics 365 채널 통합 프레임워크 솔루션을 설치하세요. 자세한 내용은 Dynamics 365 채널 통합 프레임워크 설치하기를 참조하세요.

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

   필드	Description
   입력	채널 공급자 이름입니다. 예: 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)을 사용하여 개별 사용자에게 매핑할 수 있습니다. 후자를 선택할 경우 기존 사용자 매핑 파일 또는 사용자 대신 사용자 매핑 파일을 생성할 수 있는 도구를 지정해야 합니다. 새 파일을 생성할 경우 원본 서버의 모든 사용자에 대해 새로 만들기 매개 변수에 매핑 사용자 이름을 입력합니다. 완료되면 도구에서 사용자 매핑 파일을 선택하고 확인을 선택합니다.

8. 다음 화면에 레코드의 가져오기 상태가 표시됩니다. 데이터 가져오기는 여러 단계로 수행되는데, 종속 데이터가 대기하고 있는 동안 먼저 기초 데이터를 가져온 후 이후 단계에서 종속 데이터를 가져와 데이터 종속성 또는 연결을 처리합니다. 그러면 깔끔하고 일관되게 데이터를 가져올 수 있습니다.

9. 도구를 닫으려면 완료를 선택합니다.

참조 항목

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