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

# Obter histórico de uma sessão

> Este endpoint, dado um ID de sessão, retorna o histórico completo de mensagens para essa sessão específica.



## OpenAPI

````yaml open-api-files/treble-api-pt.json GET /devapi/session/{session_id}/history
openapi: 3.0.1
info:
  title: API do Treble Poll
  description: Documentação para o endpoint de implantação de polls no Treble
  version: 1.0.0
servers:
  - url: https://main.treble.ai
    description: Servidor principal do Treble
  - url: https://seudominio.com
    description: >-
      Servidor de exemplo para implementar os webhooks. Isso representa SEU
      servidor onde você deve implementar os endpoints que o Treble chamará.
security: []
tags:
  - name: Webhooks
    description: >-
      Endpoints que o Treble chamará no seu servidor. Estes não são endpoints
      reais que você possa chamar, mas uma representação dos webhooks que o
      Treble invocará no seu sistema.
paths:
  /devapi/session/{session_id}/history:
    get:
      summary: Obter histórico de mensagens de uma sessão
      description: >-
        Este endpoint, dado um ID de sessão, retorna o histórico completo de
        mensagens para essa sessão específica.
      parameters:
        - name: session_id
          in: path
          required: true
          description: ID da sessão da qual você deseja obter o histórico de mensagens
          schema:
            type: string
        - name: Authorization
          in: header
          required: true
          description: >-
            Chave API de autorização. Pode ser obtida em
            https://app.treble.ai/en/dashboard/settings
          schema:
            type: string
          example: API_KEY
      responses:
        '200':
          description: Histórico de mensagens obtido corretamente
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    type:
                      type: string
                      description: Tipo de entrada no histórico
                      example: MESSAGE
                    message:
                      type: object
                      properties:
                        type:
                          type: string
                          description: Tipo de mensagem
                          example: TEXT
                        sender:
                          type: string
                          description: Remetente da mensagem
                          example: USER
                        text:
                          type: string
                          description: Conteúdo da mensagem
                        file_url:
                          type: string
                          nullable: true
                          description: URL do arquivo anexado (se existir)
                        created_at:
                          type: integer
                          description: Timestamp UNIX UTC de criação da mensagem
                        delivered_at:
                          type: integer
                          nullable: true
                          description: Timestamp UNIX UTC de entrega da mensagem
                        read_at:
                          type: integer
                          nullable: true
                          description: Timestamp UNIX UTC de leitura da mensagem
                        extra:
                          type: object
                          nullable: true
                          description: Informações adicionais da mensagem
              example:
                - type: MESSAGE
                  message:
                    type: TEXT
                    sender: USER
                    text: Hi
                    file_url: null
                    created_at: 1653341789
                    delivered_at: null
                    read_at: null
                    extra: null
                - type: MESSAGE
                  message:
                    type: TEXT
                    sender: AI
                    text: I need help
                    file_url: null
                    created_at: 1653341803
                    delivered_at: 1653341804
                    read_at: 1653342120
                    extra: null
        '401':
          description: Não autorizado. Chave API inválida ou ausente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de erro
                  message:
                    type: string
                    description: Descrição do erro
        '404':
          description: Sessão não encontrada
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de erro
                  message:
                    type: string
                    description: Descrição do erro

````