Cómo crear un TrustBox personalizado con las APIs de Trustpilot

Esta función forma parte del módulo adicional Connect y puede comprarse para los planes Premium y Advanced, y está incluido en el plan Enterprise.

Si deseas crear un TrustBox personalizado para mostrar tus opiniones y valoraciones de Trustpilot en tu sitio web, puedes hacerlo utilizando nuestras APIs. Sigue leyendo para descubrir cómo empezar.

Esta configuración requiere determinados conocimientos técnicos, así que no dudes en pedir ayuda a tu desarrollador.

Business Units

Antes de empezar a mostrar el contenido de las Opiniones de Trustpilot, es importante saber cómo identificamos los dominios a través de los Business Unit ID, también conocidos como BUID. La Business Unit, o unidad de negocio, es el punto de recolección de todo el contenido de Trustpilot para un sitio web. En otras palabras, la Business Unit aloja la valoración de una empresa, sus opiniones y las respuestas de la empresa. El BUID es un identificador único para esa Business Unit y es la clave principal en muchas de tus llamadas a la API. Puedes obtener más información acerca de los BUID aquí.

Cómo encontrar un BUID

Tu Business Unit ID es un identificador único, específico para tu dominio. Es estático y solo cambia si tu dominio en Trustpilot cambia. Para encontrar el BUID de tu dominio, debes utilizar el punto de conexión (endpoint) "Find a business unit". El parámetro requerido aquí es el "nombre" de la unidad de negocio, es decir, el dominio de tu sitio web. Por ejemplo, para buscar el BUID de Trustpilot, tendrías que escribir "trustpilot.com".

Prueba a hacerlo. Acuérdate de reemplazar la clave API.

https://api.trustpilot.com/v1/business-units/find?apikey={{apikey}}&name=trustpilotdemo.com

Cuando hayas recibido la respuesta, busca el campo "id". Este es el BUID del dominio que has buscado.

Cómo extraer opiniones


Una vez que tengas el BUID de tu dominio, puedes empezar a extraer tus opiniones, valoraciones y tus respuestas a esas opiniones utilizando la llamada a la API Get a business unit’s reviews.


Si solo deseas obtener la información pública sobre la Business Unit (es decir, la valoración en estrellas, el número de opiniones, el TrustScore, etc), estos datos están disponibles en el punto de conexión Find a business unit indicado anteriormente. También puedes utilizar Get public business unit.

Directrices para Integraciones personalizadas


Para asegurarte de que cumples con nuestras directrices, te sugerimos que consultes nuestro documento de asistencia detallado sobre las APIs de Trustpilot - Directrices para la integración de Opiniones del Servicio.

He aquí algunos puntos clave:

  • Siempre debes especificar qué reseñas estás mostrando. Por ejemplo, si muestras opiniones de 4 y 5 estrellas.
  • No expongas tu clave API en el 'frontend'. Esto significa que solo deberías hacer llamadas a la API desde el 'backend' y luego pasar los datos al 'frontend' para su visualización.
  • Para evitar problemas de limitación de velocidad, no realices una llamada a la API cada vez que se cargue la página: guarda los datos en tu caché y actualízalos cada 30 minutos/1 hora/24 horas, etc. También puedes aprovechar nuestros webhooks para actualizar las opiniones en tiempo real.
  • El texto de tu TrustBox no debería ser indexable por Google. Esto ayuda a evitar que las penalizaciones por contenido duplicado perjudiquen tu clasificación en los motores de búsqueda. En su lugar, aloja tus widgets en una página separada (por ejemplo, un subdominio) donde tengas una etiqueta <meta name="robots" content="noindex"> en la cabecera. Desde ahí, puedes utilizar un <iframe> para mostrar el TrustBox en tu sitio web principal.

Llamadas a la API por parte del servidor

Todas las llamadas a la API deben realizarse desde el lado del servidor para garantizar la seguridad. Al hacerlo, te asegurarás de que tu clave API privada no quede expuesta en tu sitio web y también puede ayudar a mejorar la velocidad de carga de la página/disminuir los costes de la red.

Almacenamiento de llamadas en caché

Cuando muestres los TrustBoxes personalizados en tu sitio, te recomendamos que almacenes los datos en la memoria caché. El almacenamiento en caché aumenta el rendimiento y la fiabilidad. El rendimiento aumenta porque el origen de los datos almacenados en caché puede estar más cerca del consumidor y la memoria caché puede procesar solicitudes de datos duplicadas, ahorrando cálculos innecesarios y tráfico de red. La fiabilidad aumenta porque el consumidor de datos está aislado de las interrupciones del servicio desde el origen.

Related articles