Udostępnij przez


Przykładowy kod integracji softphone'a przy użyciu Dynamics 365 Channel Integration Framework 2.0

Pobierz przykład integracji oprogramowania dla platformy Microsoft Dynamics 365 Channel Integration Framework w wersji 2.0.

Uwaga / Notatka

Przykładowy kod nie jest obsługiwany w programie Internet Explorer i przeglądarkach, które nie obsługują protokołu WebRTC. Dowiedz się więcej w usłudze WebRTC

Wymagania wstępne

  • Omnichannel dla usługi Dynamics 365 Customer Service.

  • Do opublikowania przykładowej aplikacji na platformie Azure jest wymagana prawidłowa subskrypcja platformy Azure.

    Uwaga / Notatka

    Jeśli nie masz subskrypcji platformy Azure, możesz utworzyć bezpłatne konto.

Publikowanie przykładowej aplikacji na platformie Azure

  1. Otwórz SampleInteg.sln przy użyciu programu Visual Studio 2017.

  2. W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy rozwiązanie i skompiluj kompletne rozwiązanie.

  3. W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy projekt SampleInteg i wybierz pozycję Publikuj.

  4. Wybierz pozycję Rozpocznij , aby uruchomić kreatora publikowania .

  5. Wybierz usługę App Service jako element docelowy publikowania.

  6. Wybierz pozycję Utwórz nowy , a następnie wybierz pozycję Publikuj.

  7. Podaj nazwę aplikacji. Na przykład SampleInteg.

  8. Podaj prawidłowe szczegóły subskrypcji, grupy zasobów i planu hostingu.

  9. Wybierz pozycję Utwórz , aby utworzyć usługę Azure App Service, a następnie zapisz adres URL usługi App Service do użycia w przyszłości.

    Na przykład https://sampleinteg.azurewebsites.net.

    Wybierz pozycję Utwórz, aby opublikować aplikację na platformie Azure.

Tworzenie funkcji do użycia z usługą App Service

  1. Utwórz przykładowy kod dla funkcji client-voice .
    Zapoznaj się z funkcją z pliku Readme dołączonego do przykładowej integracji telefonu programowego w Portalu Dynamics 365 Insider.

  2. Użyj przykładowego kodu dla funkcji capability-token .
    Zapoznaj się z funkcją z pliku Readme dołączonego do przykładowej integracji telefonu programowego w Portalu Dynamics 365 Insider.

Uwaga / Notatka

Zapisz adres URL funkcji capability-token uzyskany z przykładowego kodu. Na przykład adres URL to https://sampleinteg.sample/capability-token.

Konfigurowanie przykładowej aplikacji w usłudze Dynamics 365

  1. Zanotuj podstawowy adres URL organizacji usługi Dynamics 365, z którego są przechowywane wszystkie zasoby internetowe. W przypadku organizacji online adres URL powinien mieć format https://<orgname>.crmXX.dynamics.com. Przykład: https://sampleorg.crm10.dynamics.com

  2. Pobierz rozwiązanie Dynamics 365 Channel Integration Framework . Aby uzyskać więcej informacji, zobacz Pobierz Dynamics 365 Channel Integration Framework.

  3. Skonfiguruj dostawcę kanału, podając szczegóły, jak pokazano w macierzy. Aby uzyskać więcej informacji, zobacz Konfigurowanie dostawcy kanału.

    Pole Description
    Name Nazwa dostawcy kanału.

    Przykład: Contoso
    Unikatowa nazwa Unikatowy identyfikator w formacie <prefiks>_<nazwa>.
    WAŻNE: Wymagane dla unikatowej nazwy:
    • Prefiks może być alfanumeryczny, a jego długość musi zawierać się od 3 do 8 znaków.
    • Znak podkreślenia musi znajdować się między prefiksem a nazwą
    Etykieta Ta etykieta jest wyświetlana jako tytuł w widgecie.

    Przykład: Contoso
    Adres URL kanału Adres URL kanału ma format: <azure_app_service_url>?base=<crm_base_url>

    Nuta: W tym przykładzie adres URL to https://sampleinteg.azurewebsites.net?base=https://sampleorg.crm10.dynamics.com.
    Włącz komunikację wychodzącą Tak
    Ranga kanału 0
    Wersja interfejsu API 2.0
    Zaufane domeny Domena (adres URL), która może uzyskiwać dostęp do interfejsów API struktury integracji kanałów.
    Wybierz aplikacje ujednoliconego interfejsu dla kanału Lista aplikacji ujednoliconego interfejsu, w których jest wyświetlany kanał dla przedstawicieli działu obsługi klienta.
    Wybierz role dla kanału Role zabezpieczeń obecne w Dynamics 365.
    Nuta: Jeśli nie przypiszesz żadnej roli, dostawca kanału będzie wyświetlany wszystkim użytkownikom przypisanym do aplikacji Dynamics 365 Unified Interface.
  4. Uruchom aplikację Ujednolicony interfejs, aby wyświetlić widżet komunikacji po lewej stronie.

