Si ya estás utilizando la antigua versión de nuestra API para enviarnos tus pedidos y recoger opiniones de tus clientes, ten en cuenta que ya está disponible una nueva versión más eficaz.
¿Por qué cambiar a la nueva versión?
- La antigua API se desactivará próximamente: para seguir recogiendo opiniones sin interrupciones, es esencial migrar a la nueva versión en los próximos meses.
- Mejor rendimiento técnico.
- Pantallas de configuración rediseñadas: la configuración de la recogida de opiniones es ahora más intuitiva y accesible.
- Nueva página de seguimiento: visualiza fácilmente el estado de tus solicitudes de opinión.
- Gestión en autoservicio de los emails de solicitud: gana flexibilidad para personalizar tus envíos y adaptar tu estrategia de recogida.
¿Cómo saber qué versión de la API estás utilizando?
Compara las siguientes capturas de pantalla con el menú de tu cuenta de Opiniones Verificadas:
| ✨ Nueva versión de la API | 🖥️ Versión antigua de la API |
Una vez completada la migración, ya no tendrás acceso al historial de solicitudes de opinión vinculado a la antigua API. Asegúrate de exportar los datos si lo necesitas.
La nueva API no permite excluir productos específicos de la recogida de opiniones.
Implementar la nueva API
Sigue estos pasos:
- Primero, contacta con nuestro equipo: deben realizarse acciones técnicas desde nuestro lado.
- Una vez que nuestro equipo valide la solicitud, es esencial desactivar la llamada a la antigua API. Así evitarás duplicar los envíos de pedidos y no solicitarás a los clientes dos veces.
-
Cuando las nuevas páginas de configuración estén disponibles en tu cuenta
de Opiniones Verificadas, ve al menú lateral izquierdo
Recogida de opiniones, y luego a Configuración.
- A continuación, elige API en la barra de configuración.
- Haz clic en el botón para crear tu cuenta API.
- Una vez creada la cuenta, podrás ver los parámetros de tu API: URL, client ID y client secret.
- Luego, genera tu clave secreta haciendo clic en Ver clave.
Si lo necesitas, siempre podrás regenerar esta clave más adelante.
Estructurar y enviar la solicitud
La API de Skeepers utiliza OpenId Connect Client Credential grant para autenticar las solicitudes. Este método no autentica a un usuario específico, sino que verifica las credenciales y devuelve un access_token genérico.
Esta autorización (OpenId Connect Client Credential grant) se utiliza para la autenticación entre máquinas.
https://auth.skeepers.io/realms/skeepers/protocol/openid-connect/token
-
Authorization: Configura como
Basic <base64 encoded "clientId:clientSecret"> -
Content-Type: Configura como
application/x-www-form-urlencoded
-
grant_type: Configura como
client_credentials -
scope: Configura como
openid
POST https://auth.skeepers.io/realms/skeepers/protocol/openid-connect/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: Basic <base64 encoded "clientId:clientSecret">
grant_type="client_credentials" & scope="openid"
Haz clic en este enlace (Swagger) para acceder a la guía para configurar y simular tus solicitudes de prueba de compra o servicio. Aquí, en la sección Authentication, deberás añadir el identificador de tu sitio web:
Encontrar los códigos de integración
Para encontrar tu clave secreta y el identificador de tu sitio web:
- Ve al menú lateral izquierdo en Opiniones Verificadas
Gestión de cuenta, luego
Mis cuentas.
- La información se encuentra a la derecha de la página en la sección Código de integración.
Supervisar la recogida
Ahora tienes una nueva página de seguimiento de tus solicitudes de opinión. Esto te permite comprobar el envío de los pedidos/servicios y el estado de las solicitudes.
Para acceder, ve al menú lateral izquierdo Recogida de opiniones, y luego a Seguimiento de solicitudes.
Si solo quieres recoger opiniones Marca, elimina la variable de producto en tu llamada API.
Personaliza tus emails
La nueva versión de la API te permite usar el configurador de emails, ¡para que puedas personalizar tus solicitudes y mejorar la recogida!
Te
invitamos a
contactar con nuestro equipo
para hablar de la implementación.