# 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 CustomerInsightsManagementClient…
  version: 1.0.0
extends: openapi/microsoft-azure-interactions-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/interactions/{interactionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Customer Insights interaction
      effect: read
      questions:
      - How do I see the definition of one interaction type in a Customer Insights hub?
      - Can I get an interaction's display names in a specific locale?
      instructions:
      - text: Show interaction {interactionName} in hub {hubName} of resource group {resourceGroupName}.
        slots:
          interactionName: path.interactionName
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
      - text: Get interaction {interactionName} from hub {hubName} in subscription {subscriptionId} using locale {locale}.
        slots:
          interactionName: path.interactionName
          hubName: path.hubName
          subscriptionId: path.subscriptionId
          locale: query.locale-code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/interactions/{interactionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a hub interaction
      effect: write
      questions:
      - How do I define a new interaction type in my Customer Insights hub?
      - Can I change an existing interaction's schema?
      instructions:
      - text: Create interaction {interactionName} in hub {hubName} of resource group {resourceGroupName} with properties {properties}.
        slots:
          interactionName: path.interactionName
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
          properties: requestBody.properties
      - text: Update the existing interaction {interactionName} in hub {hubName}, subscription {subscriptionId}.
        slots:
          interactionName: path.interactionName
          hubName: path.hubName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/interactions'].get
  update:
    x-apievangelist-phrasing:
      intent: List interactions in a Customer Insights hub
      effect: read
      questions:
      - Which interaction types are defined in my Customer Insights hub?
      - Can I list all hub interactions with names localized to my language?
      instructions:
      - text: List all interactions in hub {hubName} of resource group {resourceGroupName}.
        slots:
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
      - text: Show hub {hubName} interactions in subscription {subscriptionId} with locale {locale}.
        slots:
          hubName: path.hubName
          subscriptionId: path.subscriptionId
          locale: query.locale-code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/interactions/{interactionName}/suggestRelationshipLinks'].post
  update:
    x-apievangelist-phrasing:
      intent: Suggest relationship links for an interaction
      effect: read
      questions:
      - How can I get suggested relationship links for an interaction?
      - Can Customer Insights recommend which profiles an interaction should link to?
      instructions:
      - text: Suggest relationship links for interaction {interactionName} in hub {hubName} of resource group {resourceGroupName}.
        slots:
          interactionName: path.interactionName
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
      - text: Recommend links to create for interaction {interactionName} in subscription {subscriptionId}.
        slots:
          interactionName: path.interactionName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'