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/ |
| 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.
- response
- SubmitReviewResponse
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
- Corpo
- ExportSuccessfulResponse
Definições
SubmitReviewResponse
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. |