Adicionar manualmente um canal personalizado
O Dynamics 365 Customer Insights - Journeys suporta os canais E-mail, Notificação Push e SMS de forma nativa. Para utilizar um tipo de canal ou fornecedor de SMS que não seja suportado de forma nativa, pode instalar um canal personalizado. Se o canal ainda não for fornecido no AppSource, pode criá-lo e instalá-lo manualmente.
Estrutura de canal personalizado
Os canais personalizados podem ser implementados como parte de uma solução do Dataverse. Os seguintes passos e ações são necessários para criar um canal personalizado:
- Definir uma entidade de configuração expandida para a instância de canal
- Definir uma entidade de configuração expandida para a conta de instância de canal (só SMS)
- Definir as partes da mensagem (componente com suporte para soluções)
- Definir a localização da interface de administração (opcional)
- Definir a interface do editor de mensagens (opcional)
- Definir APIs personalizadas
- Definir o canal personalizado (componente com suporte para soluções)
O Customer Insights - Journeys fornece componentes base para a criação de um canal personalizado, incluindo APIs e entidades necessárias como msdyn_channeldefinition, msdyn_channelmessagepart, msdyn_channellocale, msdyn_channelinstanceaccount e msdyn_channelinstance.
O diagrama seguinte ilustra os componentes principais de um canal do Customer Insights - Journeys nativo e de uma solução de canal personalizada:
A tabela seguinte descreve os requisitos de implementação para canais de SMS e personalizados.
| Componente | SMS | Personalizadas |
|---|---|---|
| Entidade de configuração expandida para a instância de canal | Obrigatório | Obrigatório |
| Entidade de configuração expandida para a conta de instância de canal | Obrigatório | Não suportado |
| Partes da mensagem | Obrigatório; deve conter apenas uma parte de mensagem com "msdyn_name" = "text" | Obrigatório |
| Localização da IU de admin | Opcional | Opcional |
| IU do Editor de mensagens | Não permitido; é utilizado o editor de SMS do Customer Insights - Journeys nativo | Opcional; é utilizado o editor do Customer Insights - Journeys genérico, se não for definido |
| APIs Personalizadas | Obrigatório | Obrigatório |
| Definição de canal | Obrigatório | Obrigatório |
Soluções de amostra
As seguintes amostras incluem soluções descompactadas para o Dataverse e projetos de plug-ins. Para empacotar e importar as soluções, primeiro, crie o projeto de plug-in. O projeto copia a assemblagem para o projeto da solução. Depois, empacote a solução utilizando a ferramenta Solution Packager.
Como criar o projeto de plug-ins e empacotar a solução
Crie o projeto de plug-in com o MSBuild ou o Visual Studio.
A criação do projeto cria uma DLL na pasta PluginAssemblies dentro da pasta da solução Dataverse.
Empacote a pasta não gerida com o Empacotador de Soluções utilizando um dos dois:
- CLI do pac (preferencial)
- Empacotador de soluções
pac solution pack --zipfile C:\tmp\SampleCustomChannelSolution.zip -f src\Solutions\Samples\SampleCustomChannel\SampleCustomChannel.Solution\unmanaged --packagetype Both