Compartir a través de


Dynamics 365 Commerce: clasificaciones y opiniones

Use dynamics 365 Commerce Ratings and Reviews API para importar nuevas revisiones, exportar revisiones existentes, etc.

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)
     - 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 Government
     - 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)
     - 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)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Dynamics 365 Commerce-Ratings y opiniones
URL https://dynamics.microsoft.com/en-us/support/
Correo Electrónico d365ratingreviewconn@microsoft.com
Metadatos del conector
Publicador Microsoft
Sitio web https://dynamics.microsoft.com/en-us/commerce/overview/
Directiva de privacidad https://privacy.microsoft.com/privacystatement
Categorías Comercio; Gestión empresarial

El conector Dynamics 365 Commerce - Ratings and Reviews proporciona un conjunto de acciones para interactuar con las API de Dynamics 365 Ratings y Review Service. Estas acciones facilitan la importación y exportación de datos de revisiones. Hay dos acciones disponibles: Exportar todas las revisiones y Enviar una revisión.

Prerrequisitos

Necesitará lo siguiente para continuar:

  • Suscripción a Microsoft Dynamics 365 Commerce
  • Detalles de la solución clasificaciones y revisiones habilitadas

Póngase en contacto con un partner de Dynamics 365 Commerce aquí para obtener más información sobre cómo empezar a trabajar con Microsoft Dynamics 365.

Obtención de credenciales

El primer paso es registrar el conector como una aplicación en microsoft Entra ID. Esto permite que el conector se identifique a sí mismo en el identificador de Microsoft Entra y solicite permisos para acceder a los datos de clasificaciones y opiniones en nombre del usuario final. Obtenga más información sobre esto aquí y siga estos pasos:

1. Cree una aplicación de Id. de Entra de Microsoft:

Esta aplicación de Id. de Microsoft Entra se usará para identificar la conexión del conector a Clasificaciones y Revisiones. Para ello, sigaestos pasos para registrar una aplicación en microsoft Entra ID y habilitar la autenticación.

Durante el registro, capture la siguiente información, ya que se usará para establecer una conexión autenticada con el conector mediante la entidad de servicio:

  • Id. de aplicación cliente
  • Secreto de cliente (recuerde anotar esto, ya que solo se muestra una vez).
  • Identificador del directorio de cliente (inquilino).

Con la aplicación Microsoft Entra ID creada, ahora se puede usar para obtener permisos de los usuarios finales. Use los campos que ha guardado para establecer una conexión autenticada a través de la entidad de servicio mediante el conector Dynamics 365 Commerce - Ratings and Reviews.

El siguiente paso es registrar esta aplicación en la página de configuración de la herramienta de moderación clasificaciones y opiniones.

2. Registrar la aplicación microsoft Entra ID en la Herramienta de moderación de clasificaciones y opiniones

Para que el servicio Clasificaciones y revisiones autentique las operaciones procedentes del conector, los clientes deben registrar su aplicación de id. de Microsoft Entra en la página de configuración de la herramienta de moderación Ratings and Review moderation (Clasificaciones y revisar la moderación). Use el identificador de aplicación cliente y el identificador de directorio de cliente del paso anterior para agregar una entrada de aplicación de servicio a servicio (S2S). Para obtener más información sobre cómo administrar la configuración de clasificaciones y revisiones desde la herramienta de moderación, consulte aquí.

Introducción al conector

Para empezar a trabajar con dynamics 365 Commerce - Ratings and Reviews Connector, basta con agregarlo a un flujo existente o empezar a buscar los flujos de plantilla de ejemplo para importar y exportar revisiones.

Nota: Dynamics 365 Commerce - Ratings and Reviews Connector estará disponible en todas las regiones de Power Automate, pero Las clasificaciones y las revisiones solo procesarán las llamadas en las regiones admitidas para el inquilino. Asegúrese de revisar los requisitos de cumplimiento de su organización y crear el entorno de Power Automate en una región que se ajuste a las necesidades de cumplimiento.

