> ## Documentation Index
> Fetch the complete documentation index at: https://smsmanager.cz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Získání analytiky konverzací

> Vrací analytiku konverzací (počty a náklady) dané WABA. Časové značky jsou v sekundách Unix epochy; výchozí rozsah je posledních 30 dní.



## OpenAPI

````yaml /openapi/waba_rest/waba_restapi_v1.yaml post /whatsapp/analytics/conversations
openapi: 3.1.0
info:
  title: WhatsApp Business Partner API
  description: >
    API pro registraci a správu WhatsApp Business účtů (WABA): vestavěná
    registrace (embedded signup), telefonní čísla, šablony zpráv a analytika.


    ## Autentizace


    Požadavky jsou autentizovány buď vaším API klíčem v HTTP hlavičce
    `x-api-key`, nebo — v případě hostovaného registračního procesu —
    krátkodobým polem `token` v těle požadavku (získaným z `/whatsapp/signup`,
    platným 1 hodinu).


    ## Konvence odpovědí


    Selhání na úrovni byznys logiky (neznámá WABA, zamítnutí ze strany Meta,
    neautentizovaný požadavek) jsou vracena jako HTTP `200` s `{ "success":
    false, "message": "..." }`. HTTP chybové stavové kódy (`400`, `401`, `500`)
    se používají pouze pro chybějící povinná pole a neočekávané chyby.
  version: v1
  contact:
    url: https://smsmanager.com
    email: cc@smsmanager.com
servers:
  - url: https://rest-api.smsmngr.com/v1
    description: Produkční server
security:
  - x-api-key: []
tags:
  - name: waba
    x-displayName: WhatsApp účty
    x-group: WhatsApp účty
    description: |
      Vestavěná registrace a správa připojených WhatsApp Business účtů.
  - name: waba-numbers
    x-displayName: Telefonní čísla
    x-group: Telefonní čísla
    description: |
      Správa a ověřování WhatsApp telefonních čísel.
  - name: waba-templates
    x-displayName: Šablony zpráv
    x-group: Šablony zpráv
    description: |
      Vytváření, úprava, mazání a testování šablon WhatsApp zpráv.
  - name: waba-analytics
    x-displayName: Analytika
    x-group: Analytika
    description: |
      Analytika zpráv, konverzací a šablon dané WABA.
paths:
  /whatsapp/analytics/conversations:
    post:
      tags:
        - waba-analytics
      summary: Získání analytiky konverzací
      description: >-
        Vrací analytiku konverzací (počty a náklady) dané WABA. Časové značky
        jsou v sekundách Unix epochy; výchozí rozsah je posledních 30 dní.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - waba_id
              properties:
                waba_id:
                  type: string
                token:
                  type: string
                  description: Registrační token (alternativní autentizace).
                start:
                  type: integer
                  description: Začátek rozsahu (Unix sekundy). Výchozí je před 30 dny.
                end:
                  type: integer
                  description: Konec rozsahu (Unix sekundy). Výchozí je nyní.
                granularity:
                  type: string
                  enum:
                    - HALF_HOUR
                    - DAILY
                    - MONTHLY
                  default: DAILY
                phone_numbers:
                  type: array
                  items:
                    type: string
                country_codes:
                  type: array
                  items:
                    type: string
                metric_types:
                  type: array
                  items:
                    type: string
                  description: Metriky, které se mají vrátit.
                  default:
                    - COST
                    - CONVERSATION
                conversation_categories:
                  type: array
                  items:
                    type: string
                  description: >-
                    Filtrování podle kategorie: `MARKETING`, `UTILITY`,
                    `AUTHENTICATION`, `SERVICE`.
                conversation_types:
                  type: array
                  items:
                    type: string
                  description: 'Filtrování podle typu: `FREE_ENTRY`, `FREE_TIER`, `REGULAR`.'
                conversation_directions:
                  type: array
                  items:
                    type: string
                  description: >-
                    Filtrování podle směru: `BUSINESS_INITIATED`,
                    `USER_INITIATED`.
                dimensions:
                  type: array
                  items:
                    type: string
                  default:
                    - CONVERSATION_CATEGORY
                    - CONVERSATION_TYPE
            example:
              waba_id: '1234567890'
              granularity: DAILY
              conversation_categories:
                - MARKETING
      responses:
        '200':
          description: Analytická data
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data_points:
                    type: array
                    items:
                      type: object
                      properties:
                        start:
                          type: integer
                        end:
                          type: integer
                        conversation:
                          type: integer
                        cost:
                          type: number
                        conversation_category:
                          type: string
                        conversation_type:
                          type: string
                        conversation_direction:
                          type: string
              example:
                success: true
                data_points:
                  - start: 1719792000
                    end: 1719878400
                    conversation: 42
                    cost: 12.5
                    conversation_category: MARKETING
                    conversation_type: REGULAR
                    conversation_direction: BUSINESS_INITIATED
        '400':
          description: Špatný požadavek
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Missing 'waba_id' in request data
components:
  schemas:
    Error:
      type: object
      properties:
        message:
          type: string
          description: Chybová zpráva.
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````