Los wokus son las unidades clave para capturar y gestionar reseñas de clientes dentro de la plataforma woku. A través de esta API, puedes automatizar la creación de wokus para calificarlos, captura reseñas y compartirlos con tus clientes. A continuación, te presentamos las solicitudes principales que facilitan estas tareas:
- Crear un woku: Permite generar un nuevo woku dentro de tu aplicación.
- Crear un woku con form-data: Envío de datos en formato form-data para la creación de wokus.
- Obtención de los datos de un woku: Obtienes los datos de un woku, sus calificaciones y reseñas.
- Califica y captura una reseña de texto en un woku: Captura la calificación y reseña en texto de un cliente en un woku.
- Califica y captura una reseña de audio en un woku: Captura la calificación y reseña en audio de un cliente en un woku.
- Compartir un woku por email: Facilita el envío de wokus directamente por correo electrónico. Permite envío de correos electrónicos masivos.
Crear un woku desde tu aplicación
Una funcionalidad importante para integrar dentro de tu aplicación es la creación de un woku. Esto permetirá automatizar la tarea de crear una herramienta para capturar reseñas sin necesidad de pedirle al administrador que lo haga mediante la interfaz de woku.
Para crear un woku, envía una solicitud POST a la siguiente URL:
Headers necesarios
- Content-Type: application/json
- Authorization: Bearer <Company-Key>
Ejemplo de cuerpo de la solicitud (JSON)
Estructuras de datos del body para la petición
- description* (string): Obligatorio. Mínimo 3 y máximo 140 caracteres.
- fileUrl* (string): Obligatorio. URL de acceso público para una imagen o video (preferentemente .mp4).
- folderSecondaryKey (string): Opcional. Clave secundaria de la carpeta donde se almacenará el woku.
- parentFolderSecondaryKey (string): Opcional. Clave secundaria de la carpeta principal. No puede ser la misma que folderSecondaryKey.
- clientEmail (string): Opcional. Debe ser un correo electrónico válido.
Respuestas esperadas
- 201 Created woku object: El woku fue creado con éxito.
- 500 Internal Server Error: Ocurrió un error en el servidor.
Crear un woku con Form Data desde tu aplicación
A veces, es útil permitir a los usuarios crear un woku a través de una interfaz donde puedan subir imágenes o videos como archivos. Para ello, se proporciona un método que permite la creación de un woku utilizando form-data.
Para crear un woku con form-data, envía una solicitud POST a la siguiente URL:
Headers necesarios
- Content-Type: multipart/form-data
- Authorization: Bearer <Company-Key>
Estructuras de datos para la solicitud (form-data)
- description* (string): Obligatorio. Mínimo 3 y máximo 140 caracteres.
- file* ($binary): Obligatorio. Debe ser un archivo de imagen o video. Para videos, se recomienda usar archivos con la extensión .mp4.
- folderSecondaryKey (string): Opcional. Clave secundaria de la carpeta donde se almacenará el woku.
- parentFolderSecondaryKey (string): Opcional. Clave secundaria de la carpeta principal. No puede ser la misma que folderSecondaryKey.
- clientEmail (string): Opcional. Debe ser un correo electrónico válido.
Respuestas esperadas
- 201 Created woku object: El woku fue creado con éxito.
- 500 Internal Server Error: Ocurrió un error en el servidor.
Obtener los datos de un woku
Este método permite consultar los datos de un woku, incluidas sus calificaciones y reseñas. Puedes utilizar esta funcionalidad para acceder a la información detallada de un woku existente.
Para obtener los datos de un woku, envía una solicitud GET a la siguiente URL:
Headers necesarios
- Content-Type: application/json
- Authorization: Bearer <Company-Key>
Parámetros
- wokuId* (string): Obligatorio. El identificador único del woku que deseas consultar.
Respuestas esperadas
- 200 Data of the woku review successfully obtained: Se devuelve el objeto del woku con éxito.
- 500 Internal Server Error: Ocurrió un error en el servidor.
Calificar y capturar una reseña en texto en un woku
Este método permite agregar una reseña escrita y una calificación a un woku. Es útil para capturar comentarios en texto de los clientes sobre sus experiencias.
Para crear una nota de texto en un woku, envía una solicitud POST a la siguiente URL:
Headers necesarios
- Content-Type: application/json
- Authorization: Bearer <Company-Key>
Ejemplo de cuerpo de la solicitud (JSON)
Estructuras de datos para la solicitud
- wokuId* (string): Obligatorio. El ID del woku al que se agregará la nota.
- qualification* (number): Obligatorio. Un valor entero entre 1 y 5 que representa la calificación.
- description* (string): Obligatorio. El comentario o reseña escrita por el cliente, con un máximo de 255 caracteres.
- clientEmail (string): Opcional. Correo electrónico del cliente que deja la reseña. Si no se proporciona, el campo anonymous debe ser true.
- anonymous (boolean): Opcional. Indica si el feedback es anónimo.
Respuestas esperadas
- 201 Created textnote object: La calificación y reseña fue creada con éxito.
- 500 Internal Server Error: Ocurrió un error en el servidor.
Calificar y capturar una reseña en audio en un woku
Este método permite que un cliente califique y deje una reseña en formato de mensaje de voz para un woku.
Para crear un mensaje de voz, envía una solicitud POST a la siguiente URL:
Headers necesarios
- Content-Type: multipart/form-data
- Authorization: Bearer <Company-Key>
Cuerpo de la solicitud (form-data)
- file* ($binary): Obligatorio. Archivo de audio o video. Extensiones recomendadas .mp4 o .wav.
- wokuId* (string): Obligatorio. El ID del woku al que se agregará el mensaje de voz.
- qualification* (number): Obligatorio. Un número entre 1 y 5 que representa la calificación.
- clientEmail (string): Opcional. Correo electrónico del cliente que deja la reseña. Si no se proporciona, el campo anonymous debe ser true.
- anonymous (boolean): Opcional. Indica si el feedback es anónimo (true o false).
Respuestas esperadas
- 201 Created voicemail object: La calificación y reseña fue creada con éxito.
- 500 Internal Server Error: Ocurrió un error en el servidor.
Compartir un woku por correo electrónico
Este método permite compartir un woku por correo electrónico a uno o varios destinatarios. Es ideal para difundir reseñas de forma rápida y eficiente.
Para compartir un woku por correo, envía una solicitud POST a la siguiente URL:
Headers necesarios
- Content-Type: application/json
- Authorization: Bearer <Company-Key>
Cuerpo de la solicitud (JSON)
Para enviar a un destinatario:
O para múltiples destinatarios:
Estructuras de datos para la solicitud
- wokuId* (string): Obligatorio. El ID del woku que se desea compartir.
- clientEmail (string): Opcional. Correo electrónico del destinatario.
- clientEmails (string array): Opcional. Lista de correos electrónicos de los destinatarios.
Respuestas esperadas
- 201 Email sent successfully: El correo fue enviado con éxito.
- 500 Internal Server Error: Ocurrió un error en el servidor.
Contacto y Soporte
Contacto
- Diego Orrego Brito, CTO de woku.
- Correo electrónico: diego@woku.app (Por favor, incluye el nombre de la empresa en el asunto y menciona que se trata de la API).
Errores Comunes y Soluciones
URL de archivo inaccesible
Asegúrate de que la URL del archivo proporcionado sea accesible públicamente. Nuestro servicio necesita poder acceder al archivo para crear el woku.
Clave secundaria
La clave secundaria se utiliza para crear una carpeta donde se almacenará el woku. Si no se proporciona una clave secundaria, el woku se mantendrá a nivel de la empresa. No pueden existir dos carpetas con la misma clave secundaria dentro de una misma empresa.