Recuperar las interacciones de un contacto mediante código

  • Artículo
  • Tiempo de lectura: 2 minutos

Importante

El siguiente método para recuperar interacciones ha quedado en desuso y es posible que no esté disponible en el futuro.

Para recuperar datos de interacción, el método recomendado actual es configurar Azure Blob Storage y conectarlo a la aplicación Dynamics 365 Marketing. Más información: Prepararse para los informes analíticos con Power BI

Utilice la acción msdyncrm_LoadInteractionsPublic para recuperar mediante programación las interacciones de un contacto. Esta acción es muy útil para responder a solicitudes de obtención de datos con el fin de cumplir el Reglamento General de Protección de Datos (RGPD).

Propina

También generar clases de solicitud y respuesta para esta acción para incluirlas en el código de aplicación. Más información: Generar tipos de enlace en tiempo de compilación para una acción.

Parámetros de la acción

La acción msdyncrm_LoadInteractionsPublic espera los siguientes parámetros de entrada:

Nombre Tipo Descripción
ContactId Edm.String Id. del registro de contacto del que se van a recuperar las interacciones. Obligatorio.
DateFrom Edm.String Fecha de inicio con formato MM-DD-AAAA a partir de la cual desea recuperar las interacciones. Opcional.
DateTo Edm.String Fecha de finalización con formato MM-DD-AAAA hasta la cual desea recuperar las interacciones. Opcional.
InteractionType Edm.String Tipo de interacción que se va a recuperar. Obligatorio.
Puede especificar uno de los siguientes valores:
  • ActivityContactBlocked
  • ActivityContactDispatched
  • ActivityContactProcessingFailed
  • CreateCrmActivityContactProcessed
  • CreateCustomChannelActivityContactProcessed
  • CustomChannelResponse
  • CustomerJourneyContactRecordUpdated
  • EmailBlockBounced
  • EmailBlocked
  • EmailClicked
  • EmailContainsBlockListedLinks
  • EmailDelivered
  • EmailFeedbackLoop
  • EmailForwarded
  • EmailHardBounced
  • EmailOpened
  • EmailSendingFailed
  • EmailSent
  • EmailSoftBounced
  • EmailSubscriptionSubmit
  • EventCheckIn
  • EventRegistration
  • FormSubmitted
  • FormVisited
  • InvalidRecipientAddress
  • InvalidSenderAddress
  • LeadScoreBoost
  • OutOfEmailCredits
  • PassThroughActivityContactProcessed
  • RedirectLinkClicked
  • SchedulerActivityContactProcessed
  • SegmentRelationshipEdited
  • SegmentSubscribed
  • SegmentUnsubscribed
  • SplitterActivityContactProcessed
  • SurveyResponse
  • TriggerActivityContactProcessed
  • TriggerCrmWorkflowActivityContactProcessed
  • WebsiteClicked
  • WebsiteVisited
Top Edm.Int32 Opcional. Entero no negativo que limita el número de interacciones devueltas para un registro de contacto. Opcional.
SkipToken Edm.String Identifica un punto de partida en la colección de interacciones devueltas para un registro de contacto. Opcional.

Tipo devuelto por la acción

La acción msdyncrm_LoadInteractionsPublic devuelve el siguiente valor:

Nombre Tipo Descripción
msdyncrm_LoadInteractionsPublicResponse ComplexType Contiene la respuesta de la acción msdyncrm_LoadInteractionsPublic. Contiene las siguientes propiedades que contienen los datos estructurados del tipo:
Nombre Tipo Descripción
Data Edm.String Lista de interacciones como una matriz JSON con secuencias de escape.
NextSkipToken Edm.String Identifica el siguiente cursor o marcador en la colección de interacciones devueltas para un registro de contacto.

Ejemplo

Solicitud

POST [Organization URI]/api/data/v9.0/msdyncrm_LoadInteractionsPublic HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
  
{
    "InteractionType": "WebsiteClicked",
    "ContactId": "0dbe0fa3-8e18-e811-a951-000d3a37caec",
}

Respuesta

La respuesta contiene un objeto JSON con una propiedad Data que contiene la lista de interacciones completa.

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0

{
    "@odata.context":"[Organization URI]/api/data/v9.0/$metadata#Microsoft.Dynamics.CRM.msdyncrm_LoadInteractionsPublicResponse",
    "Data":"[{\"InteractionId\":\"172C1E59A3CD4D85B392316DD76651CE\",\"InteractionType\":\"EmailSent\",\"Timestamp\":\"2018-02-23T13:10:48Z\",\"OrganizationId\":\"e47e99c2-20e3-4ef3-bbd4-288258bd6bf9\",\"EmailDomain\":\"microsoft.com\",\"ActivityId\":\"b6aeb700-f1c1-4cb1-e8f8-e883eac6bfbc\",\"SendingId\":\"5a019802-f763-3b72-fc91-0a9c95b67c5f\",\"ContactId\":\"0dbe0fa3-8e18-e811-a951-000d3a37caec\",\"MessageId\":\"5a2f3e76-9518-e811-a951-000d3a38caec\",\"CustomerJourneyId\":\"4c3846a1-9618-e811-a951-000d3a37cafc\",\"CustomerJourneyIterationId\":\"538825cf-fe1c-4fee-a671-7984eabb62eb\",\"UsageType\":\"CustomerJourney\",\"EmailAddressUsed\":\"sample@adventure-works.com\"}]",
    "NextSkipToken":null
}

Vea también

Protección de datos y RGPD
Vista previa: Prepararse para los informes analíticos con Power BI