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

# Decodificar Mensagens

> Decodifica mensagens rastreadas do WhatsApp, retornando os parâmetros UTM e dados de rastreamento originais associados a cada mensagem.




## OpenAPI

````yaml /openapi/tracking.yaml post /v3/tracking/messages/decode
openapi: 3.1.0
info:
  title: API de Rastreamento — Metrito
  version: '3.0'
  description: >
    API para envio de eventos de rastreamento, gerenciamento de gatilhos
    (triggers) e webhooks de transação.


    ## Conceitos


    - **Container** — O contêiner de rastreamento vinculado a um domínio.

    - **Gatilho (Trigger)** — Uma *configuração* que define quando e como uma
    conversão deve ser disparada (tipo de disparo, mapeamento Meta, condições).
    Recurso CRUD.

    - **Evento** — Um *dado de rastreamento* enviado em tempo real: "usuário
    visualizou página X", "usuário comprou Y". Transitório, processado via fila.


    ## Infraestrutura


    - Rate limiting via `X-RateLimit-*` headers

    - Request ID via `X-Request-Id` em todas as respostas

    - `Idempotency-Key` suportado em POSTs de criação e ingestão
servers:
  - url: https://api.metrito.com
    description: Produção
security:
  - bearerAuth: []
  - apiKeyAuth: []
paths:
  /v3/tracking/messages/decode:
    post:
      summary: Decodificar mensagens WhatsApp
      description: >
        Decodifica mensagens rastreadas do WhatsApp, retornando os parâmetros
        UTM e dados de rastreamento originais associados a cada mensagem.
      operationId: decodeMessages
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - messages
              properties:
                messages:
                  type: array
                  maxItems: 100
                  description: Lista de mensagens a decodificar
                  items:
                    type: object
                    required:
                      - text
                    properties:
                      text:
                        type: string
                        description: Texto da mensagem recebida pelo WhatsApp
            example:
              messages:
                - text: Olá, tenho interesse no produto!
                - text: Qual o preço?
      responses:
        '200':
          description: Mensagens decodificadas com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  messages:
                    type: array
                    items:
                      type: object
                      properties:
                        text:
                          type: string
                        decoded_text:
                          type: string
                          nullable: true
                        decoded_id:
                          type: number
                          nullable: true
                        params:
                          type: object
                          nullable: true
                        tracking_link_id:
                          type: string
                          nullable: true
                        selected_target:
                          type: string
                          nullable: true
              example:
                messages:
                  - text: Olá, tenho interesse no produto!
                    decoded_text: Olá, tenho interesse no produto!
                    decoded_id: 1234567890
                    params:
                      utm_source: instagram
                      utm_medium: cpc
                      utm_campaign: '120215678901234567'
                    tracking_link_id: 64a1b2c3d4e5f6a7b8c9d0e4
                    selected_target: null
                  - text: Qual o preço?
                    decoded_text: Qual o preço?
                    decoded_id: null
                    params: null
                    tracking_link_id: null
                    selected_target: null
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  responses:
    ValidationError:
      description: Parâmetro ausente ou inválido
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              type: validation_error
              code: invalid_parameter
              message: trigger.type must be 'api' for Partner API triggers
              request_id: req_abc123
    Unauthorized:
      description: API key ausente, inválida, revogada ou expirada
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              type: authentication_error
              code: invalid_api_key
              message: The API key provided is invalid or has been revoked.
              request_id: req_abc123
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - authentication_error
                - authorization_error
                - validation_error
                - rate_limit_error
                - not_found_error
                - api_error
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
              nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: JWT da plataforma ou API key `mtk_live_...`
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key `mtk_live_...` via header `x-api-key`

````