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/ |
| 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:
- Assinatura do Microsoft Dynamics 365 Commerce
- Detalhes da solução Classificações e avaliações ativadas
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.
- response
- SubmitReviewResponse
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
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. |