Activité du canal personnalisé Créer Interaction

Note

Dynamics 365 Marketing et Dynamics 365 Customer Insights sont maintenant Customer Insights - Journeys et Customer Insights - Data. Pour plus d’informations, consultez les Dynamics 365 Customer Insights FAQ

Les nouveaux clients Customer Insights - Journeys reçoivent uniquement des fonctionnalités des parcours en temps réel. Pour en savoir plus, consultez Installation de parcours en temps réel par défaut.

Important

Cet article ne s’applique qu’au marketing sortant, qui sera supprimé du produit le 30 juin 2025. Pour éviter les interruptions, passez aux parcours en temps réel avant cette date. Plus d’informations, voir Vue d’ensemble des transitions

Le tableau suivant décrit les paramètres d’entrée requis par l’actionmsdyncrm_CustomChannelActivityCreateInteraction :

Paramètre d’entrée	Type	Description
ActivityId	Chaîne	La valeur d’attribut msdyncrm_activityid de l’entité msdyncrm_customerjourneycustomchannelactivity contenant l’ID d’activité du canal personnalisé.
CustomerJourney	EntityReference	La valeur d’attribut msdyncrm_customerjourney de l’entité msdyncrm_customerjourneycustomchannelactivity contenant la référence d’entité au parcours du client à l’origine de l’appel.
CustomerJourneyIteration	EntityReference	La valeur d’attribut msdyncrm_customerjourneyiteration de l’entité msdyncrm_customerjourneycustomchannelactivity contenant la référence d’entité à l’itération du parcours du client.
Contact	EntityReference	La valeur d’attribut msdyncrm_contact de l’entité msdyncrm_customerjourneycustomchannelactivity contenant la référence d’entité au contact traité.
EntityType	Chaîne	La valeur d’attribut msdyncrm_entitytype de l’entité msdyncrm_customerjourneycustomchannelactivity contenant la chaîne représentant le type d’entité de l’entité personnalisée créée à l’étape 1 et défini dans la définition de la vignette de canal personnalisée.
ID d’entité	Chaîne	La valeur d’attribut msdyncrm_entityid de l’ID enregistrement msdyncrm_customerjourneycustomchannelactivity de l’entité personnalisée créée à l’étape 1 et défini par l’élément EntityType dans la définition de la vignette de canal personnalisée.
ResponseType	Chaîne	ID de l’un des types de réponse définis dans la définition de la vignette de canal personnalisée.
TriggerKeyword	Chaîne	(Facultatif) Mot clé pour le type de réponse personnalisé défini dans la définition de vignette personnalisée.

Le fichier XML ci-dessous montre la section de la définition de vignette de canal personnalisée. Cette section définit trois types de réponses. Les deux premiers, sent et delivered, sont les types de réponse standard. Le troisième, keyword, permet de transmettre une valeur textuelle supplémentaire à l’interaction.

 <ResponseTypes> 
    <ResponseType id="sent"> 
      <Labels> 
        <!-- Labels should always have a Label for 1033 --> 
        <Label locId="1033">Sent</Label> 
        <Label locId="1031">[Sent]</Label> 
      </Labels> 
    </ResponseType> 
    <ResponseType id="delivered"> 
      <Labels> 
       <!-- Labels should always have a Label for 1033 --> 
        <Label locId="1033">Delivered</Label> 
        <Label locId="1031">[Delivered]</Label> 
      </Labels> 
    </ResponseType> 
    <ResponseType id="keyword" custom="True"> 
      <!-- there should be only one response type with attribute custom=true --> 
      <Labels> 
        <!-- Labels should always have a Label for 1033 --> 
        <Label locId="1033">Keyword match</Label> 
        <Label locId="1031">[Keyword match]</Label> 
      </Labels> 
    </ResponseType> 
  </ResponseTypes> 

Émettre l’activité du canal personnalisé Créer Interaction

Le code suivant montre comment émettre une activité de canal personnalisée Créer une interaction par programme. Dans cet exemple, l’activité de référence est définie dans l’enregistrement d’activité de canal personnalisé. Nous émettons l’interaction avec ResponseType = keyword et TriggerKeyword = interested.

    var orgServiceFactory = serviceProvider.GetService(typeof(IOrganizationServiceFactory)) as IOrganizationServiceFactory; 
    IOrganizationService orgService = orgServiceFactory.CreateOrganizationService(context.UserId);
    
    //Id of msdyncrm_customerjourneycustomchannelactivity entity 
    Guid Id = "<Record Guid>"; 

    //Get response from your service or use predefined response type for keyword based responses. 
    string responseType = "keyword"; 

    //Get keyword response from your service (Optional) 
    string triggerKeyWord = "interested"; 
    //Note: if you emmiting interaction on creation of msdyncrm_customerjourneycustomchannelactivity entity instance, there is no need to retrieve it, you can use Target  
    Entity customChannelRecord = orgService.Retrieve( "msdyncrm_customerjourneycustomchannelactivity",Id,new Microsoft.Xrm.Sdk.Query.ColumnSet(true)); 
    var emitInteractionRequest = new OrganizationRequest("msdyncrm_CustomChannelActivityCreateInteraction"); 
    emitInteractionRequest.Parameters.Add("ActivityId", customChannelRecord.GetAttributeValue<string>("msdyncrm_activityid")); 
    emitInteractionRequest.Parameters.Add("CustomerJourney", customChannelRecord.GetAttributeValue<EntityReference>("msdyncrm_customerjourney")); 
    emitInteractionRequest.Parameters.Add("CustomerJourneyIteration", customChannelRecord.GetAttributeValue<EntityReference>("msdyncrm_customerjourneyiteration")); 
    emitInteractionRequest.Parameters.Add("Contact", customChannelRecord.GetAttributeValue<EntityReference>("msdyncrm_contact")); 
    emitInteractionRequest.Parameters.Add("EntityId", customChannelRecord.GetAttributeValue<string>("msdyncrm_entityid")); 
    emitInteractionRequest.Parameters.Add("EntityType", customChannelRecord.GetAttributeValue<string>("msdyncrm_entitytype")); 
    emitInteractionRequest.Parameters.Add("ResponseType", responseType); 

    //Needed if response type has “custom” attribute set to “True” 
    emitInteractionRequest.Parameters.Add("TriggerKeyword", triggerKeyWord); 

    //Emit interaction 
    orgService.Execute(emitInteractionRequest);