# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Brand Call Data API
  version: 1.0.0
extends: openapi/impact-call-data-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: 2
- target: $.paths['/calldata/logCallData'].get
  update:
    x-apievangelist-phrasing:
      intent: Log a tracked phone call via query string
      effect: write
      questions:
      - How do I send call tracking data to impact.com with a simple GET URL?
      - Can I report call duration and talk time as query parameters?
      instructions:
      - text: 'GET-log call {session} ({provider}): campaign {campaign}, partner {media}, tracker {tracker}, {date}, {caller} to {called}, {dur}s, {talk}s talk.'
        slots:
          session: query.CallSessionId
          provider: query.CallProvider
          campaign: query.CampaignId
          media: query.MediaId
          tracker: query.ActionTrackerId
          date: query.EventDate
          caller: query.CallerId
          called: query.CalledPhoneNumber
          dur: query.CallDuration
          talk: query.TalkDuration
      - text: Send call {session} with a sale amount of {sale} through the GET call-logging URL.
        slots:
          session: query.CallSessionId
          sale: query.SaleAmount
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calldata/logCallData'].post
  update:
    x-apievangelist-phrasing:
      intent: Log a tracked phone call via form post
      effect: write
      questions:
      - Can I post call tracking data as a form-encoded body instead of a URL?
      - Which fields are required when posting a phone call event?
      instructions:
      - text: 'POST call {session} from {provider}: campaign {campaign}, partner {media}, tracker {tracker}, {date}, caller {caller} to {called}, {dur}s, talk {talk}s.'
        slots:
          session: requestBody.CallSessionId
          provider: requestBody.CallProvider
          campaign: requestBody.CampaignId
          media: requestBody.MediaId
          tracker: requestBody.ActionTrackerId
          date: requestBody.EventDate
          caller: requestBody.CallerId
          called: requestBody.CalledPhoneNumber
          dur: requestBody.CallDuration
          talk: requestBody.TalkDuration
      - text: Submit call {session} in a form body with disposition {disp}.
        slots:
          session: requestBody.CallSessionId
          disp: requestBody.DispositionName
      method: generated
      generated: '2026-09-26'