Saltar al contenido principal
POST
Captura una reseña de woku o una respuesta NPS desde el SDK móvil

Autorizaciones

x-woku-key
string
header
requerido

Clave publicable de captura (pk_...), solo endpoints de captura.

Encabezados

authorization
string
requerido
x-woku-idempotency-key
string
requerido

Cuerpo

kind
enum<string>
requerido
Opciones disponibles:
woku,
nps,
csat,
ces
Ejemplo:

"woku"

collectionKind
enum<string>

Procedencia de recolección. Las entradas históricas que la omiten conservan un contexto desconocido y no activan seguimiento.

Opciones disponibles:
standalone,
flow
flowId
string<ObjectId>

Obligatorio para capturas de Flow; se valida contra la empresa y el instrumento.

dispatchToken
string

Token opaco de invitación o respuesta de una entrada preparada del viaje. Se consume después de guardar feedback; nunca se almacena en la reseña.

Maximum string length: 64
id
string

Id de idempotencia generado por el cliente

language
enum<string>

Idioma hablado. Requerido cuando la captura incluye un archivo de audio.

Opciones disponibles:
es,
en
targetId
string

Id de destino: el wokuId para una captura de woku, el npsToolId (opcional) para una captura de NPS, o el csatToolId/cesToolId (requerido) para una captura de CSAT/CES (esas herramientas siempre son personalizadas).

rating
number

Calificación por estrellas de Woku 1-5

Ejemplo:

5

score
number

Puntuación de NPS 0-10

Ejemplo:

9

comment
string

Comentario de texto libre

Maximum string length: 3000
audio
object
respondent
object

Respuesta

Captura aceptada

kind
enum<string>
requerido
Opciones disponibles:
woku,
nps,
csat,
ces
status
enum<string>
requerido
Opciones disponibles:
accepted
id
string

ID del envío del cliente, devuelto sin reemplazar el ID del servidor.

remoteId
string

ID del feedback creado en el servidor.