Примерен код за интеграция на софтфони с помощта на Dynamics 365 Channel Integration Framework 2.0

Статия
12/04/2023

Изтеглете проба за интеграция на софтфон за Microsoft Dynamics 365 Channel Integration Framework версия 2.0.

Бележка

Примерният код не се поддържа в Internet Explorer и на браузъри, които нямат поддръжка на webRTC. Повече информация: WebRTC

Предварителни изисквания

Omnichannel за Dynamics 365 обслужване на клиенти
Необходим е валиден абонамент за Azure, за да се публикува примерното приложение в Azure.

Бележка

Ако нямате абонамент за Azure, можете да създадете безплатен акаунт.

Публикуване на примерно приложение в Azure

Отворете решението SampleInteg.sln като използвате Visual Studio 2017.
В Solution Explorer щракнете с десния бутон върху решението и изградете цялостното решение.
В Solution Explorer щракнете с десния бутон върху проекта SampleInteg и изберете Публикуване.
Изберете Старт, за да стартирате съветника за публикуване .
Изберете App Service като цел за публикуване.
Изберете Създаване на нов и след това изберете Публикуване.
Въведете име на приложение. Например,SampleInteg .
Предоставете валидни подробности за абонамента, ресурсната група и хостинг плана.
Изберете Създаване , за да създадете услугата за приложения на Azure, и запишете URL адреса на услугата за приложения за бъдеща употреба.

Например, https://sampleinteg.azurewebsites.net.

Създаване на функция за използване с услугата за приложения

Създайте примерен код за функцията клиент-глас .
Обърнете се към функцията от файла readme, пакетиран с примерната интеграция на софтфон в портала Dynamics365 Insider.
Използвайте примерния код за функцията за маркери за възможности.
Обърнете се към функцията от файла readme, пакетиран с примерната интеграция на софтфон в портала Dynamics365 Insider.

Бележка

Запазете URL адреса за функцията за маркери за възможности, която получавате от горния примерен код. Например, URL адресът е https://sampleinteg.sample/capability-token.

Конфигуриране на примерно приложение в Dynamics 365

Обърнете внимание на базовия URL адрес на организацията на Dynamics 365, откъдето се съхраняват всички уеб ресурси. За онлайн организация това трябва да бъде във формата https://<orgname>.crmXX.dynamics.com. Например: https://sampleorg.crm10.dynamics.com
Вземете решението Dynamics 365 Channel Integration Framework . За повече информация вижте Получаване на рамка за интегриране на канали на Dynamics 365.

Конфигурирайте доставчика на канала, като предоставите подробностите, както е показано в матрицата. За повече информация вижте Конфигуриране на доставчика на канала.

Поле	Описание
Име	Име на доставчика на канала. Пример: Contoso
Уникално име	Еднозначен идентификатор във формата prefix <>_<name> . ВАЖНО: За уникалното име се изисква следното: Префиксът може да бъде само буквено-цифров и дължината му трябва да бъде между 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
Надеждни домейни	Домейнът (URL), който има достъп до API на Channel Integration Framework.
Изберете Унифициран интерфейс приложения за канала	Списъкът с Унифициран интерфейс приложения, където каналът се показва за агентите.
Избор на роли за канала	Правата за достъп, които присъстват в Dynamics 365. Забележка: Ако не присвоите никаква роля, доставчикът на канали се показва на всички потребители, назначени за приложението Dynamics 365 Унифициран интерфейс.

Стартирайте приложението Унифициран интерфейс, за да видите комуникацията графичен компонент от лявата страна.

Важно

Всички URL адреси трябва да са HTTPS.
Ако използвате самоподписан сертификат за приложението Azure или Dynamics 365 org, някои браузъри може да отхвърлят връзката и да не успеят да заредят примерния телефон. Като заобиколно решение отворете приложението Azure в отделен раздел и приемете сертификата веднъж.
Уверете се, че достъпът до микрофона и високоговорителите не е блокиран от правилата на браузъра.

Импортиране на конфигурационни данни

Изтеглете инструмента за мигриране на конфигурацията. Инструментът за мигриране на конфигурацията NuGet е наличен като пакет.
Стартирайте Configuration Migration Tool. Щракнете двукратно върху DataMigrationUtility.exe в папката: [your folder]\Tools\ConfigurationMigration\.
На главния екран изберете Импортиране на данни и след това изберете Продължи.
На екрана за влизане предоставете подробни данни за удостоверяване, за да се свържете с вашия екземпляр на Dynamics 365, откъдето искате да импортирате данни. Ако имате няколко организации на сървъра на Dynamics 365 и искате да изберете организацията, в която да импортирате конфигурационните данни, отметнете квадратчето Винаги показвай списъка с наличните организации . Изберете Влизане.
Ако имате множество организации и сте избрали квадратчето за отметки до Винаги показвай списък с наличните организации, следващият екран ще ви позволи да изберете организацията, с която искате да се свържете. Изберете организация с приложения на Dynamics 365, към която да се свържете.
Предоставете файла с данни (data.zip), който ще бъде импортиран. Намерете файла с данни и го изберете. Изберете Импортиране на данни.
Тази стъпка е приложима само ако данните, които импортирате, съдържат потребителската информация на системата източник. Въведете информация за съпоставяне на потребителите в целевата система. Можете или да ги съпоставите всички с потребителя, който изпълнява процеса на импортиране, или да ги съпоставите с отделни потребители с помощта на файл за съпоставяне на потребители (.xml). Ако изберете второто, ще трябва или да укажете съществуващ файл за съпоставяне на потребители, или да използвате инструмента, който да генерира такъв файл за вас. Ако генерирате нов файл, попълнете потребителското име за съпоставяне в параметъра Нов за всеки потребител на сървъра източник. Изберете файла с картата на потребителя в инструмента, когато сте готови, и изберете OK.
Следващият екран показва състоянието на импортиране на вашите записи. Импортирането на данни се извършва на няколко етапа, за да се импортират първо основните данни, докато зависимите данни изчакват на опашка, след което се импортират зависимите данни в следващите етапи, за да се обработят всички зависимости или свързвания между данните. По този начин се осигурява чисто и съгласувано импортиране на данните.
Изберете "Готово", за да затворите инструмента.

Вижте също

Получаване на рамка за интегриране на канали на Dynamics 365

Споделяне чрез