# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Azure Communication Service Call Automation…
  version: 1.0.0
extends: openapi/microsoft-azure-preconnections-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: 4
- target: $.paths['/calling/callConnections'].post
  update:
    x-apievangelist-phrasing:
      intent: Place an outbound call
      effect: write
      questions:
      - How do I place an outbound phone or VoIP call from my Communication Services app?
      - Can I stream call media while making an outbound call?
      - Where do call events get delivered when I start an outbound call?
      instructions:
      - text: Call {targets} from {source} and send call events to {callbackUri}.
        slots:
          targets: requestBody.targets
          source: requestBody.source
          callbackUri: requestBody.callbackUri
      - text: Start an outbound call to {targets} with media streaming config {mediaStreamingConfiguration}.
        slots:
          targets: requestBody.targets
          mediaStreamingConfiguration: requestBody.mediaStreamingConfiguration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/callConnections:answer'].post
  update:
    x-apievangelist-phrasing:
      intent: Answer an incoming call
      effect: write
      questions:
      - How do I answer an incoming call that arrived through Event Grid?
      - Can my app pick up a call and receive its events on my own webhook?
      instructions:
      - text: Answer the incoming call {incomingCallContext} and send events to {callbackUri}.
        slots:
          incomingCallContext: requestBody.incomingCallContext
          callbackUri: requestBody.callbackUri
      - text: Pick up incoming call {incomingCallContext}.
        slots:
          incomingCallContext: requestBody.incomingCallContext
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/callConnections:redirect'].post
  update:
    x-apievangelist-phrasing:
      intent: Redirect an incoming call
      effect: write
      questions:
      - Can I forward an incoming call to another participant instead of answering it?
      - What do I need to redirect a ringing call to a different target?
      instructions:
      - text: Redirect incoming call {incomingCallContext} to {target}.
        slots:
          incomingCallContext: requestBody.incomingCallContext
          target: requestBody.target
      - text: Forward the ringing call to {target} without answering it.
        slots:
          target: requestBody.target
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/callConnections:reject'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject an incoming call
      effect: destructive
      questions:
      - How do I decline an incoming call in my calling app?
      - Can I give a reason such as busy when rejecting a call?
      instructions:
      - text: Reject incoming call {incomingCallContext}.
        slots:
          incomingCallContext: requestBody.incomingCallContext
      - text: Decline incoming call {incomingCallContext} with reason {callRejectReason}.
        slots:
          incomingCallContext: requestBody.incomingCallContext
          callRejectReason: requestBody.callRejectReason
      method: generated
      generated: '2026-09-26'