curl --request POST \
--url https://clientapi.woku.app/wokus/create-woku \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "Experiencia de Servicio al Cliente - Tienda #123",
"fileUrl": "https://cdn.example.com/images/product-image.jpg"
}
'{
"_id": "507f1f77bcf86cd799439011",
"description": "Customer Service Experience - Store #123",
"createdBy": "507f1f77bcf86cd799439012",
"companyId": "507f1f77bcf86cd799439013",
"folderId": "507f1f77bcf86cd799439014",
"file": {
"filename": "product-image.webp",
"type": "image",
"url": "https://cdn.woku.app/files/product-image.webp"
},
"qualifications": [
{
"_id": "507f1f77bcf86cd799439015",
"qualification": 5,
"createdBy": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"textnotes": [
{
"_id": "507f1f77bcf86cd799439016",
"qualification": {
"qualification": 5
},
"description": "Excellent service!",
"anonymous": false,
"feedbackType": "positive",
"clientId": "<string>",
"validated": true,
"createdAt": "2023-11-07T05:31:56Z"
}
],
"voicemails": [
{
"_id": "507f1f77bcf86cd799439017",
"qualification": {
"qualification": 4
},
"file": {
"filename": "voicemail.mp4",
"url": "<string>"
},
"transcription": "I had a great experience with your service...",
"anonymous": false,
"feedbackType": "positive",
"clientId": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"feedbacksSummary": "Customers generally praise the helpful staff and quick service...",
"closed": false,
"createdAt": "2026-01-20T10:30:00.000Z",
"updatedAt": "2026-01-20T15:45:00.000Z"
}{
"statusCode": 400,
"message": [
"description must be a string",
"fileUrl must be a valid URL"
],
"error": "Bad Request"
}{
"statusCode": 401,
"message": "Invalid or missing API key"
}Crear un woku mediante URL
Crea un nuevo woku para la recoleccion de feedback usando la URL de un archivo. El archivo se descargara y procesara automaticamente. Opcionalmente, puedes asociar un correo o numero de telefono de cliente para enviar una invitacion a dejar una reseña.
curl --request POST \
--url https://clientapi.woku.app/wokus/create-woku \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "Experiencia de Servicio al Cliente - Tienda #123",
"fileUrl": "https://cdn.example.com/images/product-image.jpg"
}
'{
"_id": "507f1f77bcf86cd799439011",
"description": "Customer Service Experience - Store #123",
"createdBy": "507f1f77bcf86cd799439012",
"companyId": "507f1f77bcf86cd799439013",
"folderId": "507f1f77bcf86cd799439014",
"file": {
"filename": "product-image.webp",
"type": "image",
"url": "https://cdn.woku.app/files/product-image.webp"
},
"qualifications": [
{
"_id": "507f1f77bcf86cd799439015",
"qualification": 5,
"createdBy": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"textnotes": [
{
"_id": "507f1f77bcf86cd799439016",
"qualification": {
"qualification": 5
},
"description": "Excellent service!",
"anonymous": false,
"feedbackType": "positive",
"clientId": "<string>",
"validated": true,
"createdAt": "2023-11-07T05:31:56Z"
}
],
"voicemails": [
{
"_id": "507f1f77bcf86cd799439017",
"qualification": {
"qualification": 4
},
"file": {
"filename": "voicemail.mp4",
"url": "<string>"
},
"transcription": "I had a great experience with your service...",
"anonymous": false,
"feedbackType": "positive",
"clientId": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"feedbacksSummary": "Customers generally praise the helpful staff and quick service...",
"closed": false,
"createdAt": "2026-01-20T10:30:00.000Z",
"updatedAt": "2026-01-20T15:45:00.000Z"
}{
"statusCode": 400,
"message": [
"description must be a string",
"fileUrl must be a valid URL"
],
"error": "Bad Request"
}{
"statusCode": 401,
"message": "Invalid or missing API key"
}Autorizaciones
Clave de API de la empresa. Obtenla desde tu dashboard de Woku en Settings > API Keys.
Cuerpo
Descripcion del woku (producto, servicio o experiencia que se resena)
1"Customer Service Experience - Store #123"
URL de un archivo existente (imagen o video) para asociar al woku
"https://cdn.example.com/images/product-image.jpg"
Identificador de clave secundaria de la carpeta. Si la carpeta no existe, se creara automaticamente.
"store-123"
Identificador de clave secundaria de la carpeta padre. Se usa para crear jerarquias de carpetas.
"region-north"
Direccion de correo del cliente. Si se proporciona, se enviara un correo de invitacion a resenar.
"customer@example.com"
Numero de telefono del cliente (incluyendo el codigo de pais, sin espacios ni simbolos). Si se proporciona, se enviara una invitacion por WhatsApp a resenar.
56912345678
Respuesta
Woku creado correctamente
Identificador unico del woku
"507f1f77bcf86cd799439011"
Descripcion del woku
"Customer Service Experience - Store #123"
ID del usuario que creo el woku
"507f1f77bcf86cd799439012"
ID de la empresa a la que pertenece el woku
"507f1f77bcf86cd799439013"
ID de la carpeta en la que esta organizado el woku
"507f1f77bcf86cd799439014"
Show child attributes
Show child attributes
Arreglo de calificaciones de estrellas
Show child attributes
Show child attributes
Arreglo de resenas de texto
Show child attributes
Show child attributes
Arreglo de resenas de voz
Show child attributes
Show child attributes
Resumen generado por IA de todo el feedback
"Customers generally praise the helpful staff and quick service..."
Si el woku esta cerrado para nuevas resenas
Marca de tiempo de creacion
"2026-01-20T10:30:00.000Z"
Marca de tiempo de la ultima actualizacion
"2026-01-20T15:45:00.000Z"