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

# Crear Análisis

> Upload an audio file to create a new call analysis request.

**Supported audio formats**: MP3, WAV, M4A, FLAC, OGG, WEBM

The analysis process runs asynchronously. Poll the GET endpoint or configure webhooks
to receive completion notifications.

**Processing stages**:
1. Audio conversion and validation
2. Speech-to-text transcription
3. Quality analysis and scoring
4. Summary and insights generation



## OpenAPI

````yaml POST /v1/call-analysis
openapi: 3.0.2
info:
  title: Neuracall API
  description: >-

    ## Overview


    The Neuracall API provides powerful call analysis capabilities for contact
    centers and customer service teams.

    Submit audio recordings and receive detailed analysis including:


    - **Transcription**: Accurate speech-to-text conversion

    - **Quality Scoring**: Automated evaluation against customizable criteria

    - **Insights & Keywords**: AI-extracted conversation highlights

    - **Statistics**: Aggregated performance metrics


    ## Authentication


    All API endpoints (except `/v1/auth`) require a Bearer token. Obtain your
    token using the Authentication endpoint with your client credentials.


    ```

    Authorization: Bearer <your_access_token>

    ```


    ## Support


    For questions or issues, contact support@neuracall.com
        
  contact:
    name: Neuracall Support
    url: https://neuracall.com/support
    email: support@neuracall.com
  license:
    name: Proprietary
    url: https://neuracall.com/license
  version: 1.0.0
servers: []
security: []
tags:
  - name: Authentication
    description: >-
      Obtain access tokens to authenticate your application. Required before
      making other API calls.
  - name: Analysis Models
    description: >-
      Manage analysis models that define evaluation criteria and scoring
      parameters for call analysis.
  - name: Model Categories
    description: >-
      Manage categories within analysis models. Categories group related
      evaluation variables and help organize the scoring structure.
  - name: Model Variables
    description: >-
      Manage evaluation variables within analysis models. Variables define
      specific scoring criteria used during call analysis.
  - name: Model Metadata
    description: >-
      Manage metadata fields within analysis models. Metadata defines additional
      information required when submitting calls for analysis (e.g., campaign,
      department).
  - name: Call Analysis
    description: >-
      Submit audio recordings for analysis and retrieve results including
      transcriptions, scores, and insights.
  - name: Statistics
    description: >-
      Retrieve aggregated statistics and performance metrics from analyzed calls
      for dashboards and reporting.
