Interaksi pembuatan aktivitas saluran kustom

Catatan

Pada tanggal 1 September 2023, Dynamics 365 Marketing dan Dynamics 365 Customer Insights akan dijual bersama dalam satu SKU produk bernama Dynamics 365 Customer Insights. Aplikasi individual akan diubah namanya menjadi Dynamics 365 Customer Insights - Perjalanan dan Dynamics 365 Customer Insights - Data. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Dynamics 365 Customer Insights

Selain itu, pada 1 September 2023, pelanggan Dynamics 365 Marketing baru hanya akan menerima fitur pemasaran real-time. Untuk informasi selengkapnya, lihat Penginstalan pemasaran real-time default. Banyak halaman dokumentasi saat ini mengacu pada fitur keluar yang mungkin tidak tersedia atau mungkin berfungsi dalam cara yang berbeda dalam pemasaran real-time. Konten dokumentasi akan diperbarui pada bulan September untuk menunjukkan apakah konten tersebut berlaku untuk pemasaran real-time atau pemasaran keluar.

Penting

Artikel ini hanya berlaku untuk pemasaran keluar.

Tabel berikut menjelaskan parameter input yang msdyncrm_CustomChannelActivityCreateInteraction diperlukan oleh tindakan:

Parameter input	Tipe	Description
ActivityId	String	Nilai msdyncrm_activityid atribut entitas yang msdyncrm_customerjourneycustomchannelactivity berisi Id Aktivitas saluran kustom.
Perjalanan Pelanggan	EntityReference	Nilai msdyncrm_customerjourney atribut entitas yang berisi Referensi Entitas ke perjalanan pelanggan yang msdyncrm_customerjourneycustomchannelactivity berasal dari panggilan.
CustomerJourneyIteration	EntityReference	Nilai msdyncrm_customerjourneyiteration atribut entitas yang msdyncrm_customerjourneycustomchannelactivity berisi Referensi Entitas ke iterasi perjalanan pelanggan.
Kontak	EntityReference	Nilai msdyncrm_contact atribut entitas yang berisi Referensi Entitas ke kontak yang msdyncrm_customerjourneycustomchannelactivity diproses.
EntityType	String	Nilai msdyncrm_entitytype atribut entitas yang berisi string yang msdyncrm_customerjourneycustomchannelactivity mewakili jenis entitas entitas kustom yang dibuat pada langkah 1 dan ditentukan dalam definisi ubinsaluran kustom.
EntityId	String	Nilai msdyncrm_entityidmsdyncrm_customerjourneycustomchannelactivity atribut id rekaman entitas kustom yang dibuat pada langkah 1 dan ditentukan oleh EntityType elemen dalam definisi ubinsaluran kustom.
Jenis Tanggapan	String	Id dari salah satu jenis respons yang ditentukan dalam definisi ubinsaluran kustom.
Kata Kunci Pemicu	String	(Opsional) Kata kunci untuk jenis respons kustom yang ditentukan dalam definisi petak kustom.

XML di bawah ini menunjukkan bagian definisi ubin saluran kustom. Bagian ini mendefinisikan tiga jenis respons. Dua sent yang pertama, dan delivered, adalah tipe respons standar. Yang ketiga, keyword memungkinkan melewati nilai tekstual tambahan untuk interaksi.

 <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> 

Memancarkan Aktivitas Saluran khusus Buat Interaksi

Kode berikut menunjukkan cara memancarkan Aktivitas Saluran Kustom: Buat Interaksi secara terprogram. Dalam contoh ini, aktivitas referensi ditentukan dalam rekaman aktivitas saluran kustom. Kami memancarkan interaksi dengan ResponseType = keyword dan 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);