Trustpilot

Trustpilot é uma plataforma de avaliações online que permite que os clientes compartilhem feedback e que você gerencie e responda a avaliações.

Esta página fornece um guia passo a passo para:

• Criar convites para avaliações usando a API de criação de convite do Trustpilot
• Personalizar mensagens com avaliações de produtos por meio da API de avaliações de produtos do Trustpilot

Pré-requisitos

Antes de começar, você precisará do seguinte:

Integração

Etapa 1: Obtenha suas credenciais da API do Trustpilot

1. Faça login no Trustpilot com suas credenciais.
2. Crie ou recupere a chave e o segredo da API no dashboard do Trustpilot acessando Integrations > Developers > APIs. Se você ainda não tiver uma chave de API, crie uma nova:
   1. Acesse Application Name > Create Application
   2. Copie sua chave e segredo da API, que serão usados para autenticar suas solicitações de Conteúdo conectado.

Enviando convites para avaliações do Trustpilot

Etapa 1: Configure uma campanha de webhook na Braze

Configure uma campanha de webhook na Braze baseada em ações para acionar as APIs do Trustpilot e enviar convites de avaliação por e-mail aos usuários. Por exemplo, você pode enviar um convite para avaliação após um usuário fazer um pedido com os seguintes detalhes do webhook:

• URL do webhook: https://invitations-api.trustpilot.com/v1/private/business-units/{businessUnitId}/email-invitations
• Método: POST
• Adicione as informações relevantes do cliente como pares chave-valor

Etapa 2: Recupere o token de acesso

1. Use Conteúdo conectado para fazer uma solicitação ao endpoint de autenticação do Trustpilot para recuperar o token de acesso.
2. Use o tipo de concessão client_credentials e insira sua chave de API e segredo em uma tag de Conteúdo conectado para recuperar um token. A solicitação de Conteúdo conectado pode ser inserida no cabeçalho da solicitação. O Conteúdo conectado pode ficar assim:

1
2
3
4
5
6
7
8
9
10
11
{% connected_content
https://api.trustpilot.com/v1/oauth/oauth-business-users-for-applications/accesstoken
:method post
:headers {"Content-Type": "application/x-www-form-urlencoded", "Authorization": "Basic {{'API_KEY:API_SECRET' | base64_encode}}" }
:body grant_type=client_credentials
:save token
:retry
:cache_max_age 3600 %}

{{token.access_token}}

3. Adicione o token de acesso ao cabeçalho da solicitação da sua campanha de webhook.

Personalizando mensagens com insights de avaliações de produtos

Na sua campanha na Braze, faça uma chamada de Conteúdo conectado para solicitar dados do endpoint de resumo de avaliações de produtos do Trustpilot (https://api.trustpilot.com/v1/product-reviews/business-units/{businessUnitId}). Esse método recupera avaliações de produtos para SKUs específicos da unidade de negócios. O exemplo a seguir especifica o SKU do produto e filtra por avaliações de cinco estrelas.

1
2
3
4
{% connected_content https://api.trustpilot.com/v1/product-reviews/business-units/66ea0530xxxxxx/reviews?sku={{event_properties.${item_sku}}}&stars=5
   :method get
   :headers {"apikey": "xxxxx"}
   :content_type application/json :save result %}

A solicitação de Conteúdo conectado retornará as avaliações de produtos.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
  {
   "productReviews": [
       {
           "id": "670d5810ba62e6b31de97de9",
           "createdAt": "2024-10-14T17:42:40.286Z",
           "stars": 5,
           "content": "Such a great toy truck, my kids really enjoy it! ",
           "consumer": {
               "id": "6176xxxx",
               "displayName": "Kevin Bob"
           },
           "language": "en",
           "attributeRatings": [],
           "attachments": [],
           "firstCompanyComment": null
       }
   ],
   "links": []

2. Use a sintaxe Liquid para puxar o conteúdo relevante para sua mensagem. Por exemplo, para puxar o conteúdo da avaliação do produto, use a Liquid tag {{result.productReviews[0].content}}.