> ## Documentation Index
> Fetch the complete documentation index at: https://woku.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear una reseña de voz

> Crea una nueva reseña de voz (voicemail) para un woku con form data. Requiere la carga de un archivo de audio junto con una calificacion con estrellas. El audio se convertira automaticamente a formato MP4 y se transcribira.



## OpenAPI

````yaml /openapi.es.json post /wokus/create-voicemail
openapi: 3.0.3
info:
  title: Woku Client API
  description: >-
    API para integrarse con la plataforma de recoleccion de feedback de Woku.
    Esta API te permite crear wokus (herramientas de recoleccion de feedback),
    enviar reseñas y obtener reportes.


    ## Autenticacion


    Todos los endpoints requieren autenticacion mediante un token Bearer en el
    header Authorization. Puedes obtener tu API key desde el dashboard de Woku.


    ```

    Authorization: Bearer your_api_key_here

    ```


    ## Base URL


    Produccion: `https://api.woku.app`
  version: 1.0.0
  contact:
    name: Woku Support
    url: https://woku.app
    email: team@woku.app
servers:
  - url: https://clientapi.woku.app
    description: Servidor de produccion
security: []
tags:
  - name: Wokus
    description: >-
      Endpoints para crear y gestionar wokus (herramientas de recoleccion de
      feedback)
  - name: Reseñas
    description: Endpoints para enviar y obtener reseñas
  - name: Empresas
    description: Endpoints para obtener datos de la empresa
  - name: Reportes
    description: Endpoints para obtener reportes de NPS y analitica
paths:
  /wokus/create-voicemail:
    post:
      tags:
        - Wokus
      summary: Crear una reseña de voz
      description: >-
        Crea una nueva reseña de voz (voicemail) para un woku con form data.
        Requiere la carga de un archivo de audio junto con una calificacion con
        estrellas. El audio se convertira automaticamente a formato MP4 y se
        transcribira.
      operationId: createVoicemail
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/CreateVoicemailRequest'
      responses:
        '201':
          description: Voicemail creado correctamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoicemailResponse'
        '400':
          description: Error de validacion o archivo de audio ausente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '404':
          description: Woku no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
      security:
        - BearerAuth: []
components:
  schemas:
    CreateVoicemailRequest:
      type: object
      required:
        - file
        - wokuId
        - qualification
      properties:
        file:
          type: string
          format: binary
          description: >-
            Archivo de audio para el mensaje de voz (MP3, WAV, M4A, WebM, etc.).
            Se convertira automaticamente a MP4.
        wokuId:
          type: string
          format: objectid
          description: MongoDB ObjectId del woku al que se agrega la resena
          example: 507f1f77bcf86cd799439011
        qualification:
          type: string
          enum:
            - '1'
            - '2'
            - '3'
            - '4'
            - '5'
          description: Calificacion de estrellas del 1 al 5 (como string para form-data)
          example: '5'
        clientEmail:
          type: string
          format: email
          description: Direccion de correo de quien resena
          example: reviewer@example.com
        clientPhone:
          type: string
          description: Numero de telefono de quien resena
          example: '56912345678'
        anonymous:
          type: string
          enum:
            - 'true'
            - 'false'
          description: Si la resena debe ser anonima (como string para form-data)
          example: 'false'
    VoicemailResponse:
      type: object
      properties:
        _id:
          type: string
          format: objectid
          description: Identificador unico del voicemail
          example: 507f1f77bcf86cd799439019
        wokuId:
          type: string
          format: objectid
          description: ID del woku al que pertenece el voicemail
          example: 507f1f77bcf86cd799439011
        qualification:
          type: object
          properties:
            qualification:
              type: integer
              example: 4
        file:
          type: object
          properties:
            filename:
              type: string
              example: voicemail.mp4
            url:
              type: string
              format: uri
        transcription:
          type: string
          description: Transcripcion generada por IA
        anonymous:
          type: boolean
          example: false
        clientId:
          type: string
          format: objectid
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    ValidationError:
      type: object
      properties:
        statusCode:
          type: integer
          example: 400
        message:
          type: array
          items:
            type: string
          example:
            - description must be a string
            - fileUrl must be a valid URL
        error:
          type: string
          example: Bad Request
    NotFoundError:
      type: object
      properties:
        statusCode:
          type: integer
          example: 404
        message:
          type: string
          example: Resource not found
        error:
          type: string
          example: Not Found
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Clave de API de la empresa. Obtenla desde tu dashboard de Woku en
        Settings > API Keys.

````