Preguntas más frecuentes

  • ¿Cuál es la longitud máxima de un cuerpo de texto de revisión y el título de revisión?

    La longitud máxima de un título de revisión es de 55 caracteres. La longitud máxima del cuerpo del texto de revisión es de 1000 caracteres.

  • ¿Cuál es la estructura del parámetro encodedUser en la acción Enviar revisión?

    El codificadorUser agrega seguridad adicional para pasar información de usuario. Codifica un esquema de identidad de usuario en base64. Consulte la estructura de esquema siguiente para componer el objeto en el flujo y, a continuación, use la función integrada toBase64() para codificarla antes de pasarlo en la acción SubmitReview.

    {
        "p" : {
                "t" : "Unix epoch in seconds (should be within an hour of current time)",
                "email" : "Reviewer User Email Here",
                "name" : "Reviewer User Name Here",
                "id" : "Reviewer User Id Here"
            }
    }
    

    Para obtener más información, consulte un ejemplo de esto en nuestro flujo de plantillas de revisiones de importación.

  • Necesito más apoyo. ¿A quién puedo llegar?

    Póngase en contacto con el soporte técnico de Dynamics 365 Commerce para obtener soporte técnico general o correo electrónico d365ratingreviewconn@microsoft.com.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Enviar revisión de usuario

Envía una revisión de usuario al inquilino de RnR.

Exportar todas las revisiones

Exporte todas las revisiones como una dirección URL de SAS descargable.

Enviar revisión de usuario

Envía una revisión de usuario al inquilino de RnR.

Parámetros

Nombre Clave Requerido Tipo Description
Id. del producto
productId True string

Especifique el identificador del producto que se está revisando.

Id. de inquilino de RnR
tenantId True string

Especifique el identificador del inquilino de RnR.

Id. de canal
channelId string

Especifique el identificador del canal para esta revisión.

Mercado
market string

Especifique el mercado asociado a esta revisión.

Configuración regional
locale True string

Especifique la configuración regional asociada a esta revisión.

encodedUser
encodedUser True string

Especifique la cadena de información de usuario codificada en base64 asociada a esta revisión. Consulte la documentación sobre el formato de bloque JSON que contiene el nombre de usuario, el correo electrónico y el identificador.

Rating
Rating True string

Especifique la clasificación de la revisión como un entero.

Title
Title True string

Especifique el título de la revisión.

ReviewText
ReviewText True string

Especifique el cuerpo del texto de la revisión.

Sku
Sku string

Especifique el número de SKU del producto revisado.

ProductName
ProductName True string

Especifique el nombre del producto revisado.

LegalEntity
LegalEntity string

Especifique la entidad jurídica.

ExtendedProperties
ExtendedProperties object

Especifique las propiedades de revisión adicionales como pares clave-valor. Consulte la documentación para el formato JSON.

submittedDateTime
submittedDateTime string

Especifique la fecha y hora enviada de la revisión en formato UTC (el valor predeterminado es la hora UTC actual).

Devoluciones

Identificador de revisión de la revisión enviada.

Exportar todas las revisiones

Exporte todas las revisiones como una dirección URL de SAS descargable.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de inquilino de RnR
tenantId True string

Especifique el identificador del inquilino de RnR.

Devoluciones

Definiciones

SubmitReviewResponse

Identificador de revisión de la revisión enviada.

Identificador de revisión de la revisión enviada.

ReviewID
string

ExportSuccessfulResponse

Nombre Ruta de acceso Tipo Description
Dirección URL de SAS de blobs
blobSasUrl string

Dirección URL de SAS generada a partir de Blob Storage.

Fecha de expiración
expires string

Fecha en que expira la dirección URL de SAS.

Fecha de creación
created string

Fecha en que se creó la dirección URL de SAS.