Trustpilot
Trustpilot é uma plataforma de avaliações online que permite que os clientes compartilhem feedback e permite 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 através da API de Avaliações de Produtos do Trustpilot
Pré-requisitos
Antes de começar, você precisará do seguinte:
Pré-requisito | Descrição |
---|---|
Uma conta do Trustpilot | Você precisa de uma conta do Trustpilot com acesso à API do Trustpilot. |
Uma chave de autenticação do Trustpilot | Você precisará configurar uma chave de API e solicitar um token de acesso. |
Integração
Etapa 1: Obtenha suas credenciais da API do Trustpilot
- Faça login no Trustpilot com suas credenciais.
- Crie ou recupere a chave e o segredo da API no painel do Trustpilot acessando Integrações > Desenvolvedores > APIs. Se você ainda não tiver uma chave de API, crie uma nova:
- Acesse Nome da Aplicação > Criar Aplicação
- Copie sua chave de API e segredo, 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 do Braze
Configure uma campanha de webhook do Braze baseada em ações para acionar as APIs do Trustpilot para 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: Recuperar o token de acesso
- Use Conteúdo Conectado para fazer uma solicitação ao Ponto de Autenticação do Trustpilot para recuperar o Token de Acesso.
- 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 parecer 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.
Consulte a documentação do Trustpilot para obter instruções mais detalhadas.
Personalizando mensagens com insights de avaliações de produtos
Na sua campanha Braze, faça uma chamada de Conteúdo Conectado para solicitar dados do Ponto de resumo de avaliações de produtos do Trustpilot (https://api.trustpilot.com/v1/product-reviews/business-units/{businessUnitId}
). Este método recupera avaliações de produtos para SKUs específicos da unidade de negócios. O seguinte exemplo especifica o SKU do produto específico 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 tag Liquid {{result.productReviews[0].content}}
.