API Evangelist conversational phrasing for Twilio Voice API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio Voice API
  version: 1.0.0
extends: openapi/twilio-voice-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 12
- target: $.paths['/v1/Voice/Settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Check Voice Insights settings
      effect: read
      questions:
      - Is Voice Insights Advanced Features turned on for my account?
      - Can I see whether Voice Trace is enabled for one of my subaccounts?
      instructions:
      - text: Show my current Voice Insights settings.
      - text: Show the Voice Insights settings for subaccount {subaccount}.
        slots:
          subaccount: query.SubaccountSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Voice/Settings'].post
  update:
    x-apievangelist-phrasing:
      intent: Change Voice Insights settings
      effect: write
      questions:
      - How do I switch on Voice Insights Advanced Features?
      - Can I enable Voice Trace for just one subaccount?
      instructions:
      - text: Turn Voice Insights Advanced Features {advanced} for my account.
        slots:
          advanced: requestBody.AdvancedFeatures
      - text: Set Voice Trace to {voice_trace} on subaccount {subaccount}.
        slots:
          voice_trace: requestBody.VoiceTrace
          subaccount: requestBody.SubaccountSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Voice/{CallSid}/Annotation'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the annotation on a call
      effect: read
      questions:
      - What feedback did we record against a particular call, like its score or quality issues?
      - Was a given call already flagged as spam or tied to an incident?
      instructions:
      - text: Show the annotation recorded for call {call}.
        slots:
          call: path.CallSid
      - text: Get the call score and comment we left on call {call}.
        slots:
          call: path.CallSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Voice/{CallSid}/Annotation'].post
  update:
    x-apievangelist-phrasing:
      intent: Annotate a call with feedback
      effect: write
      questions:
      - How do I mark a call as spam in Voice Insights?
      - Can I give a call a 1 to 5 experience score and link it to a support ticket?
      - Which quality problems can I tag on a call, like echo or choppy audio?
      instructions:
      - text: Score call {call} as {score} out of 5.
        slots:
          call: path.CallSid
          score: requestBody.CallScore
      - text: Flag call {call} as spam.
        slots:
          call: path.CallSid
      - text: Tag call {call} with quality issue {issues} and link it to incident {incident}.
        slots:
          call: path.CallSid
          issues: requestBody.QualityIssues
          incident: requestBody.Incident
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Voice/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a call in Voice Insights
      effect: read
      questions:
      - Can I pull up the Voice Insights record for a single call by its SID?
      - Where do I find the insights entry point for one specific call?
      instructions:
      - text: Fetch the Voice Insights call record {call}.
        slots:
          call: path.Sid
      - text: Open insights call {call} so I can see its links to events and metrics.
        slots:
          call: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Voice/Summaries'].get
  update:
    x-apievangelist-phrasing:
      intent: Search call summaries across my account
      effect: read
      questions:
      - Which of my calls in the last day had dropped-call or echo problems?
      - Can I filter call summaries by carrier, country or whether SHAKEN/STIR verified the caller?
      - What calls did answering machine detection mark as a machine this week?
      instructions:
      - text: List call summaries from {from} to {to} over the last {start_time}.
        slots:
          from: query.From
          to: query.To
          start_time: query.StartTime
      - text: Find calls with call state {state} and direction {direction}.
        slots:
          state: query.CallState
          direction: query.Direction
      - text: Show every call annotated as spam in subaccount {subaccount}.
        slots:
          subaccount: query.Subaccount
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Voice/{CallSid}/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List signaling events for a call
      effect: read
      questions:
      - What events happened during a call, step by step?
      - Can I see only the SIP edge events for a call?
      instructions:
      - text: List the insight events for call {call}.
        slots:
          call: path.CallSid
      - text: Show the {edge} events for call {call}.
        slots:
          edge: query.Edge
          call: path.CallSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Voice/{CallSid}/Metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: List quality metrics for a call
      effect: read
      questions:
      - Where do I get jitter and packet loss style metrics for a single call?
      - Can I split a call's metrics by inbound versus outbound direction?
      instructions:
      - text: List the call metrics for call {call}.
        slots:
          call: path.CallSid
      - text: Show {direction} metrics on the {edge} for call {call}.
        slots:
          direction: query.Direction
          edge: query.Edge
          call: path.CallSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Voice/{CallSid}/Summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the summary of one call
      effect: read
      questions:
      - How did a specific call go overall, duration, parties and quality?
      - Can I get a partial summary for a call that just ended?
      instructions:
      - text: Get the call summary for call {call}.
        slots:
          call: path.CallSid
      - text: Include only {processing_state} processing when summarizing call {call}.
        slots:
          processing_state: query.ProcessingState
          call: path.CallSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/Voice/Countries'].get
  update:
    x-apievangelist-phrasing:
      intent: List countries with voice pricing
      effect: read
      questions:
      - Which countries have voice calling prices published?
      - What countries can I look up call rates for?
      instructions:
      - text: List all countries with voice pricing.
      - text: Show the voice pricing country list, {page_size} per page.
        slots:
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/Voice/Countries/{IsoCountry}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get voice call prices for a country
      effect: read
      questions:
      - What does it cost to make and receive calls in Germany?
      - Where can I see inbound and outbound voice rates for one country?
      instructions:
      - text: Show voice pricing for country {country}.
        slots:
          country: path.IsoCountry
      - text: Get the per-minute call rates for {country}.
        slots:
          country: path.IsoCountry
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/Voice/Numbers/{DestinationNumber}'].get
  update:
    x-apievangelist-phrasing:
      intent: Price a call to a phone number
      effect: read
      questions:
      - How much will it cost to call a specific phone number?
      - Does the price of a call change depending on which of my numbers I call from?
      instructions:
      - text: Get the voice price for calling {destination}.
        slots:
          destination: path.DestinationNumber
      - text: Get the price of calling {destination} from {origination}.
        slots:
          destination: path.DestinationNumber
          origination: query.OriginationNumber
      method: generated
      generated: '2026-09-26'