Adicionar manualmente um canal personalizado
O Dynamics 365 Customer Insights - Journeys é compatível com canais de Email, Push e SMS nativamente. Para usar um tipo de canal ou provedor de SMS sem suporte nativo, você pode instalar um canal personalizado. Se o canal ainda não foi fornecido no AppSource, você pode criá-lo e instalá-lo manualmente.
Estrutura do canal personalizado
Canais personalizados podem ser implementados como parte de uma solução do Dataverse. As seguintes etapas e ações são necessárias para criar um canal personalizado:
- Definir uma entidade de configuração estendida para a instância do canal
- Definir uma entidade de configuração estendida para a conta da Instância do canal (somente SMS)
- Definir as partes da mensagem (componente com reconhecimento de solução)
- Definir a localização para a interface de administração (opcional)
- Definir a interface do editor de mensagens (opcional)
- Definir APIs personalizadas
- Definir o canal personalizado (componente com reconhecimento de solução)
O Customer Insights - Journeys fornece componentes básicos para criar um canal personalizado, incluindo APIs personalizadas e entidades necessárias como msdyn_channeldefinition, msdyn_channelmessagepart, msdyn_channellocale, msdyn_channelinstanceaccount e msdyn_channelinstance.
O seguinte diagrama ilustra os principais componentes de um canal de Customer Insights - Journeys nativo e uma solução de canal personalizado:
A tabela a seguir descreve os requisitos de implementação para canais SMS e personalizados.
| Componente | SMS | Personalizada |
|---|---|---|
| Entidade de configuração estendida para a instância do canal | Obrigatória | Obrigatória |
| Entidade de configuração estendida para a conta da instância do canal | Obrigatória | Incompatível |
| Partes da mensagem | Obrigatório; deve conter apenas uma única parte da mensagem com "msdyn_name" = "text" | Obrigatória |
| Localização para interface do usuário do administrador | Opcional | Opcional |
| Interface do usuário do editor de mensagem | Não permitido; o editor de SMS nativo do Customer Insights - Journeys é usado | Opcional; o editor genérico do Customer Insights - Journeys será usado se não for definido |
| APIs Personalizadas | Obrigatória | Obrigatória |
| Definição de canal | Obrigatória | Obrigatória |
Soluções de exemplo
O exemplos a seguir incluem soluções descompactadas para o Dataverse e projetos de plug-ins. Para compactar e importar as soluções, primeiro crie o projeto de plug-in. O projeto copia o assembly para o projeto da solução. Em seguida, compacte a solução usando a Ferramenta Pacote de Soluções.
Como criar o projeto de plug-in e empacotar a solução
Crie o projeto de plug-ins com MSBuild ou o Visual Studio.
A criação do projeto cria um DLL na pasta PluginAssemblies dentro da pasta da solução Dataverse.
Empacote a pasta não gerenciada com o Pacote de Soluções usando:
- pac CLI (preferencial)
- Pacote de Soluções
pac solution pack --zipfile C:\tmp\SampleCustomChannelSolution.zip -f src\Solutions\Samples\SampleCustomChannel\SampleCustomChannel.Solution\unmanaged --packagetype Both