WhatsApp Business Management API — Analytics

naftiko: 1.0.0-alpha2
info:
  label: WhatsApp Business Management API — Analytics
  description: 'WhatsApp Business Management API — Analytics. 2 operations. Lead operation: WhatsApp Get Conversation Analytics.
    Self-contained Naftiko capability covering one Whatsapp business surface.'
  tags:
  - Whatsapp
  - Analytics
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WHATSAPP_API_KEY: WHATSAPP_API_KEY
capability:
  consumes:
  - type: http
    namespace: business-management-analytics
    baseUri: https://graph.facebook.com/v21.0
    description: WhatsApp Business Management API — Analytics business capability. Self-contained, no shared references.
    resources:
    - name: waba-id-conversation_analytics
      path: /{waba-id}/conversation_analytics
      operations:
      - name: getconversationanalytics
        method: GET
        description: WhatsApp Get Conversation Analytics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: start
          in: query
          type: string
          description: Start time (Unix timestamp or YYYY-MM-DD)
          required: true
        - name: end
          in: query
          type: string
          description: End time (Unix timestamp or YYYY-MM-DD)
          required: true
        - name: granularity
          in: query
          type: string
          required: true
        - name: phone_numbers
          in: query
          type: array
          description: Filter by phone number IDs
        - name: metric_types
          in: query
          type: array
        - name: conversation_categories
          in: query
          type: array
        - name: dimensions
          in: query
          type: array
    - name: waba-id-template_analytics
      path: /{waba-id}/template_analytics
      operations:
      - name: gettemplateanalytics
        method: GET
        description: WhatsApp Get Template Analytics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: start
          in: query
          type: string
          required: true
        - name: end
          in: query
          type: string
          required: true
        - name: granularity
          in: query
          type: string
          required: true
        - name: template_ids
          in: query
          type: array
          description: Template IDs to analyze (max 10)
          required: true
        - name: metric_types
          in: query
          type: array
    authentication:
      type: bearer
      token: '{{env.WHATSAPP_API_KEY}}'
  exposes:
  - type: rest
    namespace: business-management-analytics-rest
    port: 8080
    description: REST adapter for WhatsApp Business Management API — Analytics. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/{waba-id}/conversation-analytics
      name: waba-id-conversation-analytics
      description: REST surface for waba-id-conversation_analytics.
      operations:
      - method: GET
        name: getconversationanalytics
        description: WhatsApp Get Conversation Analytics
        call: business-management-analytics.getconversationanalytics
        with:
          start: rest.start
          end: rest.end
          granularity: rest.granularity
          phone_numbers: rest.phone_numbers
          metric_types: rest.metric_types
          conversation_categories: rest.conversation_categories
          dimensions: rest.dimensions
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{waba-id}/template-analytics
      name: waba-id-template-analytics
      description: REST surface for waba-id-template_analytics.
      operations:
      - method: GET
        name: gettemplateanalytics
        description: WhatsApp Get Template Analytics
        call: business-management-analytics.gettemplateanalytics
        with:
          start: rest.start
          end: rest.end
          granularity: rest.granularity
          template_ids: rest.template_ids
          metric_types: rest.metric_types
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: business-management-analytics-mcp
    port: 9090
    transport: http
    description: MCP adapter for WhatsApp Business Management API — Analytics. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: whatsapp-get-conversation-analytics
      description: WhatsApp Get Conversation Analytics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: business-management-analytics.getconversationanalytics
      with:
        start: tools.start
        end: tools.end
        granularity: tools.granularity
        phone_numbers: tools.phone_numbers
        metric_types: tools.metric_types
        conversation_categories: tools.conversation_categories
        dimensions: tools.dimensions
      outputParameters:
      - type: object
        mapping: $.
    - name: whatsapp-get-template-analytics
      description: WhatsApp Get Template Analytics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: business-management-analytics.gettemplateanalytics
      with:
        start: tools.start
        end: tools.end
        granularity: tools.granularity
        template_ids: tools.template_ids
        metric_types: tools.metric_types
      outputParameters:
      - type: object
        mapping: $.