API Evangelist conversational phrasing for LINE Messaging API() Insight API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for LINE Messaging API() Insight API
  version: 1.0.0
extends: openapi/line-insight-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: 7
- target: $.paths['/v2/bot/insight/demographic'].get
  update:
    x-apievangelist-phrasing:
      intent: Get friend demographics for an Official Account
      effect: read
      questions:
      - What are the age, gender and region breakdowns of my LINE Official Account's friends?
      - Which countries' Official Accounts can retrieve friend demographic data?
      instructions:
      - text: Show the demographic attributes of my Official Account's friends.
      - text: Get the friend demographics breakdown for this account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/insight/message/delivery'].get
  update:
    x-apievangelist-phrasing:
      intent: Count messages delivered on a given day
      effect: read
      questions:
      - How many messages did my Official Account send in total on a specific day?
      - Can I see total message deliveries across all send types for one date?
      instructions:
      - text: Get the total number of message deliveries on {date}.
        slots:
          date: query.date
      - text: Count all messages my account delivered on {date}.
        slots:
          date: query.date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/insight/followers'].get
  update:
    x-apievangelist-phrasing:
      intent: Count followers as of a date
      effect: read
      questions:
      - How many users had added my Official Account as a friend by a certain date?
      - What was my follower count on a past day?
      instructions:
      - text: Get my follower count as of {date}.
        slots:
          date: query.date
      - text: Show how many people have added my Official Account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/insight/message/event'].get
  update:
    x-apievangelist-phrasing:
      intent: Get interaction stats for a broadcast or narrowcast
      effect: read
      questions:
      - How did users interact with a narrowcast or broadcast message I sent?
      - Can I see open and click statistics for one broadcast by its request ID?
      instructions:
      - text: Get user interaction statistics for broadcast or narrowcast request {requestId}.
        slots:
          requestId: query.requestId
      - text: Show opens and clicks for the message sent with request ID {requestId}.
        slots:
          requestId: query.requestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/insight/message/event/aggregation'].get
  update:
    x-apievangelist-phrasing:
      intent: Get interaction stats for an aggregation unit
      effect: read
      questions:
      - How are users engaging with push and multicast messages I tagged with a custom aggregation unit?
      - What's the longest date range I can request for per-unit statistics?
      instructions:
      - text: Get per-unit statistics for unit {customAggregationUnit} from {from} to {to}.
        slots:
          customAggregationUnit: query.customAggregationUnit
          from: query.from
          to: query.to
      - text: Show how users interacted with messages in aggregation unit {customAggregationUnit} between {from} and {to}.
        slots:
          customAggregationUnit: query.customAggregationUnit
          from: query.from
          to: query.to
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/insight/richmenu/{richMenuId}/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Summarize rich menu impressions and clicks
      effect: read
      questions:
      - How many impressions and area clicks did my rich menu get in total over a period?
      - Why does the rich menu summary sometimes return only the rich menu ID?
      instructions:
      - text: Get the total impression and click summary for rich menu {richMenuId} from {from} to {to}.
        slots:
          richMenuId: path.richMenuId
          from: query.from
          to: query.to
      - text: Summarize performance of rich menu {richMenuId} over the whole period {from} to {to}.
        slots:
          richMenuId: path.richMenuId
          from: query.from
          to: query.to
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/insight/richmenu/{richMenuId}/daily'].get
  update:
    x-apievangelist-phrasing:
      intent: Get daily rich menu impressions and clicks
      effect: read
      questions:
      - Can I see my rich menu's impressions and clicks broken down day by day?
      - Which days did people tap each area of my rich menu most?
      instructions:
      - text: Get daily impression and click counts for rich menu {richMenuId} from {from} to {to}.
        slots:
          richMenuId: path.richMenuId
          from: query.from
          to: query.to
      - text: Break down rich menu {richMenuId} stats per day between {from} and {to}.
        slots:
          richMenuId: path.richMenuId
          from: query.from
          to: query.to
      method: generated
      generated: '2026-09-26'