paths:
  /v1/call-analysis:
    post:
      tags:
        - Call Analysis
      summary: Submit a call recording for analysis
      description: >-
        Upload an audio file to create a new call analysis request.


        **Supported audio formats**: MP3, WAV, M4A, FLAC, OGG, WEBM


        The analysis process runs asynchronously. Poll the GET endpoint or
        configure webhooks

        to receive completion notifications.


        **Processing stages**:

        1. Audio conversion and validation

        2. Speech-to-text transcription

        3. Quality analysis and scoring

        4. Summary and insights generation
      operationId: Create_Call_Analysis_v1_call_analysis_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: >-
                #/components/schemas/Body_Create_Call_Analysis_v1_call_analysis_post
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallAnalysisResponse'
        '400':
          description: Invalid request or unsupported file format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    Body_Create_Call_Analysis_v1_call_analysis_post:
      title: Body_Create_Call_Analysis_v1_call_analysis_post
      required:
        - external_id
        - agent_id
        - agent_name
        - model_name
        - audio_file
      type: object
      properties:
        external_id:
          title: External Id
          type: string
          description: Your unique identifier for this call (e.g., CRM call ID)
        agent_id:
          title: Agent Id
          type: string
          description: Identifier of the agent who handled the call
        agent_name:
          title: Agent Name
          type: string
          description: Display name of the agent
        model_name:
          title: Model Name
          type: string
          description: Name of the analysis model to use for evaluation
        additional_parameters:
          title: Additional Parameters
          type: string
          description: JSON string with custom metadata (e.g., campaign, department)
        audio_file:
          title: Audio File
          type: string
          description: Audio file to analyze (MP3, WAV, M4A, FLAC, OGG, WEBM)
          format: binary
    CallAnalysisResponse:
      title: CallAnalysisResponse
      required:
        - id
        - external_id
        - status
        - enabled
        - created_at
        - created_by
      type: object
      properties:
        id:
          title: Id
          type: string
          description: Unique identifier for this analysis
          format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
        external_id:
          title: External Id
          type: string
          description: Your reference ID for this call
          example: CALL-2024-001234
        agent_id:
          title: Agent Id
          type: string
          description: Identifier of the agent who handled the call
          example: AGT-001
        agent_name:
          title: Agent Name
          type: string
          description: Display name of the agent
          example: John Smith
        model_id:
          title: Model Id
          type: integer
          description: ID of the analysis model used for evaluation
          example: 1
        status:
          allOf:
            - $ref: '#/components/schemas/CallAnalysisRequestStatus'
          description: 'Current processing status: PENDING, PROCESSING, COMPLETED, or FAILED'
        error_message:
          title: Error Message
          type: string
          description: Error details if status is FAILED
        original_file_name:
          title: Original File Name
          type: string
          description: Name of the uploaded audio file
          example: support_call_20240115.mp3
        additional_parameters:
          title: Additional Parameters
          type: object
          description: Custom metadata provided during submission
          example:
            campaign: Q4_Retention
            department: Support
        analysis_result:
          title: Analysis Result
          type: object
          description: Extracted variables and data from the analysis
        neurascore_result:
          title: Neurascore Result
          type: array
          items:
            $ref: '#/components/schemas/Category'
          description: Detailed scoring breakdown organized by evaluation categories
        total_score:
          title: Total Score
          type: integer
          description: Total achieved score across all categories
          example: 425
        expected_score:
          title: Expected Score
          type: integer
          description: Maximum possible total score
          example: 500
        score_percentage:
          title: Score Percentage
          type: number
          description: Overall achievement percentage (0-100)
          example: 85
        summary:
          title: Summary
          type: string
          description: AI-generated summary of the conversation
          example: >-
            The agent handled a billing inquiry efficiently, resolving the
            customer's concern about an unexpected charge.
        insights:
          title: Insights
          type: array
          items:
            type: string
          description: Key observations and recommendations from the analysis
          example:
            - Agent demonstrated excellent product knowledge
            - Consider offering proactive follow-up
        keywords:
          title: Keywords
          type: array
          items:
            type: string
          description: Key topics and themes discussed in the call
          example:
            - billing
            - refund
            - subscription
            - satisfaction
        enabled:
          title: Enabled
          type: boolean
          description: Whether this record is active
          example: true
        created_at:
          title: Created At
          type: string
          description: Timestamp when analysis was created (UTC)
          format: date-time
        created_by:
          title: Created By
          type: string
          description: System identifier that created this record
        updated_at:
          title: Updated At
          type: string
          description: Timestamp of last update (UTC)
          format: date-time
        updated_by:
          title: Updated By
          type: string
          description: System identifier that last updated this record
      description: Complete call analysis result with scores, insights, and metadata
    ErrorResponse:
      title: ErrorResponse
      required:
        - code
        - message
      type: object
      properties:
        code:
          title: Code
          type: string
          description: Error code for programmatic handling
          example: 001-001-0001
        path:
          title: Path
          type: string
          description: Field path for validation errors
          example: body.external_id
        message:
          title: Message
          type: string
          description: Human-readable error message
          example: The requested resource was not found
      description: Standard error response format for API errors
      example:
        code: 001-001-0001
        message: The requested resource was not found
    CallAnalysisRequestStatus:
      title: CallAnalysisRequestStatus
      enum:
        - PENDING
        - AUDIO_CONVERSION_IN_PROGRESS
        - AUDIO_CONVERTED
        - AUDIO_TRANSCRIPTION_IN_PROGRESS
        - AUDIO_TRANSCRIBED
        - TRANSCRIPTION_ANALYZE_IN_PROGRESS
        - TRANSCRIPTION_ANALYZED
        - TRANSCRIPTION_SUMMARIZE_IN_PROGRESS
        - TRANSCRIPTION_SUMMARIZED
        - TRANSCRIPTION_FAILED
        - PROCESS_COMPLETED
        - ERROR
      description: An enumeration.
    Category:
      title: Category
      required:
        - id
        - name
        - total_score
        - expected_total_score
        - score_percentage
        - expected_score_percentage
        - variables
      type: object
      properties:
        id:
          title: Id
          type: string
          description: Unique identifier for this category
          format: uuid
        name:
          title: Name
          type: string
          description: Category name
          example: Opening
        total_score:
          title: Total Score
          type: integer
          description: Sum of achieved scores in this category
          example: 45
        expected_total_score:
          title: Expected Total Score
          type: integer
          description: Sum of maximum possible scores in this category
          example: 50
        score_percentage:
          title: Score Percentage
          type: number
          description: Achievement percentage for this category
          example: 90
        expected_score_percentage:
          title: Expected Score Percentage
          type: number
          description: Expected percentage (usually 100)
          example: 100
        variables:
          title: Variables
          type: array
          items:
            $ref: '#/components/schemas/Variable'
          description: List of scoring variables in this category
      description: Scoring category containing related evaluation variables
    Variable:
      title: Variable
      required:
        - id
        - key
        - readable_name
        - description
        - score
        - expected_score
      type: object
      properties:
        id:
          title: Id
          type: string
          description: Unique identifier for this variable
          format: uuid
        key:
          title: Key
          type: string
          description: Variable key used in analysis configuration
          example: greeting_quality
        readable_name:
          title: Readable Name
          type: string
          description: Human-readable name for display
          example: Greeting Quality
        description:
          title: Description
          type: string
          description: Explanation of what this variable measures
          example: Evaluates the warmth and professionalism of the agent's greeting
        score:
          title: Score
          type: integer
          description: Achieved score for this variable
          example: 8
        expected_score:
          title: Expected Score
          type: integer
          description: Maximum possible score for this variable
          example: 10
      description: Individual scoring variable within a category
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````