Compartilhar via


Dynamics 365 Commerce – Avaliações e avaliações

Utilize as APIs de Avaliações e Revisões do Dynamics 365 Commerce para importar novas revisões, exportar revisões existentes e muito mais!

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Commerce-Ratings e Revisões do Dynamics 365
URL https://dynamics.microsoft.com/en-us/support/
Email d365ratingreviewconn@microsoft.com
Metadados do conector
Publicador Microsoft
Site https://dynamics.microsoft.com/en-us/commerce/overview/
Política de privacidade https://privacy.microsoft.com/privacystatement
Categorias Comércio; Gestão de empresas

O conector do Dynamics 365 Commerce – Classificações e Revisões fornece um conjunto de ações para interagir com as APIs do Serviço de Avaliação e Revisão do Dynamics 365. Essas ações facilitam a importação e a exportação de dados de revisões. Duas ações estão disponíveis: Exportar Todas as Revisões e Enviar uma Revisão.

Pré-requisitos

Você precisará do seguinte para continuar:

  • Assinatura do Microsoft Dynamics 365 Commerce
  • Detalhes da solução Classificações e Revisões Habilitadas

Entre em contato com um parceiro do Dynamics 365 Commerce aqui para obter detalhes sobre como começar a usar o Microsoft Dynamics 365.

Como obter credenciais

A primeira etapa é registrar o conector como um aplicativo na ID do Microsoft Entra. Isso permite que o conector se identifique com a ID do Microsoft Entra e solicite permissões para acessar dados de Classificações e Revisões em nome do usuário final. Leia mais sobre isso aqui e siga as etapas abaixo:

1. Criar um aplicativo de ID do Microsoft Entra:

Este aplicativo da ID do Microsoft Entra será usado para identificar a conexão do conector com Classificações e Revisões. Isso pode ser feito usando o Portal do Azure seguindo as etapas aqui para registrar um aplicativo na ID do Microsoft Entra e habilitar a autenticação.

Durante o registro, capture as seguintes informações, pois elas serão usadas para estabelecer uma conexão autenticada com o conector usando a entidade de serviço:

  • ID do aplicativo cliente
  • Segredo do Cliente (lembre-se de anotar isso, pois ele só é mostrado uma vez).
  • ID do diretório do cliente (locatário).

Com o aplicativo de ID do Microsoft Entra criado, ele agora pode ser usado para obter permissões de usuários finais. Use os campos salvos para estabelecer uma conexão autenticada por meio da entidade de serviço usando o Dynamics 365 Commerce – Ratings and Reviews Connector.

A próxima etapa é registrar esse aplicativo na página de configurações da ferramenta de moderação Classificações e Revisões.

2. Registrar o aplicativo de ID do Microsoft Entra na Ferramenta de Moderação de Classificações e Revisões

Para que o serviço Classificações e Revisões autentique as operações provenientes do conector, os clientes devem registrar seu aplicativo de ID do Microsoft Entra na página de configurações da ferramenta de moderação Classificações e Revisão. Use a ID do aplicativo cliente e a ID do diretório do cliente da etapa anterior para adicionar uma entrada de aplicativo S2S (Serviço a Serviço). Para obter mais detalhes sobre como gerenciar as configurações de Classificações e Revisões da Ferramenta de Moderação, consulte aqui.

Introdução ao conector

Para começar a usar o Conector do Dynamics 365 Commerce – Classificações e Revisões, basta adicioná-lo a um fluxo existente ou começar a pesquisar nossos fluxos de modelo de exemplo para importação e exportação de revisões.

Observação: o Conector do Dynamics 365 Commerce – Classificações e Revisões estará disponível em todas as regiões do Power Automate, mas classificações e revisões processarão apenas chamadas em regiões com suporte para seu locatário. Verifique os requisitos de conformidade para sua organização e crie o ambiente do Power Automate em uma região que atenda às necessidades de conformidade.

perguntas frequentes

  • Qual é o comprimento máximo de um corpo de texto de revisão e título de revisão?

    O comprimento máximo de um título de revisão é de 55 caracteres. O comprimento máximo do corpo do texto de revisão é de 1.000 caracteres.

  • Qual é a estrutura do parâmetro encodedUser na ação Enviar Revisão?

    O codificadoUser adiciona segurança adicional para passar informações do usuário. Ele codifica um esquema de identidade do usuário para base64. Consulte a estrutura de esquema abaixo para compor o objeto em seu fluxo e, em seguida, use a função interna toBase64() para codificá-lo antes de passá-lo na ação 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 obter mais detalhes, confira um exemplo disso em nosso fluxo de modelo de revisões de importação.

  • Preciso de mais apoio. A quem posso entrar em contato?

    Entre em contato com o suporte do Dynamics 365 Commerce para obter suporte geral ou email d365ratingreviewconn@microsoft.com.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Enviar revisão de usuário

Envia uma revisão de usuário para seu locatário RnR.

Exportar todas as revisões

Exporte todas as revisões como uma URL SAS para download.

Enviar revisão de usuário

Envia uma revisão de usuário para seu locatário RnR.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Produto
productId True string

Especifique a ID do produto que está sendo revisado.

ID do locatário RnR
tenantId True string

Especifique a ID do seu locatário RnR.

ID do canal
channelId string

Especifique a ID do canal para esta revisão.

Mercado
market string

Especifique o mercado associado a esta revisão.

Local
locale True string

Especifique a Localidade associada a esta revisão.

encodedUser
encodedUser True string

Especifique a cadeia de caracteres de informações do usuário codificada em base64 associada a esta revisão. Consulte a documentação do formato de bloco JSON que contém o nome de usuário, o email e a ID.

Rating
Rating True string

Especifique a classificação da revisão como um inteiro.

Title
Title True string

Especifique o título da revisão.

ReviewText
ReviewText True string

Especifique o corpo do texto da revisão.

Sku
Sku string

Especifique o número de SKU do produto revisado.

ProductName
ProductName True string

Especificar o nome do produto revisado

LegalEntity
LegalEntity string

Especifique a entidade legal.

Propriedades Estendidas
ExtendedProperties object

Especifique quaisquer propriedades de revisão adicionais como pares chave-valor. Consulte a documentação para o formato JSON.

submittedDateTime
submittedDateTime string

Especifique o datetime enviado de sua revisão no formato UTC (o padrão é a hora UTC atual).

Retornos

A ID de Revisão da revisão enviada.

Exportar todas as revisões

Exporte todas as revisões como uma URL SAS para download.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do locatário RnR
tenantId True string

Especifique a ID do seu locatário RnR.

Retornos

Definições

SubmitReviewResponse

A ID de Revisão da revisão enviada.

A ID de Revisão da revisão enviada.

ReviewID
string

ExportSuccessfulResponse

Nome Caminho Tipo Description
Blob SAS Url
blobSasUrl string

A URL sas gerada do armazenamento de blobs.

Data expira
expires string

Data em que a URL sas expira.

Data criada
created string

Data em que a URL sas foi criada.