Activación de invitaciones 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 activar el envío por parte de Trustpilot de las Invitaciones para Opiniones del Servicio. En esta guía se explica cómo configurarlo.

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 activación de invitaciones se considera un punto de conexión privado, el objetivo aquí es obtener primero 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.

Activación de una invitación a opinar sobre el servicio

Una vez que tengas tu token de acceso, podrás utilizar nuestro punto de conexión de la API "Create invitation(s)". Esta solicitud JSON de llamada a la API precisa del nombre del cliente, su email y algún tipo de número de referencia, como p.ej. un número de pedido o de factura. También hay una serie de opciones para el remitente que puedes personalizar. Aquí tienes un ejemplo de una solicitud JSON:

    {
      "consumerEmail": "juan.lopez@trustpilot.com",
      "consumerName": "Juan López",
      "referenceNumber": "inv00001",
      "replyTo": "juan.lopez@trustpilot.com",
      "locale": "es-ES",
      "senderEmail": "juan.lopez@trustpilot.com",
      "serviceReviewInvitation": {
      "preferredSendTime": "2013-09-07T13:37:00",
      "redirectUri": "http://trustpilot.com",
      "tags": [
        "tag1",
        "tag2"
      ],
      "templateId": "507f191e810c19729de860ea"
     },
      "locationId": "ABC123",
      "senderName": "Juan López"
    }

Las llamadas a la API que se realicen correctamente pondrán en cola las invitaciones en Trustpilot Business, que puedes ver iniciando sesión en tu cuenta y consultando tu historial de invitaciones.

Nota: No pasa nada por omitir algunas de las opciones para el remitente, como “senderEmail”, “templateId” o “preferredSendTime” - este punto de conexión de la API utilizará automáticamente la configuración habilitada en la Configuración de invitaciones dentro de Trustpilot Business.

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).