Generar enlaces de invitación con las APIs de Trustpilot

Está función es parte del módulo adicional Connect.

Adquirir módulo

Puedes utilizar una API de Trustpilot para generar enlaces de invitación que puedes enviar a tus clientes a través de tus emails u otras formas de comunicación. En este artículo explicamos cómo generar enlaces de invitación únicos utilizando una API de Trustpilot.

Nota: Puede que necesites la ayuda de un desarrollador.

Encuentra tu Clave API y tu Clave secreta

Si tu cuenta tiene concedido el acceso a las APIs, puedes crear y gestionar tus claves API siguiendo los breves pasos que se indican a continuación o clicando directamente aquí.

  1. En Trustpilot Business, ve a Integraciones > Desarrolladores > APIs.
  2. En la sección Crear una nueva aplicación, asigna un nombre a tu aplicación e introduce todos los dominios que quieras incluir. Haz clic en Crear aplicación.
  3. Encontrarás la aplicación en Tus aplicaciones. Haz clic en el menú desplegable para expandir la aplicación y encontrar tu Clave API y tu Clave secreta.

Encuentra tu Business Unit ID (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". Ese es el BUID del dominio que has buscado.

Autentificación con OAuth 2.0

Para poder utilizar cualquier punto de conexión privado de la API en Trustpilot, es necesaria una autentificación en forma de token de acceso. Dado que la generación de enlaces de invitación se considera un punto de conexión privado, el objetivo aquí es obtener un token de acceso que puedas reutilizar para múltiples llamadas a la API mientras sea válido. Cuando caduque, podrás actualizar el token. Para consultar directamente nuestra documentación sobre la autentificación y obtener más información, echa un vistazo aquí.

Nota: Para las integraciones del lado del servidor, recomendamos utilizar Grant Type: Password.

Generar enlaces de invitación para Opiniones del Servicio

Una vez que tengas tu token de acceso, podrás utilizar nuestro punto de conexión de la API 'Generate service review invitation link'. Esta solicitud JSON de llamada a la API precisa del nombre del cliente, su email, localización y algún tipo de número de referencia, como p.ej. un número de pedido o de factura. Aquí tienes un ejemplo de una solicitud JSON completa:

    {
        "referenceId": "inv00001",
        "name": "Juan Pérez",
        "tags": [
          "tag1", 
          "Tag2"
        ],
        "locale": "es-ES",
        "email": "juan.perez@trustpilot.com", 
        "redirectUri": "http://trustpilot.com"
    }

Con esta llamada a la API recibirás un enlace de invitación único que puedes enviar directamente a tus clientes.

En la solicitud también podrás ver etiquetas opcionales y campos 'redirectUri'. La siguiente descripción general te ayudará a entenderlo:

Etiquetas opcionales

Se trata de datos adicionales específicos que conoces sobre el cliente o su compra. Al añadirlas antes de que se envíe la opinión, tus reseñas se etiquetarán con datos sumamente relevantes, lo que permitirá un análisis más detallado y una visualización de las opiniones altamente personalizada.

Los caracteres válidos son a-z, A-Z, 0-9, guion bajo, guion y punto. No se permiten espacios.

URI de redirección

Un "redirectUri" te permite redirigir al cliente a cualquier página web de tu elección una vez que envíe su opinión. Si no incluyes el "redirectUri", los autores de las opiniones serán dirigidos a la página de Trustpilot "Opinión enviada". Si deseas que vuelvan a una página personalizada de tu sitio web, como tu propia página de "agradecimiento" o simplemente tu página de inicio, tienes control absoluto sobre ello.

Asegúrate de utilizar una URL completa que incluya http/https (https://ejemplo.com sería válida, pero ejemplo.com no).