Ważne

  • Wszystkie adresy URL muszą mieć wartość HTTPS.
  • Jeśli używasz certyfikatu z podpisem własnym dla aplikacji platformy Azure lub organizacji usługi Dynamics 365, niektóre przeglądarki mogą odrzucić połączenie i nie załadować przykładowego telefonu. Aby obejść ten problem, otwórz aplikację platformy Azure na osobnej karcie i zaakceptuj certyfikat raz.
  • Upewnij się, że dostęp do mikrofonu i głośnika nie jest blokowany przez polityki przeglądarki.

Importowanie danych konfiguracji

  1. Pobierz narzędzie do migracji konfiguracji. Narzędzie do migracji konfiguracji jest dostępne jako pakiet NuGet.

  2. Uruchom narzędzie do migracji konfiguracji. Kliknij dwukrotnie DataMigrationUtility.exe w folderze : [your folder]\Tools\ConfigurationMigration\.

  3. Na ekranie głównym wybierz pozycję Importuj dane, a następnie wybierz pozycję Kontynuuj.

  4. Na ekranie logowania podaj szczegóły uwierzytelniania, aby nawiązać połączenie z wystąpieniem usługi Dynamics 365, z którego chcesz zaimportować dane. Jeśli masz wiele organizacji na serwerze usługi Dynamics 365 i chcesz wybrać organizację, do której mają zostać zaimportowane dane konfiguracji, zaznacz pole wyboru Zawsze wyświetlana lista dostępnych organizacji . Wybierz pozycję Zaloguj.

  5. Jeśli masz wiele organizacji i zaznaczysz pole wyboru Zawsze wyświetlana lista dostępnych organizacji , następny ekran umożliwia wybranie organizacji, z którą chcesz nawiązać połączenie. Wybierz organizację aplikacji Dynamics 365.

  6. Podaj plik danych (data.zip) do zaimportowania. Przejdź do pliku danych i wybierz go. Wybierz pozycję Importuj dane.

  7. Ten krok ma zastosowanie tylko wtedy, gdy importowane dane zawierają informacje o użytkowniku systemu źródłowego. Wprowadź mapowanie informacji o użytkowniku w systemie docelowym. Wszystkie te elementy można mapować na użytkownika, który uruchamia proces importowania, lub mapować na poszczególnych użytkowników przy użyciu pliku mapy użytkownika (.xml). Jeśli wybierzesz tę drugą opcję, musisz określić istniejący plik mapy użytkownika lub narzędzie może je wygenerować. Jeżeli wygenerujesz nowy plik, wypełnij nazwę mapującego użytkownika w parametrze Nowy dla każdego użytkownika na serwerze źródłowym. Po zakończeniu wybierz plik mapy użytkownika w narzędziu, a następnie wybierz przycisk OK.

  8. Na następnym ekranie zostanie wyświetlony stan importu rekordów. Import danych odbywa się wieloetapowo. Najpierw importowane są dane podstawowe, w tym samym czasie kolejkowane są dane zależne, następnie importowane są dane zależne i obsługiwane wszelkie zależności i powiązania z danymi. Zapewnia to czyste i spójne importowanie danych.

  9. Wybierz przycisk Zakończ , aby zamknąć narzędzie.

Pobierz Platformę Integracji Kanałów Dynamics 365