Dynamics 365 Customer Insights (versión preliminar)
El conector de Dynamics 365 Customer Insights proporciona un conjunto de API para interactuar con instancias de Dynamics 365 Customer Insights.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
Para registrarse en Dynamics 365 Customer Insights, haga clic aquí.
Para usar este conector en Power Apps, obtenga más información aquí.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar elemento (versión preliminar) |
Esta operación actualiza un elemento en una entidad. |
| Crear elemento (versión preliminar) |
Esta operación crea un elemento en una entidad |
| Envía el informe de estado |
Envía el informe de estado. |
| Envía el informe de estado V2 |
Envía el informe de estado V2. |
| Obtención de elementos de una entidad |
Esta operación obtiene elementos de una entidad. En función de la entidad, los campos se pueden definir como filtros:
|
| Obtención de entidades |
Esta operación obtiene entidades de una instancia |
| Obtener elemento |
Esta operación obtiene un elemento de una entidad |
| Recuperación de datos de una partición (versión preliminar) |
Recuperar datos de una partición. |
| Recuperación de particiones para una entidad (versión preliminar) |
Recuperar particiones para una entidad. |
| Recuperación de particiones para una entidad V2 (versión preliminar) |
Recuperar particiones para una entidad V2. |
Actualizar elemento (versión preliminar)
Esta operación actualiza un elemento en una entidad.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de una instancia |
|
entityName
|
table | True | string |
Nombre de una entidad |
|
itemIdentifier
|
id | True | string |
Identificador del elemento |
|
recordItem
|
item | True | dynamic |
Registro para actualizar |
Devoluciones
Crear elemento (versión preliminar)
Esta operación crea un elemento en una entidad
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de una instancia |
|
entityName
|
table | True | string |
Nombre de una entidad |
|
recordItem
|
item | True | dynamic |
Registro para crear |
Envía el informe de estado
Envía el informe de estado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de instancia
|
dataset | True | string |
Seleccione una instancia. |
|
Tipo de informe
|
reportType | True | string |
Seleccione un tipo de informe. |
Envía el informe de estado V2
Envía el informe de estado V2.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de instancia
|
dataset | True | string |
Seleccione una instancia. |
|
Tipo de informe
|
reportType | True | string |
Seleccione un tipo de informe. |
Obtención de elementos de una entidad
Esta operación obtiene elementos de una entidad. En función de la entidad, los campos se pueden definir como filtros:
- Entidad UnifiedActivity: campos ActivityId y CustomerId
- Entidad de cliente: campo CustomerId y cualquier otro campo indexado en la instancia de Customer Insights
- Cualquier otra entidad: campo CustomerId.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de una instancia |
|
entityName
|
table | True | string |
Nombre de una entidad |
|
Consulta de filtro
|
$filter | string |
Una consulta de filtro ODATA para restringir las entradas devueltas (por ejemplo, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Recuento superior
|
$top | integer |
Número total de entradas que se van a recuperar (valor predeterminado = todo). |
|
|
Seleccionar consulta
|
$select | string |
Campos específicos que se van a recuperar de las entradas (valor predeterminado = todo). |
Devoluciones
Obtención de entidades
Esta operación obtiene entidades de una instancia
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de una instancia |
Devoluciones
Representa una lista de tablas.
- Body
- TablesList
Obtener elemento
Esta operación obtiene un elemento de una entidad
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de una instancia |
|
entityName
|
table | True | string |
Nombre de una entidad |
|
itemIdentifier
|
id | True | string |
Identificador del elemento |
Devoluciones
Recuperación de datos de una partición (versión preliminar)
Recuperar datos de una partición.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Conjunto de datos de Customer Insights
|
dataset | True | string |
Conjunto de datos de Customer Insights. |
|
La entidad
|
table | True | string |
La entidad. |
|
Referencia (URI o nombre) de la partición
|
partitionUri | True | string |
Referencia (URI o Nombre) de la partición. |
|
Una línea separada por comas de columnas
|
select | string |
Línea de columnas separadas por comas. |
|
|
Posición desde dónde empezar a leer, en bytes
|
offsetStart | integer |
Posición desde dónde empezar a leer, en bytes. |
|
|
Número máximo de bytes que se van a leer
|
maxSize | integer |
Número máximo de bytes que se van a leer. |
|
|
Número máximo de registros que se van a devolver
|
maxResults | integer |
Número máximo de registros que se van a devolver. |
Devoluciones
Datos de una partición.
Recuperación de particiones para una entidad (versión preliminar)
Recuperar particiones para una entidad.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Conjunto de datos de Customer Insights
|
dataset | True | string |
Conjunto de datos de Customer Insights. |
|
La entidad
|
table | True | string |
La entidad. |
Devoluciones
- response
- array of Table
Recuperación de particiones para una entidad V2 (versión preliminar)
Recuperar particiones para una entidad V2.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Conjunto de datos de Customer Insights
|
dataset | True | string |
Conjunto de datos de Customer Insights. |
|
La entidad
|
table | True | string |
La entidad. |
|
Valor partitionDisplayName para el que se va a filtrar
|
partitionDisplayName | string |
Valor partitionDisplayName para el que se va a filtrar. |
Devoluciones
Lista de particiones
Desencadenadores
| Desencadena un flujo cuando se completa un proceso en Customer Insights |
Se desencadena un flujo para las actualizaciones programadas del proceso seleccionado. Además, puede optar por desencadenar un flujo para las actualizaciones manuales. |
| Desencadena un flujo cuando se completa una actualización completa de Customer Insights. |
Esta operación desencadena un flujo cuando se completa una actualización completa de Customer Insights (orígenes de datos, segmentos, medidas,...). |
| Desencadena un flujo cuando se cruza un umbral de medida empresarial |
Esta operación desencadena un flujo cuando se cruza un umbral de medida empresarial en Dynamics 365 Customer Insights. |
| Desencadena un flujo cuando se cruza un umbral de segmento |
Esta operación desencadena un flujo cuando se cruza un umbral de segmento en Dynamics 365 Customer Insights. |
| Desencadena un flujo desde el origen de datos cuando se completa la actualización. |
Esta operación desencadena un flujo desde el origen de datos cuando se completa la actualización en Dynamics 365 Customer Insights. |
| Desencadena un flujo desde el origen de datos cuando se produce un error en la actualización. |
Esta operación desencadena un flujo desde el origen de datos cuando se produce un error de actualización en Dynamics 365 Customer Insights. |
Desencadena un flujo cuando se completa un proceso en Customer Insights
Se desencadena un flujo para las actualizaciones programadas del proceso seleccionado. Además, puede optar por desencadenar un flujo para las actualizaciones manuales.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de instancia
|
dataset | True | string |
Seleccione una instancia. |
|
Proceso
|
process | string |
Seleccione un proceso. |
|
|
Incluir el proceso desencadenado manualmente
|
includingManualRefreshes | boolean |
Seleccione Sí si se debe incluir el proceso desencadenado manualmente. |
Devoluciones
Información sobre el proceso ejecutado
- Body
- ProcessData
Desencadena un flujo cuando se completa una actualización completa de Customer Insights.
Esta operación desencadena un flujo cuando se completa una actualización completa de Customer Insights (orígenes de datos, segmentos, medidas,...).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de instancia
|
dataset | True | string |
Seleccione una instancia. |
Devoluciones
La información sobre la actualización completa ejecutada
Desencadena un flujo cuando se cruza un umbral de medida empresarial
Esta operación desencadena un flujo cuando se cruza un umbral de medida empresarial en Dynamics 365 Customer Insights.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de instancia
|
dataset | True | string |
Seleccione una instancia. |
|
Nombre de medida empresarial
|
measure | True | string |
Seleccione una medida. |
|
Umbral
|
threshold | True | double |
Establezca cualquier número como umbral. |
Devoluciones
Datos de medida empresarial
- Body
- MeasureData
Desencadena un flujo cuando se cruza un umbral de segmento
Esta operación desencadena un flujo cuando se cruza un umbral de segmento en Dynamics 365 Customer Insights.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de instancia
|
dataset | True | string |
Seleccione una instancia. |
|
Nombre de segmento
|
segment | True | string |
Seleccione un segmento. |
|
Umbral
|
threshold | True | integer |
Establezca cualquier número como umbral. |
Devoluciones
Segmentar datos
- Body
- SegmentData
Desencadena un flujo desde el origen de datos cuando se completa la actualización.
Esta operación desencadena un flujo desde el origen de datos cuando se completa la actualización en Dynamics 365 Customer Insights.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Medio ambiente
|
dataset | True | string |
nombre del conjunto de datos. |
Devoluciones
DataSourcesList
- Body
- DataSourcesList
Desencadena un flujo desde el origen de datos cuando se produce un error en la actualización.
Esta operación desencadena un flujo desde el origen de datos cuando se produce un error de actualización en Dynamics 365 Customer Insights.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Medio ambiente
|
dataset | True | string |
nombre del conjunto de datos. |
Devoluciones
DataSourcesList
- Body
- DataSourcesList
Definiciones
DataSourcesList
DataSourcesList
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of DataSource |
Lista de orígenes de datos |
Fuente de datos
Clase DataSource
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
RefreshType
|
RefreshType | string |
Tipo para la actualización de datos |
|
RefreshObjectId
|
RefreshObjectId | string |
Identificador de objeto de actualización |
|
RefreshObjectVersion
|
RefreshObjectVersion | integer |
La versión del objeto de actualización |
|
Operation
|
Operation | string |
El nombre de la operación |
|
JobType
|
JobType | string |
Tipo de trabajo |
|
ErrorCode
|
ErrorCode | string |
Código de error durante la actualización de datos. |
|
Mensaje de error
|
ErrorMessage | string |
Mensaje de error durante la actualización |
|
ErrorSeverity
|
ErrorSeverity | string |
El servidor de errores durante la actualización |
|
StartTimeUtc
|
StartTimeUtc | string |
Hora de inicio de la actualización de datos |
|
EndTimeUtc
|
EndTimeUtc | string |
Hora de finalización de la actualización de datos |
SegmentData
Segmentar datos
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
Name | string |
Nombre del segmento |
|
DisplayName (Nombre para mostrar)
|
DisplayName | string |
Nombre para mostrar del segmento |
|
EvaluationDate
|
EvaluationDate | date-time |
Fecha de evaluación del segmento |
|
EntityCount
|
EntityCount | integer |
Recuento real de miembros del segmento |
|
Umbral
|
Threshold | integer |
Umbral de segmento |
MeasureData
Datos de medida empresarial
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
Name | string |
Nombre de la medida |
|
DisplayName (Nombre para mostrar)
|
DisplayName | string |
Nombre para mostrar de la medida |
|
EvaluationDate
|
EvaluationDate | date-time |
Fecha de evaluación de la medida |
|
Importancia
|
Value | double |
Valor de la medida |
|
ValueDisplayName
|
ValueDisplayName | string |
Nombre para mostrar del valor |
|
Umbral
|
Threshold | double |
Umbral de medida |
FullRefreshProcessData
La información sobre la actualización completa ejecutada
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
NumberOfFailedTasks
|
NumberOfFailedTasks | integer |
Número de tareas con errores |
|
StartTime
|
StartTime | date-time |
Hora de inicio del paso de flujo de trabajo |
|
EndTime
|
EndTime | date-time |
Hora de finalización del paso de flujo de trabajo |
|
Duración
|
Duration | integer |
Duración del proceso en minutos |
|
Estado
|
Status | string |
Estado del paso de flujo de trabajo |
|
StatusPage
|
StatusPage | string |
Vínculo a la página de estado |
ProcessData
Información sobre el proceso ejecutado
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
StartTime
|
StartTime | date-time |
Hora de inicio del paso de flujo de trabajo |
|
EndTime
|
EndTime | date-time |
Hora de finalización del paso de flujo de trabajo |
|
Duración
|
Duration | integer |
Duración del proceso en minutos |
|
Estado
|
Status | string |
Estado del paso de flujo de trabajo |
|
StatusPage
|
StatusPage | string |
Vínculo a la página de estado |
Table
Representa una tabla.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
Name | string |
Nombre de la tabla. El nombre se usa en tiempo de ejecución. |
|
DisplayName (Nombre para mostrar)
|
DisplayName | string |
Nombre para mostrar de la tabla. |
|
DynamicProperties
|
DynamicProperties | object |
Propiedades de tabla adicionales proporcionadas por el conector a los clientes. |
PartitionListResponse
Lista de particiones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Header
|
Header | string |
Encabezado que contiene los atributos de la entidad |
|
Partitions
|
Partitions | array of Table |
Lista de particiones |
PartitionDataResponse
Datos de una partición.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
OffsetStart
|
OffsetStart | integer |
Desplazamiento inicial. |
|
OffsetEnd
|
OffsetEnd | integer |
Desplazamiento final. |
|
Tamaño
|
Size | integer |
Número de datos devueltos. |
|
Productos
|
Items | array of object |
Diccionario que contiene datos de elementos máximos de "Tamaño" de una partición, desde el desplazamiento "OffsetStart" a "OffsetEnd". |
|
items
|
Items | object |
TablesList
Representa una lista de tablas.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of Table |
Lista de tablas |