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

# Obter conversa

> Retorna os dados de uma conversa com participantes, tags e mensagens. Use `cursor` e `limit` para paginar as mensagens.



## OpenAPI

````yaml https://api.jurichat.com/docs/client/openapi.json get /conversation/{conversationId}
openapi: 3.1.0
info:
  title: JuriChat API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.jurichat.com
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /conversation/{conversationId}:
    get:
      tags:
        - Conversations
      summary: Obter conversa
      description: >-
        Retorna os dados de uma conversa com participantes, tags e mensagens.
        Use `cursor` e `limit` para paginar as mensagens.
      parameters:
        - schema:
            type: string
          in: query
          name: cursor
          required: false
          description: >-
            Cursor para buscar a próxima página de mensagens. Use o valor
            retornado em `nextCursor`.
        - schema:
            anyOf:
              - type: string
              - type: number
          in: query
          name: limit
          required: false
          description: Quantidade máxima de mensagens por página.
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: path
          name: conversationId
          required: true
          description: ID da conversa.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      status:
                        type: string
                        enum:
                          - ROBOT_INTERACTIVE
                          - INACTIVE
                          - HUMAN_INTERACTIVE
                          - WAITING_HUMAN
                      priority:
                        type: string
                        enum:
                          - LOW
                          - MEDIUM
                          - HIGH
                      person:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                            nullable: true
                          phoneNumber:
                            type: string
                            nullable: true
                          imageUrl:
                            type: string
                            nullable: true
                        required:
                          - id
                          - name
                          - phoneNumber
                          - imageUrl
                        additionalProperties: false
                        nullable: true
                      user:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          imageUrl:
                            type: string
                            nullable: true
                        required:
                          - id
                          - name
                          - imageUrl
                        additionalProperties: false
                        nullable: true
                      tags:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            color:
                              type: string
                          required:
                            - id
                            - name
                            - color
                          additionalProperties: false
                      participants:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                              nullable: true
                            imageUrl:
                              type: string
                              nullable: true
                            phoneNumber:
                              type: string
                              nullable: true
                            isAgent:
                              type: boolean
                            isMember:
                              type: boolean
                          required:
                            - id
                            - name
                            - isAgent
                            - isMember
                          additionalProperties: false
                      messages:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            content:
                              type: string
                            type:
                              type: string
                            metadata:
                              nullable: true
                              description: >-
                                Dados adicionais da mensagem (mídia, status
                                etc.). Null se não houver.
                            direction:
                              type: string
                            messageAt:
                              type: string
                              format: date-time
                            externalId:
                              type: string
                              nullable: true
                            externalStatus:
                              type: string
                              nullable: true
                            errorMessage:
                              type: string
                              nullable: true
                            participantId:
                              type: string
                              nullable: true
                            formattedDate:
                              type: string
                              nullable: true
                            contact:
                              type: object
                              properties:
                                name:
                                  type: string
                                  nullable: true
                                phoneNumber:
                                  type: string
                                  nullable: true
                              required:
                                - name
                                - phoneNumber
                              additionalProperties: false
                              nullable: true
                            quotedMessage:
                              type: object
                              properties:
                                id:
                                  type: string
                                content:
                                  type: string
                                formattedDate:
                                  type: string
                              required:
                                - id
                                - content
                                - formattedDate
                              additionalProperties: false
                              nullable: true
                            transcription:
                              type: string
                              nullable: true
                            summary:
                              type: string
                              nullable: true
                            templateContent:
                              type: object
                              properties:
                                templateName:
                                  type: string
                                headerMedia:
                                  type: object
                                  properties:
                                    format:
                                      type: string
                                      enum:
                                        - IMAGE
                                        - VIDEO
                                        - DOCUMENT
                                        - LOCATION
                                    link:
                                      type: string
                                    filename:
                                      type: string
                                    latitude:
                                      type: string
                                    longitude:
                                      type: string
                                    name:
                                      type: string
                                    address:
                                      type: string
                                  required:
                                    - format
                                  additionalProperties: false
                              additionalProperties: false
                              nullable: true
                              description: >-
                                Metadados visuais de mensagens template
                                WhatsApp. Presente quando type é template.
                          required:
                            - id
                            - content
                            - type
                            - direction
                            - messageAt
                            - externalId
                            - externalStatus
                            - errorMessage
                            - participantId
                            - formattedDate
                            - contact
                            - quotedMessage
                            - transcription
                            - summary
                          additionalProperties: false
                      isGroup:
                        type: boolean
                      group:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          externalId:
                            type: string
                          imageUrl:
                            type: string
                            nullable: true
                        required:
                          - id
                          - name
                          - externalId
                          - imageUrl
                        additionalProperties: false
                        nullable: true
                      inboxId:
                        type: string
                      createdAt:
                        type: string
                        format: date-time
                      updatedAt:
                        type: string
                        format: date-time
                    required:
                      - id
                      - status
                      - priority
                      - person
                      - user
                      - tags
                      - participants
                      - messages
                      - isGroup
                      - group
                      - inboxId
                      - createdAt
                      - updatedAt
                    additionalProperties: false
                  nextCursor:
                    type: string
                    description: >-
                      Cursor para buscar a próxima página de mensagens. Presente
                      apenas quando `hasMore` for verdadeiro.
                  hasMore:
                    type: boolean
                    description: >-
                      Indica se há mais mensagens disponíveis além da página
                      atual.
                required:
                  - data
                  - hasMore
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  details: {}
                required:
                  - message
                  - statusCode
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-jurichat-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-jurichat-api-key.

````