Partilhar via


Dynamics 365 Commerce - Classificações e avaliações

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

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

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Commerce-Ratings e avaliações do Dynamics 365
URL https://dynamics.microsoft.com/en-us/support/
Email d365ratingreviewconn@microsoft.com
Metadados do conector
Editora Microsoft
Sítio Web https://dynamics.microsoft.com/en-us/commerce/overview/
Política de privacidade https://privacy.microsoft.com/privacystatement
Categorias Comércio; Gestão Empresarial

O conector Dynamics 365 Commerce - Ratings and Reviews fornece um conjunto de ações para interagir com as APIs do Dynamics 365 Ratings and Review Service. Essas ações facilitam a importação e a exportação de dados de avaliações. Duas ações estão disponíveis: Exportar todas as avaliações e Enviar uma avaliação.

Pré-requisitos

Você precisará do seguinte para prosseguir:

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

O primeiro passo é registrar o conector como um aplicativo no Microsoft Entra ID. Isso permite que o conector se identifique com a ID do Microsoft Entra e peça permissões para acessar os dados de Classificações e Avaliações em nome do usuário final. Leia mais sobre isso aqui e siga os passos abaixo:

1. Crie um aplicativo Microsoft Entra ID:

Este aplicativo Microsoft Entra ID será usado para identificar a conexão do conector com Classificações e Avaliações. Isso pode ser feito usando o Portal do Azure, seguindo as etapas aqui para registrar um aplicativo no Microsoft Entra ID 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 Microsoft Entra ID criado, ele agora pode ser usado para obter permissões de usuários finais. Use os campos que você salvou para estabelecer uma conexão autenticada por meio da entidade de serviço usando o Dynamics 365 Commerce - Ratings and Reviews Connector.

O próximo passo é registrar este aplicativo na página de configurações da ferramenta de moderação de avaliações e avaliações.

2. Registre o aplicativo Microsoft Entra ID na Ferramenta de moderação de avaliações e avaliações

Para que o serviço Classificações e Avaliações autentique operações provenientes do conector, os clientes devem registrar seu aplicativo Microsoft Entra ID 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 Service to Service (S2S). Para obter mais detalhes sobre como gerenciar as configurações de Classificações e avaliações a partir da Ferramenta de moderação, consulte aqui.

Introdução ao conector

Para começar a usar o Dynamics 365 Commerce - Ratings and Reviews Connector, 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 avaliações.

Nota: O Dynamics 365 Commerce - Ratings and Reviews Connector estará disponível em todas as regiões do Power Automatic, mas as Classificações e Avaliações apenas processarão chamadas em regiões suportadas pelo seu inquilino. Certifique-se de revisar os requisitos de conformidade para sua organização e criar o ambiente Power Automate em uma região que atenda às necessidades de conformidade.

FAQ

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

    O comprimento máximo do título de uma avaliaçã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 encodedUser 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 do 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ão de importação.

  • Preciso de mais apoio. A quem posso contactar?

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

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Enviar revisão do usuário

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

Exportar todos os comentários

Exporte todas as avaliações como um URL SAS para download.

Enviar revisão do usuário

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

Parâmetros

Name Chave Necessário Tipo Description
ID do produto
productId True string

Especifique o ID do produto que está sendo revisado.

ID do locatário RnR
tenantId True string

Especifique o ID do seu locatário RnR.

ID do canal
channelId string

Especifique o ID do canal para esta revisão.

Mercado
market string

Especifique o mercado associado a esta revisão.

Localidade
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 para o formato de bloco JSON contendo o nome de usuário, e-mail e Id.

Rating
Rating True string

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

Title
Title True string

Especifique o título da revisão.

Texto de revisão
ReviewText True string

Especifique o corpo de texto da revisão.

Sku
Sku string

Especifique o número SKU do produto analisado.

Nome do Produto
ProductName True string

Especifique o nome do produto revisado

LegalEntity
LegalEntity string

Especifique a entidade legal.

Propriedades Ampliadas
ExtendedProperties object

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

enviadoDataHora
submittedDateTime string

Especifique a data-hora enviada da sua revisão no formato UTC (o padrão é a hora UTC atual).

Devoluções

O ID de revisão da revisão enviada.

Exportar todos os comentários

Exporte todas as avaliações como um URL SAS para download.

Parâmetros

Name Chave Necessário Tipo Description
ID do locatário RnR
tenantId True string

Especifique o ID do seu locatário RnR.

Devoluções

Definições

SubmitReviewResponse

O ID de revisão da revisão enviada.

O ID de revisão da revisão enviada.

ID da revisão
string

ExportSuccessfulResponse

Name Caminho Tipo Description
Blob SAS Url
blobSasUrl string

O URL SAS gerado a partir do armazenamento de blobs.

Data expira
expires string

Data em que o URL SAS expira.

Data de Criação
created string

Data em que o URL SAS foi criado.