For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
WebsiteStatusSupportDashboard
DocumentationAPI ReferenceMCPSDKsCLI (new)What's New?
DocumentationAPI ReferenceMCPSDKsCLI (new)What's New?
  • Get started
    • Introduction
    • Phone calls
    • Web calls
    • Vapi Guides
    • Composer
    • CLI quickstart
  • Assistants
    • Quickstart
    • Tools
    • Custom keywords
    • Custom voices
    • Custom transcriber
    • Custom TTS
  • Observability
    • Boards
  • Squads
    • Quickstart
    • Overview
    • Handoff tool
    • Passing data between assistants
  • Best practices
    • Prompting guide
    • Debugging voice agents
    • Enterprise environments (DEV/UAT/PROD)
    • IVR navigation
  • Phone numbers
    • Free Vapi number
    • Inbound SMS
    • Phone Number Hooks
  • Calls
    • Call end reasons
    • Troubleshoot call errors
      • Call analysis
      • Call recording
  • Outbound Campaigns
    • Quickstart
    • Overview
  • Chat
    • Quickstart
    • Streaming
    • Non-streaming
    • OpenAI compatibility
    • Session management
    • Variable substitution
    • SMS chat
    • Web widget
    • Webhooks
  • Workflows
    • Quickstart
    • Overview
LogoLogo
WebsiteStatusSupportDashboard
On this page
  • Overview
  • Customization
  • Summary prompt
  • Structured data prompt
  • Structured data schema
  • Success evaluation prompt
  • Success evaluation rubric
  • Combine prompts and rubrics
  • Results
CallsCall insights

Call analysis

Summarize and evaluate calls automatically
Was this page helpful?
Edit this page
Previous

Call recording, logging and transcribing

Record, log, and transcribe calls using artifact plans
Next
Built with

Overview

Call analysis automatically summarizes and evaluates every call for insights and quality control. As soon as a call ends, analysis is triggered in the background and typically completes within a few seconds. The system uses the latest version of Anthropic’s Claude Sonnet (with OpenAI GPT-4o as fallback) to:

  • Summarize the call
  • Extract structured data
  • Evaluate call success

Results are attached to the call record and can be viewed in the call instance dashboard or retrieved via the API. You can customize the analysis using prompts and schemas in your assistant’s analysisPlan.

Customization

You can customize the following properties in your assistant’s analysisPlan:

Summary prompt

  • Used to create a concise summary of the call, stored in call.analysis.summary.
  • Default prompt:
    You are an expert note-taker. You will be given a transcript of a call. Summarize the call in 2-3 sentences, if applicable.
  • Customize:
    1{
    2 "summaryPrompt": "Custom summary prompt text"
    3}
  • Disable:
    1{
    2 "summaryPrompt": ""
    3}

Structured data prompt

  • Extracts specific data from the call, stored in call.analysis.structuredData.
  • Default prompt:
    You are an expert data extractor. You will be given a transcript of a call. Extract structured data per the JSON Schema.
  • Customize:
    1{
    2 "structuredDataPrompt": "Custom structured data prompt text"
    3}

Structured data schema

  • Defines the format of extracted data using JSON Schema.
  • Customize:
    1{
    2 "structuredDataSchema": {
    3 "type": "object",
    4 "properties": {
    5 "field1": { "type": "string" },
    6 "field2": { "type": "number" }
    7 },
    8 "required": ["field1", "field2"]
    9 }
    10}

Success evaluation prompt

  • Used to determine if the call was successful, stored in call.analysis.successEvaluation.
  • Default prompt:
    You are an expert call evaluator. You will be given a transcript of a call and the system prompt of the AI participant. Determine if the call was successful based on the objectives inferred from the system prompt.
  • Customize:
    1{
    2 "successEvaluationPrompt": "Custom success evaluation prompt text"
    3}
  • Disable:
    1{
    2 "successEvaluationPrompt": ""
    3}

Success evaluation rubric

  • Defines the criteria for evaluating call success. Options:
    • NumericScale: 1 to 10
    • DescriptiveScale: Excellent, Good, Fair, Poor
    • Checklist: List of criteria
    • Matrix: Grid of criteria and performance
    • PercentageScale: 0% to 100%
    • LikertScale: Strongly Agree to Strongly Disagree
    • AutomaticRubric: Auto breakdown by criteria
    • PassFail: true/false
  • Customize:
    1{
    2 "successEvaluationRubric": "NumericScale"
    3}

Combine prompts and rubrics

  • You can combine prompts and rubrics for detailed instructions:
    1{
    2 "successEvaluationPrompt": "Evaluate the call based on these criteria:...",
    3 "successEvaluationRubric": "Checklist"
    4}

Results

  • Once analysis is complete, results are attached to the call record.
  • View results in the call instance dashboard or retrieve them via the API.
  • Results include:
    • Call summary
    • Structured data
    • Success evaluation and rubric

By customizing these properties, you can tailor call analysis to your needs and gain valuable insights from every call.