Trustpilot
Trustpilot es una plataforma de opiniones en línea que habilita a los clientes a compartir opiniones y te permite administrar y responder a las opiniones.
Esta página proporciona una guía paso a paso para:
- Crear invitaciones de revisión utilizando la API de creación de invitaciones de Trustpilot
- Personalización de mensajes con reseñas de productos a través de la API de reseñas de productos de Trustpilot
Requisitos previos
Antes de empezar, necesitarás lo siguiente:
Requisito previo | Descripción |
---|---|
Una cuenta Trustpilot | Necesitas una cuenta de Trustpilot con acceso a la API de Trustpilot. |
Una clave de autenticación de Trustpilot | Tendrás que configurar una clave de API y solicitar un token de acceso. |
Integración
Paso 1: Consigue tus credenciales API de Trustpilot
- Inicia sesión en Trustpilot con tus credenciales.
- Crea o recupera la clave de API y el secreto en el panel de Trustpilot yendo a Integraciones > Desarrolladores > APIs. Si aún no tienes una clave de API, crea una nueva:
- Ve a Nombre de la aplicación > Crear aplicación
- Copia tu clave de API y tu secreto, que se utilizarán para autenticar tus solicitudes de Contenido Conectado.
Enviar invitaciones de revisión de Trustpilot
Paso 1: Configurar una campaña de webhook Braze
Configura una campaña webhook Braze basada en acciones para desencadenar que las API de Trustpilot envíen invitaciones de revisión por correo electrónico a los usuarios. Por ejemplo, podrías enviar una invitación de revisión después de que un usuario realice un pedido con los siguientes detalles del webhook:
- URL del webhook:
https://invitations-api.trustpilot.com/v1/private/business-units/{businessUnitId}/email-invitations
- Método: POST
- Añade la información relevante del cliente como pares clave-valor
Paso 2: Recuperar el token de acceso
- Utiliza Contenido conectado para realizar una solicitud al punto final de autenticación de Trustpilot para recuperar el token de acceso.
- Utiliza el tipo de concesión client_credentials e introduce tu clave de API y tu secreto en una etiqueta de Contenido conectado para recuperar un token. La solicitud de contenido conectado puede introducirse en el encabezado de solicitud. El Contenido conectado puede tener este aspecto:
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. Añade el token de acceso al encabezado de solicitud de tu campaña webhook.
Consulta la documentación de Trustpilot para obtener instrucciones más detalladas.
Personalización de mensajes con información sobre la revisión de productos
En tu campaña Braze, haz una llamada a Contenido conectado para solicitar datos al punto final Obtener resumen de reseñas de productos de Trustpilot (https://api.trustpilot.com/v1/product-reviews/business-units/{businessUnitId}
). Este método recupera revisiones de productos para SKU específicas de la unidad de negocio. El siguiente ejemplo especifica el SKU concreto del producto y filtra las opiniones de cinco estrellas.
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 %}
La solicitud de Contenido conectado devolverá las reseñas de los productos.
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. Utiliza la sintaxis Liquid para introducir el contenido relevante en tu mensaje. Por ejemplo, para extraer el contenido de la revisión del producto, utiliza la etiqueta de Liquid {{result.productReviews[0].content}}
.