Tienes la posibilidad de enviar tus comprobantes de compra/servicio, de forma totalmente autónoma, gracias al método de automatización API.
Haz clic en la versión correspondiente a tu menú:
| ✨ Nueva Plataforma | 🖥️ Plataforma Histórica |
Otros métodos de automatización, como SFTP o CSV, también están disponibles. (haz clic en el método deseado para acceder al procedimiento)
✨ Nueva Plataforma
Requisitos previos
Te recomendamos que nos envíes los pedidos de los últimos 3 meses para recoger opiniones relevantes.
Configuración
Ve al menú lateral
Recogida de Opiniones, luego Configuración
Selecciona API en la barra de configuración.
Haz clic en el botón para crear tu cuenta API
Una vez creada la cuenta, puedes ver tu configuración API: URL, Identificador del sitio web y Clave secreta.
Genera tu clave secreta haciendo clic en Ver Clave.
Si tienes problemas, puedes regenerar esta clave.
Estructura y envía 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
Puedes verificar la transmisión e integración de tus pruebas de compra/servicio, así como el estado de las solicitudes de reseñas.
Para hacerlo, ve al menú lateral izquierdo Recogida de opiniones, luego Seguimiento de solicitudes de opinión.
Si quieres recopilar solo opiniones de marca, debes eliminar la variable producto de tu llamada a la API.
Más información en la documentación de la API: Submit Purchase Event > solicitation_parameters > purchase_event_type.